Repository navigation
Install: curl -fsSL https://spotatui.com/install.sh | bash on macOS and Linux, or irm https://spotatui.com/install.ps1 | iex on Windows. Already installed? Run spotatui update --install, or update with your package manager.
Terminal app
| Download | |
|---|---|
| Windows 10/11 | 64-bit .zip |
| macOS | Apple Silicon · Intel |
| Linux | x86_64 · ARM64 (Raspberry Pi 4/5) |
| Debian, Ubuntu | .deb amd64 · .deb arm64 |
Desktop app (preview)
| Download | |
|---|---|
| Windows 10/11 | Installer .exe |
| macOS | Apple Silicon .dmg · Intel .dmg |
| Linux x86_64 | AppImage · .deb · .rpm |
| Linux ARM64 | AppImage · .deb · .rpm |
The Windows installer, the macOS app and the AppImage update themselves. A .deb or .rpm install updates with a new download from this page. Linux needs glibc 2.39 and WebKitGTK 4.1 (Ubuntu 24.04+, Debian 13, Fedora 40+, Arch).
First launch on Windows and macOS
- Windows: the installer is not signed yet, so SmartScreen warns. Click More info, then Run anyway.
- macOS: the app is not notarized, so macOS blocks the first launch. Close the dialog, open System Settings > Privacy & Security, click Open Anyway next to the spotatui message, and confirm.
Both apps play Spotify (Premium), Local Files, Subsonic, Internet Radio, YouTube and Qobuz, plus Apple Music on macOS. YouTube needs yt-dlp (ffmpeg recommended).
Verify a download: checksums.txt has the SHA-256 of every file: sha256sum -c --ignore-missing checksums.txt.
Full changelog · Code signing policy
What's Changed
- chore(deps): bump the rust-minor-updates group with 4 updates by @dependabot[bot] in #942
- chore(deps): bump the desktop group in /desktop with 3 updates by @dependabot[bot] in #943
- chore(ci): bump cachix/install-nix-action from 31.11.2 to 31.11.3 in the actions group by @dependabot[bot] in #941
- feat(i18n): translate GUI navigation, playback and onboarding by @2570165831 in #939
- fix(dj): paint the prompt caret at the cursor by @JosephAnderson234 in #946
- fix(settings): preserve settings panel scroll offset by @Oud-Idk in #940
- feat(tui): search playlists in the add-to-playlist picker by @deauthe in #925
- fix(logging): list every compiled feature in the startup header by @JosephAnderson234 in #951
- feat(i18n): translate GUI search and library actions by @2570165831 in #953
- fix: repair ten open bug reports by @LargeModGames in #954
- chore(deps): bump the librespot fork to 0.8.7 by @LargeModGames in #955
- fix(infra): include the error source chain in soloist download failures by @niukanen1 in #958
- feat(i18n): complete Chinese GUI statistics and social views by @2570165831 in #956
- fix(audio): fall back to ALSA visualizer capture by @LargeModGames in #959
- docs: add an Android TV community setup guide by @LargeModGames in #960
- fix(deps): update dependencies for open advisories by @LargeModGames in #961
- feat(tui): detach screens into side panes by @LargeModGames in #963
- feat(i18n): translate Soloist, new key rows and the remaining strings by @2570165831 in #962
- feat(gui): add a visualizer screen with the TUI styles by @LargeModGames in #965
- chore(deps): bump the rust-minor-updates group with 5 updates by @dependabot[bot] in #967
- chore(deps): bump tauri-plugin-single-instance from 2.5.4 to 2.5.5 in /desktop in the desktop group by @dependabot[bot] in #968
- feat(cli): list a playlist's tracks by URI by @JosephAnderson234 in #969
- fix(create playlist): input box scrolls and cursor clamps on name and search fields by @IDLinares in #964
- feat(tui): seek to selected lyric line on Enter by @everyoneexe in #970
- feat(gui): add detachable panes and movable bars by @LargeModGames in #975
- feat(tui): add a now playing panel beside the main content by @JosephAnderson234 in #976
- fix(tui): show cover art in iTerm2 by @LargeModGames in #979
- fix(history): stop stub listens in Recently Played by @LargeModGames in #982
- fix(lint): clean clippy for sources without streaming by @LargeModGames in #983
- fix: harden credentials, agents and local channels by @LargeModGames in #987
New Contributors
- @JosephAnderson234 made their first contribution in #946
- @deauthe made their first contribution in #925
- @IDLinares made their first contribution in #964
- @everyoneexe made their first contribution in #970
Full Changelog: v0.47.0...v0.48.0