Repository navigation
Releases: vrdq/spoff
Releases · vrdq/spoff
Release list
v0.1.0 - Official PyPI Release
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
mpvprocess 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