A Spotify player in the terminal with full feature parity
6.9k
Stars
361
Forks
131
Open issues
30
Contributors
AI Analysis
A terminal-based Spotify player written in Rust that offers feature parity with the official Spotify application, including streaming, Spotify Connect support, audio visualization, and synced lyrics. It serves power users and developers who prefer command-line music playback with deep customization, running on Linux, macOS, and Windows. This is not a general-purpose music player—it requires a Spotify Premium account and is optimized for users comfortable with terminal interfaces and vim-like ...
Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.
AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.
Terminal-based Spotify client in Rust with near-complete feature parity to the official app
spotify-player is a TUI (terminal user interface) Spotify client written in Rust that brings streaming, Spotify Connect, synced lyrics, audio visualization, desktop notifications, cross-platform media control, and a CLI interface to the terminal. It targets power users, developers, and sysadmin-adjacent users who prefer keyboard-driven workflows and spend most of their time in the terminal. With 6,867 stars and broad package manager availability (Homebrew, Arch, Nix, Void, FreeBSD, NetBSD, Docker, Scoop), it has established real community presence in the terminal-tools ecosystem.
Created in July 2021, the project has grown steadily over five years, coinciding with a broader resurgence of interest in Rust-based terminal tools and growing dissatisfaction with Spotify's resource-heavy Electron desktop client.
Growth appears driven by the terminal-tools community on platforms like Reddit (r/unixporn, r/rust) and Hacker News, as well as inclusion in major Linux/BSD package repositories. The feature parity claim — particularly streaming via librespot and Spotify Connect support — differentiates it from simpler TUI clients. Steady but modest recent star velocity (18 stars/week) suggests stable organic interest rather than viral spikes.
Packaged in Arch Linux official repos, NixOS, Void Linux, FreeBSD, NetBSD, Homebrew, and Scoop — a strong signal of community trust and real-world installation at scale. Docker image is published. No evidence of enterprise or organizational deployment, consistent with its terminal-tool niche. Adoption appears concentrated among individual power users and Linux enthusiasts.
Likely built on top of librespot for Spotify protocol handling, with a TUI layer (appears to use ratatui or similar Rust TUI framework). The daemon mode and CLI commands suggest a client-server architecture with IPC. Multiple audio backends (ALSA, PulseAudio, JACK, GStreamer, etc.) are exposed via Cargo feature flags, indicating modular audio abstraction. Image rendering and audio visualization are optional compile-time features.
Not documented in README
Last push was May 14, 2026 — approximately 5-6 weeks before the evaluation date. This indicates active maintenance. The project has been consistently updated since 2021, suggesting sustained long-term commitment from the primary maintainer. Package availability across multiple distributions implies ongoing packaging work as well.
ADOPT IF: you are a Spotify Premium subscriber who lives in the terminal, wants a keyboard-driven player with streaming, Spotify Connect, and minimal system overhead, and is comfortable with Rust toolchain for installation. AVOID IF: you do not have Spotify Premium, prefer GUI applications, or need guaranteed long-term stability against Spotify API changes. MONITOR IF: you are evaluating TUI music clients and want to compare against ncspot — both are viable, and the choice may come down to configuration style.
Independent dimensions
Mainstream potential
3/10
Technical importance
6/10
Adoption evidence
6/10
- Spotify may restrict or revoke access to the unofficial librespot protocol at any time, potentially breaking all streaming functionality without warning.
- Long-term maintenance depends heavily on a single primary maintainer; bus-factor risk is not publicly documented.
- Spotify Premium requirement excludes free-tier users entirely, limiting the potential user base.
- Audio backend complexity (8+ backends, compile-time flags) may create friction for less technical users and increase surface area for platform-specific bugs.
- Spotify API changes or authentication policy shifts have historically disrupted projects in this space; no organizational backing provides a buffer against such changes.
Likely to remain a stable, well-maintained niche tool for terminal enthusiasts as long as librespot remains viable. Unlikely to grow beyond its current audience but equally unlikely to collapse absent a Spotify API crackdown.
Newsletter
Get analyses like this every Monday
Free weekly digest of the most interesting open-source discoveries.
Languages
Information
- Language
- Rust
- License
- MIT
- Last updated
- 1w ago
- Created
- 61mo ago
- Analyzed with
- anthropic/claude-haiku-4-5
Stars over time
Contributors over time
Top 100 contributors only — repos with more will plateau at 100.
Open issues
Feat: Add command/shortcut to play albums and playlists directly
Album cover image load as pixel art after last update
improve Logs page
"Unable to load encrypted file"
Unable to execute keyboard shortcuts after filtering context with a search
Top contributors
Similar repos
abba23/spotify-adblock
A Linux-specific tool that blocks advertisements in Spotify by intercepting...
| Repository | Stars | Week Δ | Language | Score | Updated |
|---|---|---|---|---|---|
|
aome510/spotify-player
this
|
6.9k | +13 | Rust | 8/10 | 1w ago |
 hrkfdn/ncspot
|
6.7k | — | Rust | 7/10 | 1d ago |
 Spotifyd/spotifyd
|
10.7k | — | Rust | 7/10 | 1mo ago |
 tramhao/termusic
|
2.1k | — | Rust | 7/10 | 22h ago |
|
abba23/spotify-adblock
|
2.2k | — | Rust | 7/10 | 1mo ago |
 librespot-org/librespot
|
6.9k | — | Rust | 7/10 | 2w ago |
ncspot is the closest direct competitor — also a Rust TUI Spotify client with similar star count (~6,662). spotify-player claims broader feature parity (synced lyrics, audio visualization, daemon mode, CLI) compared to ncspot's more minimal design philosophy. Choice between them is largely a matter of preference.
spotifyd is a headless Spotify daemon, not a TUI. It is often used alongside other interfaces (e.g., spotify-tui). spotify-player combines streaming and UI in one binary, making it more self-contained but less composable for some setups.
psst (~9,430 stars) is a native GUI Spotify client in Rust, targeting a different audience entirely. psst appears less actively maintained based on recent activity, while spotify-player is still receiving updates.
librespot is a library/daemon layer that spotify-player depends on. It is not a competing user-facing client but rather infrastructure. spotify-player surfaces librespot's capabilities in a usable TUI.
The official client is the baseline for feature parity. spotify-player's primary value proposition is replacing it for users who prefer the terminal, with lower resource usage likely as a side benefit. However, the official client requires no Spotify Premium workarounds and has guaranteed long-term API compatibility.
