How to edit the list of known radio stations best?

[jlemmer]

Hi,

Sepia knows some radio stations, which is a nice feature. Unfortunately my preferred stations are not in the bouquet. What is the best method to add stations to the list/remove unwanted stations?

I was able to add a station by teaching "Spiele Radio21" with "opening music stream" and the URL of the mp3 stream of the station found on http://fmlist.org" Is this the right/official way? What would you suggest? And how to delete unwanted stations, so that there is more "evidence" which station is meant, as radio stations often sound quite the same?

[fquirin]

This is one way, but there is also a server file you can edit:

SEPIA/sepia-assist-server/Xtensions/ServiceProperties/radio-stations.json

I think its OK readable ^^, but if you need any help editing it feel free to ask here again ;-) Oh and don't forget to restart your server after editing it!

Please note: SEPIA updates will overwrite this file so if you edit it keep a backup somewhere ;-)

Basic structure of the radio-stations.json

stations

Object that holds all stations. A station itself usually looks like this:

"delta_föhnfrisur": [{
	"streamURL": "https://delta....",
	"name": "delta radio Föhnfrisur"
}]

But it ca also be an array of existing other stations like this:

"ego_fm": [
    "ego_fm_pure", 
    "ego_fm_riff", 
    ... 
]

You can combine both versions as well (there are examples in the file). SEPIA will always start auto-play of the first station in the array and offer the other stations as list in the chat. The "key" like delta_föhnfrisur or ego_fm is the basis for what SEPIA will search when you say "Play radio ego FM" or "Play radio dela Föhnfrisur".
Adding the correct streamURL can be tricky sometimes since not all radio stations are showing them publicly. Some small stations might even use a rotating URL and redirect from some domain to that. Redirecting links are likely to fail when used as audio stream :/

collections

Collections are stations grouped by a keyword, e.g. rock for "Play a rock radio".

playlists

Some stations have a link to their playlist that will be shown in the chat and in the future it might be used to call some playlist API maybe. Use the "name" field of the station to connect a station with its playlist.

deprecations

These are just some stations that don't work anymore and are parked here in case someone whats to try and fix them ;-) (if possible).

[fquirin]

I've added the info above to the official docs now :-) https://github.com/SEPIA-Framework/sepia-docs/wiki/Editing-SEPIA-Radio-Stations