Project description file
Signed-off-by: Valentin Popov <info@valentineus.link>
This commit is contained in:
		
							
								
								
									
										53
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										53
									
								
								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
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					<img width="256px" alt="MIT License" src="https://raw.githubusercontent.com/valentineus/valentineus.github.io/master/assets/images/7d05cad0-d553-42c7-be1f-7007926ba720.png" />
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					[MIT](LICENSE.txt).
 | 
				
			||||||
 | 
					Copyright (c)
 | 
				
			||||||
 | 
					[Valentin Popov](https://valentineus.link/).
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user