thrash.dev

docs / providers / radio

Providers · chapters · 12 of 25

← Yafmp manual

  1. Local Files
  2. Plex
  3. Navidrome
  4. Jellyfin
  5. Bandcamp
  6. Lidarr
  7. Apple Music
  8. Spotify
  9. SoundCloud
  10. YouTube Music
  11. SiriusXM
  12. Radio
  13. Podcasts
  14. AirPlay
  15. Chromecast
  16. MusicBrainz
  17. Discogs
  18. Labels
  19. Releases
  20. Last.fm
  21. ListenBrainz
  22. Connect
  23. Home Assistant
  24. MCP server
  25. DJ

Radio

Play internet radio stations: paste a stream URL or search radio-browser.info.

facts

status
beta
kind
source
on by default
yes
needs
Internet connection
platforms
iPhone, iPad, Mac, Vision Pro, Apple TV, Android, Android TV, Linux, FreeBSD, Windows

Description

Radio plays internet radio stations. A station is a stream address: Icecast or Shoutcast (MP3, AAC and others) or HLS. A link to a .pls or .m3u list is opened and its first stream is used.

Yafmp comes with a built-in list of stations. You find more by typing in the library’s search field: Radio searches radio-browser.info by station name and shows up to 50 stations, the most voted first, with codec, bitrate and country or tags. No account or key is needed.

While a station plays, Yafmp shows the song the station announces. On Apple, an announcement of the form Artist - Title is split into the playlist row’s artist and title, and the Album column keeps the station’s name. When the station stops playing, the row shows the station’s name again.

If a stream drops, Yafmp reconnects by itself: up to three times in a row, two seconds apart.

Requirements

  • An internet connection.
  • For your own stations on Apple: the stream’s address.

Setup

On Apple:

  1. Open Radio in the library. A new install starts with the built-in stations.
  2. To add a station by address, choose Add Station…, enter a Name and the Stream URL, and choose Add. Without a name, the station is named after the address.
  3. To find a station, type its name in the search field. Play a result straight away, or right-click (or long-press) it and choose Add to Library to keep it.
  4. To get back built-in stations you removed, choose Add Default Stations. It adds the built-in stations that are not in your list, after your own. Nothing is added unless you press it.

On Android and desktop:

  1. Open Radio in the library. The built-in stations are always there.
  2. To find a station, type its name in the library’s search. Play a result straight away, or open its menu (long-press or right-click) and choose Save to Radio to keep it.

Settings

Radio has no settings pane. Its controls are in the library:

SettingDefaultWhat it does
Add Station…—Apple: adds a station by name and stream address.
Add Default Stations—Apple: adds the built-in stations missing from your list.
Add to Library—Apple, on a search result: keeps the station.
Remove Station—Apple, on a station in your list: removes it.
Save to Radio—Android and desktop, on a search result: keeps the station.
Remove from Radio—Android and desktop, on a station you saved: removes it.

Your stations are kept on the device. They are not shared between devices.

Limits

  • A live stream has no position, so you cannot seek. On Apple, pausing does not buffer: resuming picks the station up where it is now.
  • Apple: MP3 and AAC stations play through Yafmp’s own engine, so the visualizers and the effects hear them. HLS, Ogg and other stations play through the system player, without visualizers. A station that does not answer within 10 seconds is also handed to the system player.
  • Apple: while paused, Yafmp stays connected for up to 10 minutes, so that resuming does not open a new connection (many stations play an advert at the start of each one). After that it hangs up and connects again on resume.
  • Apple: the count of reconnects starts again after 30 seconds of good stream.
  • Android and desktop: stations cannot be added by address, only from search. The built-in stations cannot be removed.
  • Apple TV has no Add Station… button and no row menus.
  • Not every station announces its songs. Then the row keeps the station’s name.

Troubleshooting

ProblemWhyWhat to do
A station stopped and did not come backThree reconnects in a row failedPlay the station again.
The visualizer does not move on one station (Apple)The station is HLS, Ogg or another format that plays through the system playerNone. Stations that stream MP3 or AAC drive the visualizers.
A built-in station is gone (Apple)It was removed from the listChoose Add Default Stations in the Radio section.
“no stream in …” (Android and desktop)The station’s .pls or .m3u list holds no stream addressSearch for the station again and pick another entry.
The title stays the station’s nameThe station does not announce its songsNone.