v0.40 · Music sources

It plays far beyond Spotify.

spotatui is growing into a general music player. Press d to open the Source and Device picker; the sidebar and search re-scope to whatever you switch to. Local Files, Subsonic, Internet Radio, YouTube and Qobuz play through spotatui's own audio engine, so volume and the visualizer work for them as they do for Spotify. On macOS, Apple Music plays through the Music app, with spotatui as the remote.

Local Files free

Browse and play a folder of audio: FLAC, MP3, OGG, WAV and more. Selecting a track queues the whole folder with next/previous and auto-advance.

NeedsNothing. Set local_music_path or use your OS music directory. Setup

Subsonic free

Browse playlists, search, and stream from any Subsonic-compatible server: Navidrome, Gonic, Airsonic, Funkwhale and friends. Your own library, anywhere.

NeedsA server account. Setup

Internet Radio free

Play icecast/shoutcast streams with live now-playing metadata. Search the radio-browser.info directory, 30,000+ stations, right from the search box.

NeedsNothing. Press F to save a station to your sidebar. Setup

YouTube free

Search YouTube and play audio anonymously: no account, no API key, no cookies. Build local playlists stored in a plain, shareable file you own.

NeedsThe yt-dlp binary on your PATH (ffmpeg recommended). Setup

Qobuz paid

Stream your Qobuz favorites, playlists and albums at up to FLAC 24/192 through spotatui's own engine. Log in through the browser once; the playbar shows the format Qobuz delivered.

NeedsA paid Qobuz account. Pick Qobuz in the first-run picker or the d menu. Setup

Apple Music macOS

spotatui drives the Music app as a remote: browse All songs and your library playlists, search your library, and control playback, volume and the media keys from the terminal. Music plays the songs with your own Apple Music login and stays in the background.

NeedsmacOS and the Music app. Pick Apple Music in the first-run picker or the d menu, and let your terminal control Music when macOS asks. Setup
✓
No Spotify Premium required.

YouTube, Subsonic, Internet Radio and Local Files all work with no Spotify account. Combined with local playlists, spotatui is fully usable without any paid subscription. Add Spotify anytime later from the d menu: spotatui shows a code, you confirm it on Spotify's pairing page, and there is no developer app or client ID to set up. Spotify itself needs Premium; the login refuses a free account.

Configure once

Plain YAML, no dashboards.

Point spotatui at your library and servers in ~/.config/spotatui/config.yml, or edit settings in-app. Every key is in the configuration docs.

Quit while playing a non-Spotify source and spotatui picks up the track and position on next launch.

config.yml
behavior:
  local_music_path: "/home/you/Music"
  subsonic_url: "https://music.example.com"
  subsonic_username: "you"
  ytdlp_path: "yt-dlp"   # defaults to PATH
  radio_stations:
    - name: "SomaFM Groove Salad"
      url:  "https://ice1.somafm.com/..."

Included in the Linux, macOS and Windows release binaries; Apple Music is in the macOS ones only. Building from source? See which build has which features.