myMPD Webradio Database

This is my attempt to create a curated webradio database for myMPD.

• Station search

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.

Add a new webradio

Open an issue.

Modify a webradio

Search for the webradio and click on the modify link to open a prefilled GitHub issue.

Usage

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.

• Apps

Some internals

At the moment there are two sources for webradio files:

• Webradios from moode audio (sources/moode-*)
• Manually added files (sources/mympd-*)

Workflows

Add, modify and delete a webradio

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:

• creates the m3u file
• downloads the image
• converts the image to webp and resizes it to 400x400 pixel

Index creation

The create workflow runs once a day.

• copies files from sources to docs/db folder
• parses the m3u files and creates JSON index files

After this workflow the docs folder is published to the GitHub page.

Checks

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.

Storage format

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>
#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

Index files

FILE	DESCRIPTION
bitrates.min.json	Array of bitrates
codecs.min.json	Array of codecs
countries.min.json	Array of countries
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
REGION	Region	String
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",
    "Region": "Baden-Württemberg",
    "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
        }
    }
}

Script usage

The script is used by GitHub actions.

Type ./build.sh for usage information.

Dependencies

• curl: download images
• csvkit: sync moode webradios
• ffmpeg: check streams with ffprobe
• imagemagick: convert images to webp
• jq: parse and create json

Copyright

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-2024 Juergen Mang mail@jcgames.de