thrash.dev

docs / yafmp / tv and steam deck

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

TV and Steam Deck

The lean-back layouts: Apple TV, Android TV and Google TV, and the Steam Deck in Gaming Mode.

On a television Yafmp uses a layout made for the sofa: Now Playing is the home page, the controls are large, and everything works from a remote or a gamepad. There are three places it runs.

DeviceEditionControlled with
Apple TVAppleSiri Remote
Android TV, Google TVAndroidD-pad remote
Steam Deck in Gaming Mode, Steam Big Picture on LinuxDesktopGamepad

Apple TV

The sidebar has Now Playing, Queue, Search, a Library section with one row per source, and Settings.

Now Playing shows the cover on the left. On the right are the title, artist, album and year, a progress line, the transport (shuffle, previous, play or pause, next, repeat), the visualizer menu, the stream format and the next three tracks under Up next. Pick one of the three to play it.

  • The progress line is not a slider. A live stream shows LIVE in place of a length.
  • The visualizer menu puts a visualizer in the cover’s place, or opens Full Screen Visualizer.
  • The Play/Pause button on the remote works on every page.
  • After 30 seconds without input while music plays, a screensaver takes over: the visualizer, or the cover with the title. Any button wakes it.

A source page shows folders as a grid of covers and tracks as a list. Inside an album or other playable folder, Play and Shuffle are at the top. Search searches every enabled source and groups the results by source. Queue lists every track; pick one to play from there. Settings has each plugin’s own settings.

What the Apple TV app has

On Apple TVNot on Apple TV
Plex, Apple Music, Navidrome, Jellyfin, BandcampLocal Files, YouTube Music, Spotify, SoundCloud
Radio, SiriusXM, PodcastsLidarr, MusicBrainz, Labels, Releases
Last.fm, ListenBrainz, DiscogsDJ, Home Assistant
Now Playing (system controls), ConnectEqualizer, Compressor, Spatial Audio, the AirPlay and Chromecast pickers

With Connect, your other devices can list and control the Apple TV. The Apple TV has no remote for them.

Sign-ins on Apple TV

Typing a password with a remote is slow, so Yafmp shares most sign-ins between your Apple devices through iCloud Keychain. Sign in on an iPhone, iPad or Mac and the Apple TV picks the sign-in up.

  1. Use the same Apple Account on the Apple TV as on the device you signed in on, with iCloud Keychain on.
  2. Sign in to the service on the iPhone, iPad or Mac.
  3. Open Yafmp on the Apple TV. It reads the shared sign-ins when it starts, so quit and reopen it if a new sign-in has not appeared.

Shared this way: Plex, Jellyfin, Navidrome, Bandcamp, SiriusXM, Last.fm, ListenBrainz and Discogs, with their server addresses and user names. Apple Music is granted on each device.

A changed server address does not replace one the Apple TV already has. Change it on the Apple TV too. You can also sign in directly on the Apple TV under Settings.

Android TV and Google TV

Yafmp appears on the TV home screen. It opens on Now Playing. A rail on the left switches pages: Now Playing, Library, Queue, Search and Settings. The rail shows icons, and widens to show labels while the focus is in it.

Now Playing shows the cover, or the cover visualizer, as a large square. Beside it are the title, artist, album and year, the seek slider, large transport buttons, the visualizer picker, the plugins’ buttons (such as AirPlay, Chromecast, DJ and the equalizer), the format line and the next three tracks under Up next. Press OK on one to play it.

After 30 seconds without a key on Now Playing while music plays, a screensaver fades in: the visualizer full screen, or the cover, with the title and a progress line. The first key only wakes it. Media keys still act.

Using the D-pad:

KeyWhat it does
ArrowsMove the focus. The focused control has a strong highlight.
OKSelect. On a text field, OK opens the on-screen keyboard.
Left / Right on a sliderChange the value (seek). Up and Down move on.
BackLeaves the screensaver, then goes up one library folder, then returns to Now Playing, then leaves the app.

Library is the cover browser, full screen. Search shows results as you type; opening one shows it in Library.

Apple Music is not available on Android TV.

Steam Deck

The desktop edition has the same TV layout as Android TV. It turns on by itself when Steam starts Yafmp in Gaming Mode or Big Picture, and fills the screen.

  1. Install Yafmp for Linux (see Install).
  2. In Steam, add Yafmp to your library as a non-Steam game.
  3. Start it from Gaming Mode.

The gamepad drives the layout:

ControlWhat it does
D-pad or left stickMove the focus. Hold to repeat.
ASelect
BBack
X or StartPlay or pause
LBPrevious track
RBNext track

On a keyboard, the arrow keys move the focus, Enter selects and Esc goes back.

Notes:

  • Gamepads are read on Linux only.
  • When Steam provides its own virtual gamepad, Yafmp reads that one, so a press does not arrive twice.
  • The right stick, the triggers and Y have no function.
  • To use the TV layout on a Linux desktop without Steam, start Yafmp with the environment variable YAFMP_TV=1.
  • AirPlay, Chromecast and Connect find devices through Avahi. On SteamOS the Avahi service is installed but not running until you enable it.