vtamp

A terminal music player that keeps playing when you close the pane.

vtamp.told.me Source on GitHub brew install rath/tap/vtamp
vtamp in Catppuccin Mocha: album art and the current track above the Library and the Queue, side by side in a wide terminal.
A wide terminal: album art and the current track above Library and Queue.

A little Winamp in a terminal

I missed the small player that used to sit in the corner of the desktop with its playlist, album art, and green display. In vtamp that player lives in a terminal pane. Pick a track, press q to get back to work, and open vtamp later in a different pane. The same song and queue are waiting wherever playback has reached.

Listen from another device

A persistent server owns playback and the queue. The terminal and the JSON command line are two clients of that server. It can also cast an Ogg Opus stream from a headless machine. The iPhone and Android apps browse its library over a private network and play tracks on the phone.

Features

  • One persistent playback server, any number of terminal and command-line clients.
  • Local audio files and HLS, MP3, and AAC radio streams share one queue. Optional video imports play at up to 480p inside the terminal.
  • Album art via Sixel or Kitty graphics with a halfblock fallback, fourteen spectrum styles, and nine built-in colour themes.
  • macOS media keys, Now Playing metadata, and a tmux status-bar plugin.
  • Headless Linux servers that cast Ogg Opus to remote listeners, and a relay mode that plays a remote server through the local device.

Screenshots

A short terminal pane keeps the album cover and playback controls on the left, with the queue on the right.
A short pane keeps the cover and playback on the left and the queue on the right.