← Package directory
Available on winget

Install spotify_player

A Spotify player in the terminal with full feature parity

Install with winget
winget install --id aome510.spotify-player
Upgrade
winget upgrade --id aome510.spotify-player
Uninstall
winget uninstall --id aome510.spotify-player

About spotify_player

spotify_player is a fast, easy to use, and configurable terminal music player.

What's new in 0.24.0

Highlights The main theme of this release is improving robustness and reliability. Several long-standing pain points around image rendering, authentication, and app stopped working after running for a while have been reworked: - More reliable album art β€” migrated from viuer to ratatui-image (#969). - Hardened authentication β€” a more robust OAuth flow, an enforced Web API client, and improved docs make logging in far less fragile (#1013). - Smarter reconnection β€” reworked auto-reconnect logic so the app recovers more gracefully from dropped connections (#1016). What's Changed - update cd workflow to not use archived actions-rs by @aome510 in #953 - fix: Mouse seeking respects progress bar position by @shettysach in #955 - Add logs page to see application's logs directly in UI by @sakashimaa in #957 - Custom playback integration phase 1: add CustomQueue scaffolding by @aome510 in #959 - add lyrics CLI command by @sakashimaa in #958 - Handle nil tracks during playback by @drewmnoel in #962 - Overridable config via CLI -o flag by @sakashimaa in #965 - Add confirmation popups on destructive actions by @sakashimaa in #966 - Migration to ratatui_image instead of viuer by @sakashimaa in #969 - Deduplicate page history by @mielpeeters in #988 - Fix image rendering issues by @aome510 in #1012 - Improve authentication: robust OAuth flow, enforced Web API client, and docs by @aome510 in #1013 - feat: Add liked songs panel to artist page by @Jeremy-Ryan-Mills in #979 - Added MPRIS OpenUri support by @Bettehem in #993 - feat: add pause_on_startup option to suppress startup auto-resume by...

Read release notes

Version history

Version Updated Notes
0.24.0 Unknown Highlights The main theme of this release is improving robustness and reliability. Several long-standing pain points around image rendering, authentication, and app stopped working after running for a while have been rew...
0.23.0 Unknown Highlight of this release is the new optional real-time audio visualisation (thanks @Narqulie for the implementation) Audio Visualization What's Changed - docs: fix broken relative links in README for crates.io compatibi...
0.22.1 Unknown What's Changed - fix: keep main thread alive on Linux and when media-control is disabled - Issue 924 by @Douglas019BR in #925 Full Changelog: v0.22.0...v0.22.1
0.21.3 Unknown NOTE: this is a patched release acting as a temporary release until #890 is resolved or when Spotify fixes their broken APIs πŸ˜”πŸ˜”πŸ˜” Refer to #890 (comment) for context on the workaround changes to handle the broken Spotify...
0.21.0 Unknown The highlight of this new release is the upgrade to a new librespot version (v0.7.1), fixing different issues happening because of breaking changes from Spotify APIs. Beside that, this release also includes a few nice Qo...
0.20.6 Unknown What's Changed - fix playlist folders sorting by @aNNiMON in #719 - feat: add currently playing lyric highlight by @JamesManningR in #733 - recommend official Arch package instead of AUR by @ThomasFrans in #722 - fix: ad...
0.20.5 Unknown What's Changed - Add Catppuccin Themes by @aestellic in #655 - Clarify client_id_command option & trim output by @juliamertz in #656 - feat: start playback for track from cli by @juliamertz in #649 - Config option to sor...
0.20.4 Unknown Highlight of the release is the introduction of synced lyrics in LyricsPage test.mov What's Changed - Allow changing of volume in different steps by @DOD-101 in #629 - fix: playlist sorting by date by @juliamertz in #634...
0.19.1 Unknown v0.19.1 welcomes many new contributors. Contributions are highly appreciated! Feel free to look into the list of good first issues if you want to contribute.The project also gained a lot of traction recently. It's really...
0.18.2 Unknown What's Changed - rustls-tls and native-tls features for lyric_finder by @cycle-five in #434 - Miscellaneous fixes by @aome510 in #439 - New AUR package - adding to README? by @blackthorne7 in #441 New Contributors - @cyc...
0.18.1 Unknown What's Changed - downgrade ratatui to v0.26.1 to fix #424 and #426 - add CLI search command by @kadinsayani in #432 - Add album to queue action by @nikosavola in #429 New Contributors - @kadinsayani made their first cont...
0.17.2 Unknown What's Changed - ensure no popup is rendered on top the playback window in #400 - add patch for null issue with images field when getting user playlist in #402 Full Changelog: v0.17.1...v0.17.2
0.17.1 Unknown What's Changed - don't refresh playback on new streaming player event in #388 - remove patches for Spotify API's float bugs in #392 - re-render image if the last rectangle is different from the current one in #390 Full C...