spotatui: baixar versions anteriors

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
- ci(desktop): use the prebuilt tauri-cli from npm by @LargeModGames in #776
- chore(deps): bump the rust-minor-updates group with 20 updates by @dependabot[bot] in #767
- chore(ci): bump the actions group with 4 updates by @dependabot[bot] in #766
- chore(deps): bump the desktop group in /desktop with 4 updates by @dependabot[bot] in #765
- chore(deps): bump lofty from 0.24.0 to 0.25.3 by @dependabot[bot] in #771
- chore(deps): bump dirs from 6.0.0 to 7.0.0 by @dependabot[bot] in #773
- chore(deps): bump base64 from 0.22.1 to 0.23.1 by @dependabot[bot] in #774
- ci(deps): hold back bumps that break the build by @LargeModGames in #777
- fix(tui): correct navigation when playbar is set to top of screen by @Muu79 in #761
- feat(tui): search Liked Songs from the cached page store by @Oud-Idk in #754
- chore(deps): bump lofty from 0.25.3 to 0.25.4 in the rust-minor-updates group by @dependabot[bot] in #778
- docs(readme): add the code signing policy by @LargeModGames in #779
- feat(lyrics): add a setting to turn the lookup off by @LargeModGames in #780
- fix(desktop): skip the update check while auto-update is off by @LargeModGames in #781
- fix(playlist): refetch stale tracks when clearing search by @theluckystrike in #786
- feat(gui): catch up with the terminal app by @LargeModGames in #790
- fix(gui): add a Spotify login button by @LargeModGames in #796
- feat(spotify): play on Cast and Connect speakers on the LAN by @LargeModGames in #795
- fix(playback): send media-key play/pause to the device that plays by @Wassergeist in #798
- docs: clarify terminal login and search result navigation by @Battlelamb in #799
- feat(discover): show Spotify's Made For You playlists by @LargeModGames in #807
- fix(mpris): publish a track id so absolute seeks reach spotatui by @Wassergeist in #809
- feat(gui): ship the other sources in the GUI by @LargeModGames in #810
- docs(i

Downloads
- Windows 10/11 (64-bit) → Download spotatui-windows-x86_64.zip
- Linux (Ubuntu, Arch, Fedora, etc.) → Download spotatui-linux-x86_64.tar.gz
- Linux ARM64 (Raspberry Pi 4/5, ARM servers) → Download spotatui-linux-aarch64.tar.gz
- Debian/Ubuntu (amd64) → Download .deb
- Debian/Ubuntu (arm64) → Download .deb
- macOS with Intel CPU → Download spotatui-macos-x86_64.tar.gz
- macOS with Apple Silicon (M1/M2/M3) → Download spotatui-macos-aarch64.tar.gz
Or just run the one-line installer: curl -fsSL https://spotatui.com/install.sh | bash (macOS/Linux) or irm https://spotatui.com/install.ps1 | iex (Windows).
Checksums (.sha256) are optional and only needed if you want to verify the download.
The Linux, macOS, and Windows builds include the extra music sources (Local Files, Subsonic, Internet Radio, YouTube, Qobuz). The YouTube source needs yt-dlp installed (ffmpeg recommended).
To update use "spotatui update --install" or use your package manager of choice.
Desktop app (preview, unsigned)
spotatui in its own window, with the same player, login and settings as the terminal app. The preview plays Spotify (Premium) only. Its installers are added to this release a few minutes after it is published. The Windows installer, the macOS app and the AppImage update themselves from then on; a .deb or .rpm install updates with a new download from this page.
- Windows 10/11 (64-bit) → spotatui-desktop_*_x64-setup.exe. The installer is not signed, so SmartScreen warns: click More info, then Run anyway.
- macOS → spotatui_*_aarch64.dmg (Apple Silicon) or spotatui_*_x64.dmg (Intel). Drag spotatui to Applications and open it. The app is not notarized, so macOS refuses the first launch: close that dialog, open System Settings > Privacy & Security, click Open Anyway next to the spotatui message, and confirm.
- Linux (amd64, arm64) → .deb (Debian/Ubuntu), .rpm (Fedora) or .AppImage. Needs glibc 2.39 and WebKitGTK 4.1: Ubuntu 24.04+, Debian 13, Fedora 40+, Arch.
What's Changed
- fix: out-of-range color in config.yml stops spotatui from starting. by @Hi-1mYara in #569
- fix(streaming): honor HTTP proxy env vars for the librespot session by @mschmicking in #570
- docs: add mschmicking as a contributor for code by @allcontributors[bot] in #572
- feat(native): park librespot under another source by @LargeModGames in #571
- feat(logging): add a debug mode for bug reports by @mschmicking in #574
- fix(spotify): handle removed endpoints for Development Mode apps by @Oud-Idk in #577
- feat(runtime): refuse a second UI instance by @LargeModGames in #578
- refactor(runtime): share the frontend launch and exit by @LargeModGames in #579
- feat(app): per-domain display revisions by @LargeModGames in #580
- refactor(app): make the display state private by @LargeModGames in #581
- feat(gui): serve a browser frontend over loopback by @LargeModGames in #582
- feat(gui): TypeScript bindings and a placeholder page by @LargeModGames in #583
- feat(gui): answer the first-launch questions in the page by @LargeModGames in #584
- fix(tui): stop narrow table panes from underflowing the column width by @2570165831 in #587
- docs: add 2570165831 as a contributor for code by @allcontributors[bot] in #591
- fix(tui): uppercase Shift + any lowercase letter, not only ASCII by @2570165831 in #588
- fix(config): parse ctrl-- and alt-- keybindings by @zaydmulani09 in #592
- fix(tui): preserve Windows console shift casing by @tayfuryldz in #593
- docs: add tayfuryldz as a contributor for code by @allcontributors[bot] in #616
- docs: add AI contribution rules, split AGENTS.md by @LargeModGames in #617
- test(gui): add Playwright screenshot harness by @LargeModGames in #619
- fix(tui): draw an empty titled table while library sections load by @chiliec in #620
- docs: add chiliec as a contributor for code by @allcontributors[bot] in #625
- ci(gates): hold adoption counters as floors by @LargeModGames in #626
- Fix #605: reject invalid --tick-rate values instead of silently ignoring th

Downloads
- Windows 10/11 (64-bit) → Download spotatui-windows-x86_64.zip
- Linux (Ubuntu, Arch, Fedora, etc.) → Download spotatui-linux-x86_64.tar.gz
- Linux ARM64 (Raspberry Pi 4/5, ARM servers) → Download spotatui-linux-aarch64.tar.gz
- Debian/Ubuntu (amd64) → Download .deb
- Debian/Ubuntu (arm64) → Download .deb
- macOS with Intel CPU → Download spotatui-macos-x86_64.tar.gz
- macOS with Apple Silicon (M1/M2/M3) → Download spotatui-macos-aarch64.tar.gz
Or just run the one-line installer: curl -fsSL https://spotatui.com/install.sh | bash (macOS/Linux) or irm https://spotatui.com/install.ps1 | iex (Windows).
Checksums (.sha256) are optional and only needed if you want to verify the download.
The Linux, macOS, and Windows builds include the extra music sources (Local Files, Subsonic, Internet Radio, YouTube, Qobuz). The YouTube source needs yt-dlp installed (ffmpeg recommended).
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- fix: out-of-range color in config.yml stops spotatui from starting. by @Hi-1mYara in #569
- fix(streaming): honor HTTP proxy env vars for the librespot session by @mschmicking in #570
- docs: add mschmicking as a contributor for code by @allcontributors[bot] in #572
- feat(native): park librespot under another source by @LargeModGames in #571
- feat(logging): add a debug mode for bug reports by @mschmicking in #574
- fix(spotify): handle removed endpoints for Development Mode apps by @Oud-Idk in #577
- feat(runtime): refuse a second UI instance by @LargeModGames in #578
- refactor(runtime): share the frontend launch and exit by @LargeModGames in #579
- feat(app): per-domain display revisions by @LargeModGames in #580
- refactor(app): make the display state private by @LargeModGames in #581
- feat(gui): serve a browser frontend over loopback by @LargeModGames in #582
- feat(gui): TypeScript bindings and a placeholder page by @LargeModGames in #583
- feat(gui): answer the first-launch questions in the page by @LargeModGames in #584
- fix(tui): stop narrow table panes from underflowing the column width by @2570165831 in #587
- docs: add 2570165831 as a contributor for code by @allcontributors[bot] in #591
- fix(tui): uppercase Shift + any lowercase letter, not only ASCII by @2570165831 in #588
- fix(config): parse ctrl-- and alt-- keybindings by @zaydmulani09 in #592
- fix(tui): preserve Windows console shift casing by @tayfuryldz in #593
- docs: add tayfuryldz as a contributor for code by @allcontributors[bot] in #616
- docs: add AI contribution rules, split AGENTS.md by @LargeModGames in #617
- test(gui): add Playwright screenshot harness by @LargeModGames in #619
- fix(tui): draw an empty titled table while library sections load by @chiliec in #620
- docs: add chiliec as a contributor for code by @allcontributors[bot] in #625
- ci(gates): hold adoption counters as floors by @LargeModGames in #626
- Fix #605: reject invalid --tick-rate values instead of silently ignoring them by @wanjinhao1 in #618
- docs: add wanjinhao1 as a contributor for code by @allcontributors[bot] in #627
- fix(cli): render format strings in a single pass, show publishers in search by @wanjinhao1 in #623
- ci(gates): cancel superseded floor runs by @LargeModGames in #628
- feat(gui): design tokens, top bar and player bar by @LargeModGames in #629
- feat(gui): Library screen with Liked Songs and playlists by @LargeModGames in #630
- Sort playlists case-insensitively by @niukanen1 in #631
- docs: add niukanen1 as a contributor for code by @allcontributors[bot] in #638
- fix(stats): group Last 10 Days by the local date, not UTC by @2570165831 in #632
- fix(cli): return an error instead of panicking on empty play results by @2570165831 in #633
- fix(settings): clamp number settings to their field's range before saving by @2570165831 in #634
- fix(theme): reject unknown colors instead of turning them black by @2570165831 in #635
- fix(help): stop offering Ctrl+p for moving up and scrollin

Downloads
- Windows 10/11 (64-bit) → Download spotatui-windows-x86_64.zip
- Linux (Ubuntu, Arch, Fedora, etc.) → Download spotatui-linux-x86_64.tar.gz
- Linux ARM64 (Raspberry Pi 4/5, ARM servers) → Download spotatui-linux-aarch64.tar.gz
- Debian/Ubuntu (amd64) → Download .deb
- Debian/Ubuntu (arm64) → Download .deb
- macOS with Intel CPU → Download spotatui-macos-x86_64.tar.gz
- macOS with Apple Silicon (M1/M2/M3) → Download spotatui-macos-aarch64.tar.gz
Or just run the one-line installer: curl -fsSL https://spotatui.com/install.sh | bash (macOS/Linux) or irm https://spotatui.com/install.ps1 | iex (Windows).
Checksums (.sha256) are optional and only needed if you want to verify the download.
The Linux, macOS, and Windows builds include the extra music sources (Local Files, Subsonic, Internet Radio, YouTube, Qobuz). The YouTube source needs yt-dlp installed (ffmpeg recommended).
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- fix(playback): claim the sink before a source starts by @LargeModGames in #522
- refactor: feature aliasing by @topongo in #523
- add optional image dithering feature by @shilicioo in #526
- fix macos media keys behaviour by @shilicioo in #528
- fix shuffle track start time shift by @shilicioo in #531
- feat(sync): playlist sync across sources by @LargeModGames in #533
- fix(native): guard librespot paths by sink owner by @LargeModGames in #534
- fix(tui): page track tables with next_page and previous_page by @LargeModGames in #538
- fix(library): load the next Saved Albums page from the last row by @LargeModGames in #539
- docs: fix CONTRIBUTING slim gate commands and CI leg count. by @LargeModGames in #548
- fix: handle Spotify Development Mode playlist 403s by @nohint404 in #536
- docs: add nohint404 as a contributor for code by @allcontributors[bot] in #549
- fix(config): support non-ASCII character keybindings by @TongTong0828 in #551
- docs: add TongTong0828 as a contributor for code by @allcontributors[bot] in #552
- fix(artist): treat related-artists 403/404 as empty by @Oud-Idk in #550
- docs: clean up --help text by @Hi-1mYara in #555
- docs: add Hi-1mYara as a contributor for code, and doc by @LargeModGames in #558
- docs: add Oud-Idk as a contributor for code by @allcontributors[bot] in #559
- fix: terminal window title no longer says the old spt name by @yvoolab in #560
- docs: add yvoolab as a contributor for code by @allcontributors[bot] in #562
- docs: replace old spt name in CLI code comments by @yvoolab in #561
- fix(counter): count plays from every source by @LargeModGames in #564
- chore(release): v0.43.0 by @LargeModGames in #565
New Contributors
- @nohint404 made their first contribution in #536
- @TongTong0828 made their first contribution in #551
- @Hi-1mYara made their first contribution in #555
- @yvoolab made their first contribution in #560
Full Changelog: v0.42.0...v0.43.0

Downloads
- Windows 10/11 (64-bit) → Download spotatui-windows-x86_64.zip
- Linux (Ubuntu, Arch, Fedora, etc.) → Download spotatui-linux-x86_64.tar.gz
- Linux ARM64 (Raspberry Pi 4/5, ARM servers) → Download spotatui-linux-aarch64.tar.gz
- Debian/Ubuntu (amd64) → Download .deb
- Debian/Ubuntu (arm64) → Download .deb
- macOS with Intel CPU → Download spotatui-macos-x86_64.tar.gz
- macOS with Apple Silicon (M1/M2/M3) → Download spotatui-macos-aarch64.tar.gz
Or just run the one-line installer: curl -fsSL https://spotatui.com/install.sh | bash (macOS/Linux) or irm https://spotatui.com/install.ps1 | iex (Windows).
Checksums (.sha256) are optional and only needed if you want to verify the download.
The Linux, macOS, and Windows builds include the extra music sources (Local Files, Subsonic, Internet Radio, YouTube, Qobuz). The YouTube source needs yt-dlp installed (ffmpeg recommended).
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- Tokyo Night color scheme by @istipisti113 in #436
- fix(streaming): preserve external device handoffs by @shilicioo in #438
- Adaptive theme from cover art by @LargeModGames in #439
- refactor(core): split app.rs into a src/core/app/ module folder by @LargeModGames in #446
- feat(visualizer): add cava visualizer by @LargeModGames in #449
- test: add gui-substrate ratchet counters by @LargeModGames in #450
- ci: add tui feature and headless leg by @LargeModGames in #451
- ci: ratchet gates.count against merge-base by @LargeModGames in #454
- refactor(core): move domain types out of tui by @LargeModGames in #455
- fix: five small audit fixes by @LargeModGames in #456
- refactor: split cover art into store and renderer by @LargeModGames in #457
- readme redesign by @istipisti113 in #435
- build: switch to published spotatui-librespot crates by @LargeModGames in #458
- ci: fix event payload code injection by @LargeModGames in #459
- refactor(core): move console I/O behind an onboarding trait by @LargeModGames in #460
- refactor: split the crate into a lib and bin shims by @LargeModGames in #462
- refactor(core): extract the tick driver from the runner by @LargeModGames in #463
- fix(cli): retry player commands on the saved device by @LargeModGames in #465
- fix(core): clear api_error instead of latching it by @LargeModGames in #467
- feat(tui): fuzzy filter for the settings screen by @LargeModGames in #471
- fix(streaming): restart the first track on Previous by @LargeModGames in #473
- fix(streaming): queue slot survives track end by @LargeModGames in #474
- refactor(app): group presentation state in App.view by @LargeModGames in #475
- refactor(core): shared action vocabulary by @LargeModGames in #476
- refactor(tui): route global keys through App::apply by @LargeModGames in #477
- refactor(tui): route list handlers through App::apply by @LargeModGames in #480
- ci(cd): auto release notes and direct download links by @LargeModGames in #481
- ci: add Codecov coverage upload by @LargeModGames in #482
- fix(dj): scratch dir fallback for unwritable home by @LargeModGames in #483
- refactor(tui): route handler tail through App::apply by @LargeModGames in #484
- feat(core): typed bootstrap onboarding requests by @LargeModGames in #485
- refactor(runtime): extract native-streaming startup by @LargeModGames in #486
- feat(sources): add Qobuz by @LargeModGames in #489
- fix(core): run without a Spotify session by @LargeModGames in #495
- refactor(core): rename AddFriendByUserId to AddFriendById by @LargeModGames in #500
- fix(local): scan nested folders so a two-level music library is browsable by @alessandro-zanni in #499
- docs: add alessandro-zanni as a contributor for code by @allcontributors[bot] in #501
- fix(audio): stop two pump freezes, and enable the alternative sources on macOS by @alessandro-zanni in #498
- fix(nix): bump nixpkgs past the crates.io 403 on crate downloads by @LargeModGames in #502
- fix(queue): refuse a plugin's repeat while the queue slot

Added
- MCP server: drive spotatui from your coding agent, with no API key (--features mcp-server): spotatui can expose your player and listening history as Model Context Protocol tools, so Claude Code, Codex, Gemini CLI, or any MCP client can act as your DJ — reading what you have been listening to, searching the catalogue, and queueing tracks. It rides the agent subscription you already have, so there is no key to configure and no LLM client compiled into spotatui. Setup is one line handed to your agent: point it at docs/mcp-setup.md, which is written as instructions for an agent to follow, and spotatui mcp status gives it a safe, machine-checkable probe of each step (never run spotatui mcp to test — that command is the server and blocks on stdin). Off by default: set behavior.mcp_enabled: true, and the socket binds loopback-only behind a token in ~/.config/spotatui/mcp.json. Written against protocol revision 2026-07-28 — which removed the initialize handshake and made MCP stateless — and dual-era, so it also answers initialize for the clients shipping today, which would otherwise fail outright against a modern-only server. Ask an agent for "songs like X" and a good recommender names tracks you already own, so search_tracks marks every result [owned] or [new] — Liked Songs plus playlists you own or collaborate on — which reaches the agent exactly when it is choosing, with no extra round trip. queue_tracks also takes exclude_owned: true for an agent that wants the guarantee rather than the hint; it reports what it skipped and substitutes nothing. Neither is on by default: an agent told to queue one specific track you happen to own should get that track, not an explanation.
- Agent plugin: connect your agent to the MCP server, with a DJ skill, in one install: agent-plugin/ packages the MCP server registration together with a spotatui-dj skill that teaches the agent how to DJ — read the listening history first, search before queueing by name, queue rather than interrupt. It ships in both the vendor-neutral Agent Plugins 1.0 format and Claude Code's plugin format from the same directory, and installs from this repo's marketplace (/plugin marketplace add LargeModGames/spotatui, then /plugin install spotatui@spotatui). It replaces the client-registration step of docs/mcp-setup.md only; the binary still needs --features mcp-server and behavior.mcp_enabled: true. These are agent plugins for AI clients, unrelated to spotatui's in-app Lua plugins.
- AI DJ inside spotatui (--features ai-dj): a DJ screen (Ctrl + J) with a chat prompt, continuous auto-queue (Ctrl + T), an "only tracks I don't already have" filter (Ctrl + O), and a vibe shift (Ctrl + Y) that drops the DJ's own queued tracks so a change of direction is audible now rather than six tracks from now. It holds a conversation and drives the same tools an MCP client does: a turn is up to four steps, and each step the model can search the catalogue, read your queue, queue tracks, or simply reply — so it can ask what you actually want before it plays anything, and answer a question without queueing at all. The tool list is the MCP server's own table rather than a copy, so the two front doors can never drift apart in what they can do. Every tool call is shown in the transcript as it runs, and the …thinking (2/4) row keeps a slow turn distinguishable from a hang, which matters because each step of an agent-CLI turn is a fresh subprocess. The auto-queue refill and the vibe shift deliberately get two steps and may not stop to ask anything: nobody is watching the screen for either. The brain is pluggable: a locally installed agent CLI (claude, codex, agy for Antigravity, copilot for GitHub Copilot, opencode, or anything headless, with no API key), the Anthropic Messages API, or any OpenAI-compatible endpoint including local models via Ollama and LM Studio. The first time you open it, the DJ asks which of your installed agents to use and which of that agent's models, because the default 

Added
- Lua scripting API v6: cover art and composable layouts in plugin screens: Custom plugin screens are no longer limited to a vertical stack of paragraphs, lists, and gauges. A new { type = "cover_art" } widget draws the current track's artwork from the image spotatui has already downloaded and decoded, so a plugin never re-downloads it and never writes terminal graphics escapes itself; the app keeps ownership of the protocol, resizing, placement, and cleanup, and the widget works for every source that provides art. New row and column containers nest to build grids, and every widget accepts a per-axis size hint (height/width in cells, or height_percent/width_percent), so "cover art beside synchronized lyrics" is now a handful of lines — see the new examples/plugins/now-playing.lua. Paragraphs gained scroll = false so a fixed header stays put while PageUp/PageDown scroll the rest. All v5 widget tables keep working unchanged (#396).
- Searchable Help menu: Press the configured search key (/ by default) while viewing Help to filter keybinding rows across descriptions, keys, and contexts. Multiple terms are matched together using smart-case matching; press Enter to apply the filter and Esc to clear it.
- Lyrics view: smooth scrolling, browsing, and a timing nudge: The lyrics view now glides between lines with a short eased animation instead of snapping. Scroll with ↑/↓ (or the mouse wheel) to read ahead or behind: auto-follow pauses while you browse (the browsed line is highlighted and a hint row appears) and resumes with f, Esc, or automatically after 8 seconds without input. Ctrl+d/Ctrl+u page five lines at a time and Ctrl+a/Ctrl+e jump to the first/last line. For LRC files whose timestamps do not line up with your audio, →/← nudge the lyric timing half a second earlier/later per press; the current offset is shown in the block title and resets on track change. The title also notes "(timing estimated)" when LRCLIB only had plain lyrics, so synthesized line timings are no longer presented as real ones.
- Banner Gradient toggle: A new setting (Settings → Theme → Banner Gradient, or behavior.banner_gradient in config.yml) turns off the home banner's animated RGB gradient and draws it in the theme's banner color instead. The Terminal (ANSI) preset defaults the gradient off so the banner follows the terminal palette out of the box — tools like pywal recolor it live along with the rest of the UI; an explicit banner_gradient: in the config overrides the preset default either way (#336).
- Shuffle and repeat for Local Files, Subsonic, and YouTube: The shuffle (Ctrl+s) and repeat (Ctrl+r) keys now work when one of the decoded sources owns playback, not just on Spotify. Repeat cycles Off → All → Track exactly as it does for Spotify: All wraps the context from the last track back to the first, Track replays the current song. Shuffle reorders in place and keeps the currently playing song playing (it becomes the new first track), so toggling it never interrupts audio; turning it back off restores the original order and keeps your place in it. Both modes, plus the shuffle order itself, survive a restart along with the rest of the playback session in last_session.yml. The modes are also routed through MPRIS, so playerctl shuffle/loop and desktop media controls drive them. Internet radio and native queue slots have no track queue of their own, so their playbar and MPRIS snapshot drop the shuffle/repeat controls entirely rather than showing inert ones — which is why the default format.playbar_status_source template gained self-contained {shuffle}/{repeat} segments (see docs/configuration.md).
- Spotify-style shuffle for native streaming: When shuffle is on and you start a playlist, album, or Liked Songs with spotatui as the playback device, the app now owns the shuffled play order itself instead of leaving it to Spotify. It shuffles the tracklist once (the song you picked plays first and everything else follows exactly once per pass), and on

Fixed
- Liked icons now show reliably everywhere: Album tracklists, artist pages, Recently Played, Discover lists, and recommendations now fetch the liked state of their tracks when opened, so the liked marker no longer appears only for songs played or searched this session. Artist pages also fetch saved-album and followed-artist state for their heart markers. In addition, liked-state lookups are now batched at Spotify's documented 40-URI limit instead of 50, fixing a 400 Bad Request "Too many uris" error that silently blanked the icons for any playlist or album longer than 40 tracks (#118).
- Native idle recovery no longer repeats forever: When Spotify reports no active playback after a stale native session, spotatui still tries to restore the local device automatically. It now stops after two recovery attempts for the same idle session instead of sending transfer(None) and activate() every few seconds (#311).
- Album tracklists no longer cut off at 50 songs: Opening an album now pages through the full Spotify tracklist instead of stopping at the API's 50-track page limit, whether the album is opened from search results, an artist's discography, a track's context, or the saved-albums library (#324).
- cargo install spotatui builds again: A fresh dependency resolve pulled in vergen 9.1.0, which breaks librespot's build script (two incompatible vergen-lib versions in the graph, error E0277). A constraint-only pin keeps vergen below 9.1 until librespot ships a fix; the README now also recommends cargo install --locked (#350).
- s saves tracks in search results: Pressing s on a highlighted track in the Songs search block now toggles its saved/liked state, matching the track-table binding shown in the help menu. Search results also fetch the liked state of listed tracks, so already-liked songs show the liked marker and toggle correctly (#348).
- MPRIS controls survive native-player recovery: Linux MPRIS events now look up the active native streaming player when they arrive, rather than retaining the instance created at startup. Media controls therefore continue to work after spotatui recreates its native player during streaming recovery (#356).
- Unmapped high function keys no longer crash the TUI: F13 through F24 now safely map to the unknown-key fallback instead of panicking, which protects spotatui from extended function keys emitted by global hotkeys (#332).
Added
- Lua scripting API v5: A major expansion of the plugin API. Plugins can now read library data asynchronously (get_playlists, get_queue, get_search_results, get_saved_tracks/albums/shows, get_recently_played, get_devices, get_lyrics, all with the (data, err) callback convention), drive far more of the app (set_repeat/cycle_repeat, transfer_playback, play_uri/play_context, add_to_queue, playlist create/edit, save/follow actions), schedule work with set_timeout/set_interval/cancel_timer, persist state in a per-plugin JSON store (storage_get/set/remove/keys), navigate (navigate/back/current_route), read the user config (config()), react to new events (shuffle_change, repeat_change, device_change, search_results, route_change), and register full custom screens with paragraph/list/gauge widgets and per-key callbacks (register_screen, set_screen, show_screen, close_screen). See docs/scripting.md and the new examples/plugins/queue-browser.lua.
- In-app listening stats and recap flow: The Library now includes a Stats screen with selectable 7-day, 30-day, monthly, yearly, and all-time views of total plays/listening time, top tracks/artists/albums, recent daily activity, plus current and longest listening streaks. Press the configurable recap key (R by default) to generate a shareable HTML card for the active period; the app can also offer a monthly recap on first launch of a new month (disable it with behavior.enable_monthly_recap_prompt). Listening history now syncs individual completed songs to spotatui.com when behavior.sync_token is configured, while retaining unsynced re

chore(release): bump version to 0.40.1 and update changelog
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
The Linux and Windows builds include the extra music sources (Local Files, Subsonic, Internet Radio, YouTube). The YouTube source needs yt-dlp installed (ffmpeg recommended).
To update use "spotatui update --install" or use your package manager of choice.
Full Changelog: v0.40.0...v0.40.1

Merge branch 'main' of github.com:LargeModGames/spotatui
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
The Linux and Windows builds include the extra music sources (Local Files, Subsonic, Internet Radio, YouTube). The YouTube source needs yt-dlp installed (ffmpeg recommended).
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- fix: self-update silently failing with 403 since v0.38.5 by @LargeModGames in #303
- chore(deps): bump the rust-minor-updates group with 4 updates by @dependabot[bot] in #305
- chore(deps): bump vergen-gitcl from 1.0.8 to 10.0.0 by @dependabot[bot] in #306
- chore(deps): bump vergen-lib from 9.1.0 to 10.0.0 by @dependabot[bot] in #307
- Add configurable movement keys by @tahminator in #304
- docs: add tahminator as a contributor for code by @allcontributors[bot] in #310
- fix native startup device activation and idle playbar state by @shilicioo in #308
- feat: add setting to disable media key controls (#309) by @LargeModGames in #312
- chore(deps): bump esbuild and wrangler in /worker-relay by @dependabot[bot] in #313
- chore(deps): bump undici and wrangler in /worker-relay by @dependabot[bot] in #314
- Fix silent native streaming (Spotify CDN HTTP 530) by @LargeModGames in #315
- refactor(c7): migrate recently-played to domain CursorPaged by @LargeModGames in #319
- feat(infra/local): B3 - local-files media source scaffold by @LargeModGames in #320
- refactor(C3): migrate album screen from rspotify types to domain types by @LargeModGames in #321
- refactor(C9): migrate create-playlist tracks to domain TrackInfo type by @LargeModGames in #322
- refactor(artist): migrate Artist struct and app.artists to domain types (C2 slice) by @LargeModGames in #323
- chore(ci): bump actions/checkout from 6 to 7 in the actions group by @dependabot[bot] in #316
- chore(deps): bump the rust-minor-updates group across 1 directory with 5 updates by @dependabot[bot] in #325
- fix(mpris): implement volume Set and sync Volume property to D-Bus by @Ritze03 in #328
- docs: add Ritze03 as a contributor for code, and bug by @allcontributors[bot] in #330
- Multi-source playback: Local Files, Subsonic, Internet Radio, and YouTube by @LargeModGames in #329
New Contributors
- @tahminator made their first contribution in #304
- @Ritze03 made their first contribution in #328
Full Changelog: v0.39.1...v0.40.0

chore(release): bump version to 0.39.1 and update changelog
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
Full Changelog: v0.39.0...v0.39.1

chore: update supported versions in SECURITY.md for version 0.39
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- chore(deps): bump the rust-minor-updates group with 2 updates by @dependabot[bot] in #283
- chore(deps): bump sha2 from 0.10.9 to 0.11.0 by @dependabot[bot] in #284
- chore(deps): bump tar from 0.4.45 to 0.4.46 by @dependabot[bot] in #286
- fix(streaming): keep playback on native device, surface failures (#282) by @LargeModGames in #287
- chore(deps): bump the rust-minor-updates group with 4 updates by @dependabot[bot] in #289
- Add playbar click-to-seek, fix search focus and cover art handling by @LargeModGames in #290
- fix spotatui native device and selector behavior by @shilicioo in #293
- System Media Tansport Controls Integration for Windows by @rlpratyoosh in #291
- fix: scroll settings list to keep selection in view by @LargeModGames in #294
- Fix stale native playback routing after streaming recovery by @shilicioo in #298
- Fix ghost spotatui Connect devices accumulating by @LargeModGames in #299
- Add Lua plugin scripting by @LargeModGames in #302
Full Changelog: v0.38.6...v0.39.0

chore: update version to v0.38.6 and enhance Spotify API request handling
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
Full Changelog: v0.38.5...v0.38.6

chore(release): bump version to 0.38.0 and update changelog
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- chore(deps): bump self_update from 0.42.0 to 0.43.1 by @dependabot[bot] in #155
- chore(deps): bump tokio-tungstenite from 0.26.2 to 0.28.0 by @dependabot[bot] in #154
- chore(deps): bump tokio from 1.49.0 to 1.50.0 in the rust-minor-updates group by @dependabot[bot] in #153
- chore(deps): bump quinn-proto from 0.11.13 to 0.11.14 by @dependabot[bot] in #158
- chore: update nix flake by @Kathund in #149
- docs: add Kathund as a contributor for platform by @allcontributors[bot] in #160
- chore: clean up nix flake version handling by @Kathund in #161
- Fix issue #139 playback drift and stabilize paged caches by @domogami in #163
- chore(deps): bump the rust-minor-updates group with 5 updates by @dependabot[bot] in #164
- docs: add domogami as a contributor for code by @allcontributors[bot] in #165
- feat: Implement add-track-to-playlist flow across more views by @higorprado in #168
- docs: add higorprado as a contributor for code by @allcontributors[bot] in #169
- Void Linux installation guide by @eiseq in #171
- docs: add eiseq as a contributor for doc by @allcontributors[bot] in #173
- feat(mpris): decouple from streaming and add full state sync by @higorprado in #172
- chore(deps): bump undici and wrangler in /worker-relay by @dependabot[bot] in #175
- fix: handle 5xx server errors with retry message in playback network by @LargeModGames in #178
- Mallformed request and asks for auth on every startup by @LargeModGames in #176
- Fix playback always starts from the first track of a playlist when using external device by @LargeModGames in #177
- chore(deps): bump rustls-webpki from 0.103.9 to 0.103.10 by @dependabot[bot] in #183
- chore(deps): bump tar from 0.4.44 to 0.4.45 by @dependabot[bot] in #182
- Fix panic hook to handle audio backend errors and improve error messaging by @LargeModGames in #184
- Fix playlist scrolling showing only one track on page boundary by @LargeModGames in #185
- Rename BasicView to LyricsView and add CoverArtView; update key bindings and handlers accordingly by @LargeModGames in #186
- chore(deps): bump tokio-tungstenite from 0.28.0 to 0.29.0 by @dependabot[bot] in #188
- chore(deps): bump rspotify from 0.14.0 to 0.16.0 by @dependabot[bot] in #187
New Contributors
- @Kathund made their first contribution in #149
- @domogami made their first contribution in #163
- @higorprado made their first contribution in #168
- @eiseq made their first contribution in #171
Full Changelog: v0.37.3...v0.38.0

chore: Bump version to 0.37.3 in Cargo.toml and Cargo.lock
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- feat: add startup behavior setting to control playback state on launch by @LargeModGames in #146
- feat: Add mouse support for playbar controls and refactor playback handling by @LargeModGames in #147
Full Changelog: v0.37.2...v0.37.3

chore: update changelog for silent auto-update feature and removal of in-app update prompt
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- Implement silent update check and installation on launch by @LargeModGames in #140
Full Changelog: v0.37.1...v0.37.2

chore(release): bump version to 0.37.1 and update changelog with new features and fixes
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- Fails to compile without the streaming feature by @wrsturgeon in #124
- docs: add wrsturgeon as a contributor for code, and bug by @allcontributors[bot] in #125
- fix(streaming): recover from portaudio panic on output device switch by @wfinken in #128
- docs: add wfinken as a contributor for code, and bug by @allcontributors[bot] in #132
- fix(macos): correct setActivationPolicy ObjC types (Mac Tahoe 26.2 build fix) by @wfinken in #134
- fix(macos): capability-aware Ctrl+, fallback for settings shortcut (fixes #35) by @wfinken in #135
- fix(macos-media): add album artwork to macOS Now Playing metadata by @wfinken in #136
- feat: queue view and party mode enhancements by @LargeModGames in #133
- chore(ci): bump the actions group with 2 updates by @dependabot[bot] in #129
- chore(deps): bump the rust-minor-updates group with 2 updates by @dependabot[bot] in #130
- Resizable sidebar by @LargeModGames in #138
New Contributors
- @wrsturgeon made their first contribution in #124
- @wfinken made their first contribution in #128
Full Changelog: v0.37.0...v0.37.1

chore: update supported version in security policy to 0.37
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- Implement new logging system by @AFE123x in #102
- docs: add AFE123x as a contributor for code, and bug by @allcontributors[bot] in #105
- Fixed formatting issues with rustfmt, and updated logs by @AFE123x in #106
- chore(deps): bump the rust-minor-updates group with 3 updates by @dependabot[bot] in #104
- Free account message by @LargeModGames in #107
- chore(deps): bump the rust-minor-updates group with 2 updates by @dependabot[bot] in #115
- add(nix): add flake.nix for nixos by @MaySeikatsu in #117
- docs: add MaySeikatsu as a contributor for code, doc, and platform by @allcontributors[bot] in #119
- Issue/10 macos media keys by @Vi1i in #120
- docs: add Vi1i as a contributor for code, and bug by @allcontributors[bot] in #121
- feat: show cover art next to song/episode title by @topongo in #111
- docs: add topongo as a contributor for code, and design by @allcontributors[bot] in #122
- Refactor by @LargeModGames in #123
New Contributors
- @AFE123x made their first contribution in #102
- @MaySeikatsu made their first contribution in #117
- @Vi1i made their first contribution in #120
- @topongo made their first contribution in #111
Full Changelog: v0.36.2...v0.37.0

feat: enhance streaming authentication process
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- feat: add vesper theme by @nthpaul in #98
- docs: add nthpaul as a contributor for design, and code by @allcontributors[bot] in #101
- feat: add and remove song from playlist by @nthpaul in #99
New Contributors
- @nthpaul made their first contribution in #98
Full Changelog: v0.36.1...v0.36.2

chore: bump version to 0.36.1 in Cargo.toml and Cargo.lock
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- Fixed Windows compilation bug introduced in v0.36.0 by @tylerdotrar in #97
New Contributors
- @tylerdotrar made their first contribution in #97
Full Changelog: v0.36.0...v0.36.1

v0.36.0: Spotify Feb 2026 API compatibility, PKCE auth, ncspot/fallback client setup, and rate-limit resilience
Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- fix: Search input horizontal scroll by @bodoque-01 in #95
Full Changelog: v0.35.7...v0.36.0

Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- fix(mpris): Fix position tracking and seeking by @El-Mundos in #85
- Improve playback controls by @El-Mundos in #86
- docs: add El-Mundos as a contributor for platform by @allcontributors[bot] in #88
- fix: handle help menu as a route to avoid closing the app on dismiss by @dpnova in #89
- docs: add dpnova as a contributor for code by @allcontributors[bot] in #91
- chore(deps): bump the rust-minor-updates group with 2 updates by @dependabot[bot] in #90
- Folders by @LargeModGames in #92
New Contributors
- @dpnova made their first contribution in #89
Full Changelog: v0.35.6...v0.35.7

Downloads
- On Windows 10/11 (64-bit) → spotatui-windows-x86_64.zip
- On Linux (Ubuntu, Arch, Fedora, etc.) → spotatui-linux-x86_64.tar.gz
- On macOS with Intel CPU → spotatui-macos-x86_64.tar.gz
- On macOS with Apple Silicon (M1/M2/M3) → spotatui-macos-aarch64.tar.gz
Checksums (.sha256) are optional and only needed if you want to verify the download.
To update use "spotatui update --install" or use your package manager of choice.
What's Changed
- chore(deps): bump discord-rich-presence from 1.0.0 to 1.1.0 in the rust-minor-updates group across 1 directory by @dependabot[bot] in #70
- fix: mark reqwest as mandatory dependency by @LordMZTE in #74
- chore(deps): bump clap from 4.5.54 to 4.5.56 in the rust-minor-updates group by @dependabot[bot] in #75
- docs: add LordMZTE as a contributor for code by @allcontributors[bot] in #77
- chore(deps): bump time from 0.3.45 to 0.3.47 by @dependabot[bot] in #78
- chore(deps): bump bytes from 1.11.0 to 1.11.1 by @dependabot[bot] in #79
- fix: solve slim-build-compilation error by @bodoque-01 in #81
- docs: add bodoque-01 as a contributor for code by @allcontributors[bot] in #83
- feat(mpris): Add album art URL to MPRIS metadata by @El-Mundos in #82
- docs: add El-Mundos as a contributor for code by @allcontributors[bot] in #84
New Contributors
- @LordMZTE made their first contribution in #74
- @allcontributors[bot] made their first contribution in #77
- @bodoque-01 made their first contribution in #81
- @El-Mundos made their first contribution in #82
Full Changelog: v0.35.5...v0.35.6