spo-cli

a spotify tui app, less is more

need: Spotify Premium

2026-10-04.01-07-53.mp4

Feature

os: linux (relying heavily on various features of Linux,not support windows and macOS, btw, I use arch linux)

• Simplicity
• Lightweight
• Barrier-free
• Quick start and lazy load
• Vim key, mouse
• Animations
• Hot reload config
• Lyrics with autoscroll
• Image render
• Desktop notification
• Async and coroutine
• Custom themes
• Adaptive screen

install

yay -S spo-cli

or

yay -S spo-cli-bin

login spotify

api

spotify-web-api

oAuth

Authorization Code PKCE Flow

client_id login_redirect_uri

Rate Limits

access token

lyrics

Genius

build

requirements

• cmake >= 4.4
• clang >= 23
• linux >= 6.1
• openssl
• liburing

touch default.toml

cmake -B build -G Ninja
ninja -C build
./build/spo-cli

test

option(SPOCLI_TEST ON)

./build/spo-test

Inspiring by

• lrxed
• jellyfin-tui
• termusic
• ytui-music.git
• spotify-player
• go-musicfox
• kew
• myx