Installation

Quick Install

Cargo (Recommended)

If you have Rust installed:

cargo install spotatui

Pre-built Binaries

Download from GitHub Releases:

Platform	File
Windows 10/11 (64-bit)	spotatui-windows-x86_64.zip
Linux (Ubuntu, Arch, Fedora, etc.)	spotatui-linux-x86_64.tar.gz
macOS (Intel)	spotatui-macos-x86_64.tar.gz
macOS (Apple Silicon M1/M2/M3)	spotatui-macos-aarch64.tar.gz

Checksums (.sha256) are provided if you want to verify the download.

Arch Linux (AUR)

yay -S spotatui
# or
paru -S spotatui

---

Platform-Specific Requirements

Linux

For audio visualization, you need PipeWire installed:

# Debian/Ubuntu
sudo apt-get install libpipewire-0.3-0

# Arch Linux (already included with pipewire)
sudo pacman -S pipewire

# Fedora (already included with pipewire)
sudo dnf install pipewire

Note: Most modern Linux distributions already have PipeWire installed by default.

macOS

spotatui uses the portaudio backend for better stability and bluetooth device support (AirPods, etc.):

brew install portaudio

---

Building from Source

Ensure you have Rust installed.

Prerequisites

macOS:

brew install portaudio

Linux (Debian/Ubuntu):

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

Linux (Arch):

sudo pacman -S openssl alsa-lib pkg-config

Linux (Fedora):

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

Build

git clone https://github.com/LargeModGames/spotatui.git
cd spotatui

macOS:

cargo install --path . --no-default-features --features telemetry,streaming,portaudio-backend,audio-viz-cpal

Linux/Windows:

cargo install --path .

Nix:

nix-build

---

Updating

When a new version is available, you'll see a popup notification on startup. To update:

1. Close spotatui
2. Run:

   spotatui update --install
   

If you installed via a package manager (AUR, cargo, etc.), update through there instead.

---

Connecting to Spotify

spotatui needs to connect to Spotify's API. Instructions are shown when you first run the app.

1. Go to the Spotify Dashboard
2. Click Create an app
3. Note your Client ID and Client Secret
4. Click Edit Settings
5. Add these Redirect URIs:
   • http://127.0.0.1:8888/callback (API authentication)
   • http://127.0.0.1:8989/login (native streaming)
6. Save and run spotatui