Skip to content

Internet radio trouble shooting

Jump to bottom
Pauli Järvinen edited this page Jan 2, 2025 · 9 revisions

The following is valid for the Music v2.1.0.

There are a few configuration possibilities available for the cloud admins which influence the behavior of the external audio streams (aka Internet radio channels). However, using the default settings should be the most trouble-free option and give the best compatibility with little hassle.

If using the default settings and some stream does not play, then the first thing to check is if that stream works on any other player. For many streams, it's possible to play them directly in the web browser by pasting the stream URL to the address bar. For the other working streams, it's usually possible to play them using the VLC media player. When a stream fails to play, it's also worth checking the browser development console for any hints. On most desktop browsers, this can be opened with the F12 key.

If you find a stream which doesn't work on the Music app but works using VLC or the browser directly, then feel free to report an issue.

Considerations with non-default settings

  1. In case music.relay_radio_stream is disabled, the playback of "normal" audio streams (i.e. not HLS-type) works so that the web browser streams the audio directly from the origin source URL. There are two typical reasons which may cause this to fail:

    1. The origin URL has not been whitelisted using the configuration key music.allowed_stream_src. If this is the case, the browser Content-Security-Policy will block the streaming.
    2. You have a secure HTTPS connection to your cloud but the stream source URL uses plain HTTP. All modern web browsers block such "mixed access" by default. You may be able to enable "less secure content" from the page-specific settings of your browser.

  2. HLS-type streams are always relayed via the cloud server, regardless of the settings mentioned above. If the cloud admin doesn't want that, then the behavior can be disabled with the key music.enable_radio_hls but then those streams cannot be played on the browser at all. Because of the relaying, these streams don't require any whitelisting.

Clone this wiki locally