Browse your playlists and library

View and play your saved tracks

• Bun >= 1.0.0
• Spotify Premium account
• Linux x64 only (uses D-Bus/MPRIS for media control, not available on macOS/Windows)

# Just run it (no install needed)
bunx openspot-tui@latest

Or install globally:

bun add -g openspot-tui
openspot-tui

Note: If openspot-tui command is not found after global install, add Bun's bin folder to your PATH:

# For zsh (add to ~/.zshrc)
export PATH="$HOME/.cache/.bun/bin:$PATH"

# For bash (add to ~/.bashrc)
export PATH="$HOME/.cache/.bun/bin:$PATH"

git clone https://github.com/iiviie/openspot-tui.git
cd openspot-tui
bun install
bun start

The install script automatically downloads spotifyd on first run.

openspot-tui

On first run, spotifyd will be downloaded automatically if not found.

Then you need to authenticate:

1. Press Ctrl+P to open the command palette
2. Select Login to Spotify - a browser opens for authorization
3. After authorizing, press Ctrl+P again
4. Select Authenticate Spotifyd - another browser authorization

Once both are complete, you are ready to listen to music.

Select a track in the content panel and press f to add it to your queue. The queue appears in the left sidebar below the library menu.

Press ? to view all keyboard shortcuts.

Press q to quit.

Press Ctrl+P to access commands:

Make sure both authentications are complete:

1. Ctrl+P -> Login to Spotify
2. Ctrl+P -> Authenticate Spotifyd

bun logout
bun start

Then authenticate again via the command palette.

If the automatic download failed, install manually:

# Arch Linux
pacman -S spotifyd

# macOS
brew install spotifyd

Or download from spotifyd releases.

bun dev          # Run in watch mode
bun tsc --noEmit # Type check

• Bun - JavaScript runtime
• @opentui/core - Terminal UI framework
• spotifyd - Spotify Connect daemon for audio playback
• dbus-next - D-Bus bindings for MPRIS control
• Zod - Schema validation

MIT