docs / yafmp / troubleshooting
Yafmp · chapters · 11 of 11
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.
- 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.
- 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.
- 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.
- 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
| Problem | Why | What to do |
|---|---|---|
| The volume slider is dimmed, or does nothing | The playing source uses its own player, which an app cannot set the volume of | Use the device’s volume. See Sound for which sources this applies to. |
| The equalizer or the visualizer does nothing for one source | That source plays through its own player and its sound never passes through Yafmp | None. Sound and Visualizers list the sources. |
| No speakers are listed | Speaker discovery is not running on this system | Linux and FreeBSD need avahi-daemon, Windows needs Bonjour. See Install. |
| A source is missing on the TV | Some providers are not offered on Apple TV or Android TV | See TV and Steam Deck and the provider’s platforms list. |
| A sign-in made on one Apple device is missing on another | Sign-ins travel through iCloud Keychain | Sign both devices in to the same iCloud account and turn on iCloud Keychain. |
| Scrobbles are “waiting” | The device is offline or the service is unreachable | Nothing. 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:
| Area | Pages |
|---|---|
| Music servers | Plex, Navidrome, Jellyfin |
| Your own files | Local Files |
| Streaming services | Apple Music, Spotify, YouTube Music, SoundCloud, SiriusXM |
| Speakers | AirPlay, Chromecast |
| Other copies of Yafmp | Connect |
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.