thrash.dev

docs / yafmp / first run

Yafmp · chapters · 03 of 11
  1. Overview
  2. Install
  3. First run
  4. Playing music
  5. Library and browser
  6. Sound
  7. Visualizers
  8. Keyboard and commands
  9. Remote control
  10. TV and Steam Deck
  11. Troubleshooting

Providers (25) →

First run

From an empty window to music in five minutes.

A new copy of Yafmp starts with an empty playlist. Nothing is signed in, and the library holds only a starter set of radio stations. Pick one of the starts below; you can add the others at any time.

Where the settings are

EditionWhere
MacYafmp → Settings… (⌘,). Sources and services are under Plugins.
iPhone, iPad, Vision ProThe settings button in the app, then Plugins.
Apple TVThe Settings tab. It shows the settings of every plugin on one page.
Android and desktopSettings. One pane per source or service.

Each provider has a switch. A provider that is off does not appear in the library and makes no network requests. These start off, and you turn them on when you want them:

EditionOff at first
AppleBandcamp, Lidarr, Spotify, SoundCloud, Home Assistant, Compressor, Spatial Audio
Android and desktopBandcamp, Spotify, SoundCloud

Start with your own files

  1. In the library, find Local Files and choose Add Folder….
  2. Pick the folder that holds your music.
  3. Open the folder in the library and double-click (or tap) an album or a track.

More in Local Files.

Start with a music server

If you run Plex, Navidrome (or another Subsonic server) or Jellyfin, sign in once and your whole collection is in the library, played from the original files.

  • Plex: Sign in to Plex, then pick the server.
  • Navidrome: address, user name and password.
  • Jellyfin: address, user name and password. Apple edition only.

Start with radio

Radio needs no account.

  1. Open Radio in the library.
  2. Play one of the stations already there, or type in the search field to find one on radio-browser.info.
  3. While a station plays, the song it announces shows as the title.

More in Radio.

Add a streaming service

Each service has its own requirements. Some need only your subscription; some need a developer key that you create yourself. The provider page lists exactly what to do.

ServiceYou need
Apple MusicA subscription
SiriusXMA streaming subscription
SpotifyPremium, and your own Spotify developer app
YouTube MusicYour own Google Cloud OAuth client
SoundCloudYour own SoundCloud API app
BandcampA fan account with Bandcamp’s Subsonic beta turned on

Next