From 424b8d2b5455ccf8a6dc66fedafdb4a12bf554d0 Mon Sep 17 00:00:00 2001 From: Valentin Popov Date: Thu, 31 May 2018 07:06:28 +0400 Subject: Project description file Signed-off-by: Valentin Popov --- README.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index e69de29..b63c911 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,53 @@ +# Notification about the current track + +Pop-up notification about the currently playing music track. +Uses playlists of a non-commercial radio station +[SomaFM](https://somafm.com/). +Created specially for +[Open Broadcaster Software](https://obsproject.com/). + +* [Support SomaFM](https://somafm.com/support/); +* [Demo](https://valentineus.link/obs-somafm-current-track/?radio=defcon); + +## Using + +```url +https://valentineus.link/obs-somafm-current-track/?radio=defcon +``` + +Open the page by specifying the GET parameter `radio`. +This is necessary to the script receives the data of the desired radio. +A list of available radio stations can be found +[here](https://somafm.com/listen/). + +## Development + +To start a local server for development, you need: + +1. Clone the source repository: + +```bash +git clone "https://github.com/valentineus/obs-somafm-current-track.git" +``` + +2. Install packages: + +```bash +cd "obs-somafm-current-track" && bundle update +``` + +3. Start the server: + +```bash +bundle exec jekyll serve --host "${IP}" --port "${PORT}" --trace +``` + +Please note in the executable command uses environment variables `IP` and `PORT`. + +## License + +MIT License + +[MIT](LICENSE.txt). +Copyright (c) +[Valentin Popov](https://valentineus.link/). -- cgit v1.2.3