Spotify TUI

A brutalist terminal interface for controlling Spotify on macOS.

███████╗██████╗  ██████╗ ████████╗
██╔════╝██╔══██╗██╔═══██╗╚══██╔══╝
███████╗██████╔╝██║   ██║   ██║   
╚════██║██╔═══╝ ██║   ██║   ██║   
███████║██║     ╚██████╔╝   ██║   
╚══════╝╚═╝      ╚═════╝    ╚═╝   

Features

• Now Playing — Control playback, see track info and progress
• Playlists — Browse your playlists (requires OAuth)
• Queue — See what's coming up next
• Liked Songs — Browse your saved tracks
• Search — Tracks, playlists, and artists (requires OAuth)
• Devices — Switch playback device (requires OAuth)
• Brutalist Design — Heavy borders, ALL CAPS, terminal green

Installation

From Source

git clone https://github.com/YOUR_USERNAME/spotify-tui.git
cd spotify-tui
go build -o spotify-tui cmd/tspot/main.go
./spotify-tui

Homebrew

brew tap Wondr-design/tap
brew install spotify-tui

Usage

./spotify-tui

Development

make hooks   # enforce commit messages + run tests before push
make ci      # vet + test

Keyboard Shortcuts

Key	Action
1	Now Playing
2	Playlists
3	Queue
4	Liked Songs
?	Help
Space	Play / Pause
n / →	Next track
p / ←	Previous track
j / k	Navigate lists
+ / -	Volume up/down
/	Search
d	Devices
s	Shuffle
r	Repeat mode
u	Check updates
a	Authenticate
esc / b	Back
q	Quit

OAuth Setup (Optional)

To access Playlists, Queue, Liked Songs, Search, and Devices:

1. Run spotify-tui
2. Press c to open the in-app setup guide (or run spotify-tui --setup)
3. Follow the prompts to paste your Client ID and authenticate

Requirements

• macOS
• Spotify Desktop app installed
• Go 1.21+ (for building from source)

License

MIT

spotify