thrash.dev

docs / yafmp / troubleshooting

Yafmp · chapters · 11 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) →

Troubleshooting

Where to look first, problems that are not tied to one provider, and where each provider's own list is.

Look here first

Most problems come down to one of four things.

  1. The provider is off. A source that is missing from the library is usually switched off. Check Preferences → Plugins (Apple) or Settings (Android and desktop). Several providers start off: see First run.
  2. It is not signed in. Open the provider’s settings pane. It shows the account when signed in and a status line when something is wrong.
  3. The network permission is missing. A server or speaker on your own network needs Local network access on Apple devices and Nearby devices on Android 16 and later.
  4. The list is old. Yafmp keeps the lists it has loaded. Right-click or long-press a source’s heading in the library and choose Refresh.

Across the app

ProblemWhyWhat to do
The volume slider is dimmed, or does nothingThe playing source uses its own player, which an app cannot set the volume ofUse the device’s volume. See Sound for which sources this applies to.
The equalizer or the visualizer does nothing for one sourceThat source plays through its own player and its sound never passes through YafmpNone. Sound and Visualizers list the sources.
No speakers are listedSpeaker discovery is not running on this systemLinux and FreeBSD need avahi-daemon, Windows needs Bonjour. See Install.
A source is missing on the TVSome providers are not offered on Apple TV or Android TVSee TV and Steam Deck and the provider’s platforms list.
A sign-in made on one Apple device is missing on anotherSign-ins travel through iCloud KeychainSign both devices in to the same iCloud account and turn on iCloud Keychain.
Scrobbles are “waiting”The device is offline or the service is unreachableNothing. They are kept and sent with the next successful one.

By provider

Every provider page ends with its own troubleshooting table. The ones people need most:

AreaPages
Music serversPlex, Navidrome, Jellyfin
Your own filesLocal Files
Streaming servicesApple Music, Spotify, YouTube Music, SoundCloud, SiriusXM
SpeakersAirPlay, Chromecast
Other copies of YafmpConnect

Reporting a problem

The Android and desktop edition has a Bug Reports pane in Settings. It sends crashes, timings and the reports you type, each with the last 200 log lines, to a Loki server of your own. Enter the server’s https address under Loki push URL; while the field is empty nothing is saved or sent.

The Apple edition sends no reports.