Spotty is a modern terminal user interface for Spotify, built with Rust. It brings playback control, library browsing, search, queue management, device transfer, and lyrics into a keyboard-driven TUI.

Spotty is an unofficial Spotify client and is not affiliated with Spotify AB.

🎧 Watch the full demo with audio

• Keyboard-first Spotify playback: play, pause, skip, volume, shuffle, and repeat.
• Library access for playlists, liked songs, saved albums, followed artists, and saved podcasts.
• Home view with top tracks, top artists, and recently played tracks.
• Search across tracks, artists, albums, and playlists.
• Queue view with live playback context.
• Device selector for transferring playback between Spotify Connect devices.
• Synced and unsynced lyrics support through Spotify metadata.

• A Spotify Premium account.
• A browser for OAuth authorization.

Go to the Releases page and download the archive for your platform:

Install the ALSA runtime library (required for audio):

# Debian / Ubuntu
sudo apt install -y libasound2

# Fedora / RHEL
sudo dnf install -y alsa-lib

# Arch
sudo pacman -S alsa-lib

Extract and run:

tar -xzf spotty-linux-x86_64.tar.gz
chmod +x spotty-linux-x86_64
./spotty-linux-x86_64

macOS includes all required audio libraries. Extract and run:

tar -xzf spotty-macos-aarch64.tar.gz
chmod +x spotty-macos-aarch64
./spotty-macos-aarch64

If macOS blocks the binary because it is from an unidentified developer, remove the quarantine flag:

xattr -d com.apple.quarantine spotty-macos-aarch64

No additional dependencies are required. Extract spotty-windows-x86_64.exe.zip and run from PowerShell:

.\spotty-windows-x86_64.exe

If Windows Defender SmartScreen blocks the binary, click More info → Run anyway.

When you first launch Spotty, it will open your browser and redirect you to Spotify's login page. After logging in, Spotify redirects back to the app automatically. Your credentials are then cached locally, so you won't need to log in again on future launches.

Use ? inside Spotty to open the in-app help popup.

Open quick actions with g, then press t to transfer playback.

Linux (Debian / Ubuntu)

sudo apt install -y libasound2-dev pkg-config libssl-dev

Linux (Fedora / RHEL)

sudo dnf install -y alsa-lib-devel pkg-config openssl-devel

macOS — install Xcode Command Line Tools if you haven't already:

xcode-select --install

Windows — install Visual Studio Build Tools with the Desktop development with C++ workload selected.

Install Rust from rustup.rs, then:

git clone https://github.com/vquclinh/spotty.git
cd spotty

cargo run              # run in debug mode
cargo run --release    # run optimized
cargo build --release  # build binary to target/release/spotty
cargo check            # type-check without building
cargo fmt              # format code
cargo clippy           # lint

src/
  app/        Application state, routes, and view models
  audio/      Librespot authentication, player, and audio events
  event/      Event primitives
  handlers/   Keyboard handlers by view
  network/    Spotify API client, requests, and response models
  ui/         Layouts, widgets, popups, and rendering
  lib.rs      Application bootstrap and main event loop
  main.rs     Binary entrypoint

• Vo Quoc Linh (vquclinh)
• Nguyen Thanh Nhat (night0)

MIT