This is my attempt to create a curated webradio list for myMPD.
Contributions to the webradio database are very welcome. It should be a community driven database. You must only open an issue to add or modify a webradio. Your proposal will be reviewed and then merged, therefore it could take some time before the webradio is added.
Please do not add geo-fenced streams.
Open an issue.
Search for the webradio and click on the modify link to open a prefilled GitHub issue.
This project is designed as an easily integratable webradio database for music players. At the moment there is no api endpoint to query the database. An application should fetch the metadata json file and use it locally.
At the moment there are two sources for webradio files:
The primary workflow to add or modify a webradio is to open an issue. The issue must be manually approved by adding a merge label. A GitHub action is triggered on the label event and the build script runs:
The create workflow runs once a day.
sources
to docs/db
folderAfter this workflow the docs
folder is published to the GitHub page.
There are some nightly tasks to check the integrity of the database and the streams availablity.
CHECK | DESCRIPTION |
---|---|
Stream | Checks the availability of the stream with ffprobe. Failed checks are written to the status.min.json file. |
Image | Checks for obsolet or missing images. It also checks if the image files are valid webp images. |
DB | Checks for duplicates in the index files. |
Webradios are saved as extended m3u files with some custom fields. A coverimage could be specified as file in the pics folder or an url.
#EXTM3U
#EXTINF:-1,<name>
#EXTGENRE:<genre>
#PLAYLIST:<name>
#EXTIMG:<cover>
#HOMEPAGE:<homepage>
#COUNTRY:<country>
#STATE:<state (deprecated)>
#REGION:<region>
#LANGUAGE:<language>
#DESCRIPTION:<description>
#CODEC:<codec>
#BITRATE:<bitrate>
#ADDED:<timestamp>
#LASTMODIFIED:<timestamp>
<streamuri>
The filename of the playlist and the coverimage are derived from the streamuri by replacing <>/.:?&$%!#\|;=
characters with _
. This is the same behaviour as in myMPD and makes this playlists compatible with the myMPD webradio feature.
You must not download the station images, instead you can prepend https://jcorporation.github.io/webradiodb/db/pics/
to the image name, e.g. https://jcorporation.github.io/webradiodb/db/pics/http___119_15_96_188_stream2_mp3.webp.
The final files are located in the docs/db
folder, it is rebuild daily. The folder docs
is published through GitHub Pages.
FOLDER | DESCRIPTION |
---|---|
docs/db/index | Metadata as json and javascript |
docs/db/pics | Station images |
docs/db/webradios | Playlists |
FILE | DESCRIPTION |
---|---|
bitrates.min.json | Array of bitrates |
codecs.min.json | Array of codecs |
countries.min.json | Array of countries |
states.min.json | Object of countries and linked states. Deprecated, use regions. |
regions.min.json | Object of countries and linked regions |
genres.min.json | Array of genres |
languages.min.json | Array of languages |
status.min.json | Array of failed stream checks |
webradios.min.json | JSON object of webradios |
webradiodb-combined.min.json | JSON object file with all the above indexes |
webradiodb-combined.min.js | JavaScript file with all the above indexes |
The m3u fields are mapped for better readability.
M3U FIELD | JSON KEY | VALUE TYPE | DESCRIPTION |
---|---|---|---|
EXTGENRE | Genre | Array | |
PLAYLIST | Name | String | |
EXTIMG | Image | String | |
HOMEPAGE | Homepage | String | |
COUNTRY | Country | String | |
STATE | State | String | Deprecated |
REGION | Region | String | |
LANGUAGE | Language | String | Deprecated |
LANGUAGE | Languages | Array | |
CODEC | Codec | Array | |
BITRATE | Bitrate | Integer | |
DESCRIPTION | Description | String | |
ADDED | Added | Number | |
LASTMODIFIED | Last-Modified | Number | |
uri | StreamUri | String |
"https___liveradio_swr_de_sw282p3_swr1bw_play_mp3.m3u": {
"Genre": [
"Pop",
"Rock"
],
"Name": "SWR 1 BW",
"Image": "https___liveradio_swr_de_sw282p3_swr1bw_play_mp3.webp",
"Homepage": "https://www.swr.de/swr1/",
"Country": "Germany",
"State": "Baden-Württemberg",
"Region": "Baden-Württemberg",
"Language": "German",
"Languages": [
"German"
],
"Description": "SWR 1 Baden-Württemberg",
"Added": 1720344242,
"Last-Modified": 1720344242,
"Codec": "MP3",
"Bitrate": 128,
"StreamUri": "https://liveradio.swr.de/sw282p3/swr1bw/play.mp3",
"alternativeStreams": {
"https___liveradio_swr_de_sw890cl_swr1bw_": {
"StreamUri": "https://liveradio.swr.de/sw890cl/swr1bw/",
"Codec": "AAC",
"Bitrate": 48
},
"https___liveradio_swr_de_sw331ch_swr1bw_": {
"StreamUri": "https://liveradio.swr.de/sw331ch/swr1bw/",
"Codec": "AAC",
"Bitrate": 96
}
}
}
The script is used by GitHub actions.
Type ./build.sh
for usage information.
Everyone is free to use the collected data in their works. I give all the rights I have at the accumulated data to the public domain.
2021-2023 Juergen Mang mail@jcgames.de