diff options
Diffstat (limited to 'README')
-rw-r--r-- | README | 42 |
1 files changed, 42 insertions, 0 deletions
@@ -1,3 +1,5 @@ +Radio Station Emulator +---------------------- That's a small proof-of-concept for radio-station-emulator For obvious reasons, we don't guarantee that the program/list creator won't be @@ -21,3 +23,43 @@ Helping scripts: Deploy scripts: - ./init.sh - ./deploy.sh + +About +----- +This is a "Radio Station Emulator". We create lists with shows to be played, but +since we are not doing streaming of the playlists, we offer another way of +"tuning in". + +Providing the time a list started playing and having pre-calculated the starting +timestamps of each show relevant to the list start timestamp, we can calculate +which show is on and what its current time of playing is. + +Ultimately, you are hearing what we would be streaming, as +you would do for a regular radio station. + +Steps +----- +First, your browser is going to ask our server here, what is the current list +that plays right now. It will get a response and will fetch that list. + +Based on properties of the list overall and the time of visit, your browser will +start comparing each show's properties found in the list, to figure the relative +time of yours on the list. A progress bar labeled "Live progress" will be +indicating the correct time on the show. + +Having figured out the show that is playing, it will go and download the whole +show. This would be observable via the "Download progress" bar. + +Upon completion of the download, the "Sync" button is auto pressed and the +player start playing the show from the calculated second it calculated +previously. + +Notes +----- +Sometimes, you might need to press the "Sync" button more than once. That's +mostly due to bandwidth capabilities of both the server and the client. The +"tune" would be right if you press it multiple times and land near the same +timespace over and over. + +Ideally, if "Listening at:" and "Show playback:" have the same value then you +are in sync! |