thrash.dev

docs / yafmp / install

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

Install

What each platform needs, and what the app asks permission for.

Downloads, when there are any, are listed on the Yafmp page under Releases. This chapter says what each platform needs.

System requirements

PlatformNeeds
iPhone, iPadiOS or iPadOS 27
MacmacOS 27
Vision ProvisionOS 27
Apple TVtvOS 27
Apple Watch (remote)watchOS 27, paired with an iPhone that has Yafmp
Android phone, tablet, TVAndroid 8.1 or later. Shader visualizers need Android 13.
Wear OS (remote)Wear OS 3 or later
Linuxx86-64, GStreamer 1.x with the base, good, bad and libav plugin sets
FreeBSDFreeBSD 15, amd64, GStreamer 1.x, a Java 21 runtime
WindowsWindows 11, x86-64

Apple devices

There is no Mac download at the moment.

The iPhone, iPad, Vision Pro and Apple TV apps are separate builds of the same app. The Apple Watch remote is part of the iPhone app and installs with it.

Android

Yafmp installs from an APK. Allow your browser or file manager to install apps when Android asks. The same APK runs on phones, tablets and Android TV, and picks its layout from the device.

Linux

Yafmp comes in three forms. All of them bundle their own Java runtime.

PackageForNotes
.debDebian, Ubuntu
pacman packageArch and its relativesPulls in the GStreamer plugins
Self-contained tarballAnything else, including the Steam DeckUnpack it anywhere; needs only GStreamer on the system

Install these as well, for the features that use them:

PackageNeeded for
avahi (with avahi-daemon running)Finding AirPlay and Chromecast speakers, and Connect
xdg-utilsOpening sign-in pages in your browser, and SMB shares
PulseAudio or pipewire-pulseSending Apple Music to AirPlay or the visualizers

FreeBSD

Yafmp is a package (audio/yafmp) that depends on the GStreamer plugins, a Java runtime, avahi and xdg-utils. Speaker discovery needs the avahi daemon running:

sysrc avahi_daemon_enable=YES
service avahi-daemon start

Windows

Yafmp installs from an MSI. To find AirPlay and Chromecast speakers it needs Apple’s Bonjour service, which provides the dns-sd command. Without Bonjour the app runs, but lists no speakers.

Permissions

Yafmp asks only for what a feature needs, at the moment you first use it.

PlatformPermissionWhy
AppleLocal networkReaching a music server, speakers and other copies of Yafmp on your network
AppleApple MusicOnly if you connect Apple Music
Android 13+NotificationsThe playback notification with its controls
Android 16+Nearby devicesWithout it, Android silently drops connections to a server on your own network