Skip to content

Releases: vrdq/spoff

v0.1.0 - Official PyPI Release

Choose a tag to compare

@vrdq vrdq released this 25 Sep 16:08

spoff v0.1.0

Terminal audio player for Linux that streams from YouTube Music and syncs Spotify metadata with local caching, synchronized LRC lyrics, and a CAVA spectrum visualizer.

Highlights

  • PyPI Release: Available globally on PyPI via pipx install spoff.
  • Awesome TUI Listing: Featured on Awesome TUI with Verified Maintainer status.
  • Zero Spotify Premium Requirement: Streams audio via YouTube Music through a background mpv process over a local Unix domain socket.
  • Low Memory Footprint: Idles under 50MB RAM compared to 1GB+ on Electron.
  • Local Audio Caching: Automatically saves played tracks to ~/.local/share/spoff/cache/ for instant offline playback.
  • Real-Time Visualizer: 60 FPS audio spectrum bars rendered through CAVA PCM FIFO pipe.
  • Synced Lyrics: Interactive LRC lyrics with click-to-seek timestamp navigation.
  • MPRIS 2 D-Bus Support: Full integration with Waybar, lockscreens, and hardware media keys.

Installation

pipx install spoff