thrash.dev

docs / yafmp / overview

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

Overview

What Yafmp is, the two editions, and what runs where.

What Yafmp is

Yafmp is a music player built the way DeaDBeeF and Winamp were: a small core and plugins around it. The core is the playlist, the transport and the playback engine. Everything else is a plugin that you can turn off: every music source, every speaker type, the equalizer, the visualizers, scrobbling.

Tracks from all sources share one queue. A FLAC from your own server, a radio station and a song from a streaming service can follow each other in the same playlist.

Two editions

EditionRuns on
AppleiPhone, iPad, Mac, Vision Pro, Apple TV. The iPhone app includes an Apple Watch remote.
Android and desktopAndroid phones, tablets and TVs, with a Wear OS remote. The desktop app runs on Linux, FreeBSD and Windows.

The Android and desktop edition is a port of the Apple one. The two keep the same playlist file format (playlist.json) and the same names for things, so this manual describes them together. Where a page says Apple, it means every device in the first row. Android and desktop means every device in the second.

New features usually arrive in the Apple edition first. A few exist only on one side:

Only in the Apple editionOnly in the Android and desktop edition
Jellyfin, Lidarr, Home AssistantThe MCP server (desktop)
Spatial audio with head tracking, the download cacheThe Android TV layout, also used on the Steam Deck
Vision Pro immersive scenesImporting and filing music (desktop)

How this manual is laid out

The chapters cover the app: installing, first run, playing music, the library, sound, visualizers, the keyboard, remote control, TVs and the Steam Deck and troubleshooting.

The providers section has one page for each thing Yafmp connects to. Every provider page starts with a facts panel (status, platforms, what it needs) and has the same six sections.

Privacy

Yafmp has no account of its own, and in its release form it has no analytics. The Android and desktop edition has a Bug Reports pane that can send crashes and timings to a Loki server of your own; it is empty, and so off, unless you fill it in. Otherwise the app talks only to the services you sign in to and to the public services a plugin needs (for example MusicBrainz for covers, radio-browser.info for station search). Sign-in tokens and passwords stay on the device: in the keychain on Apple devices, in the app’s private storage on Android and the desktop. They are never written into a playlist or an exported file.

On Apple devices signed in to the same iCloud account with iCloud Keychain on, sign-ins are shared between your devices, so signing in on the Mac also signs in the iPhone.