← Back to Repository

𝄞 Cue - CLI Spotify Controller

Unified CLI Spotify controller with intelligent session management

Control your Spotify playbook from anywhere with timed sessions, contextual modes, auto-server management, and network support. Features include queue management, device switching, volume control, and comprehensive playback history.

📦 Installation Options

RHEL/CentOS/Rocky/Alma/Fedora
🚀 RPM Install
# Add repository
sudo dnf config-manager --add-repo https://repos.musicsian.com/musicsian.repo # Install package
sudo dnf install cue # Set up Spotify credentials
export SPOTIFY_CLIENT_ID="your_client_id"
export SPOTIFY_CLIENT_SECRET="your_client_secret" # Try it out - focus mode for 2 hours
cue focus 2h
📂 Browse Files ⬇️ Download .repo 📦 Direct RPM
Arch Linux
🏛️ AUR Package Available
# Install using yay
yay -S spotify-cue # Or using paru
paru -S spotify-cue # Set up Spotify credentials
export SPOTIFY_CLIENT_ID="your_client_id"
export SPOTIFY_CLIENT_SECRET="your_client_secret" # Try it out - focus mode for 2 hours
cue focus 2h
🏛️ View AUR Page 📄 View PKGBUILD

Full Usage Documentation

Cue - CLI Spotify Controller Control Spotify playback over the network with timed sessions. Examples: cue play "song name" # Play full track cue play "song name" 2h # Play for 2 hours cue play album "Abbey Road" # Play an entire album cue focus 1h # Start focus mode cue status # Check what's playing Commands: play Play music for a specified duration status Show current playback status stop Stop current playbook skip Skip to next track in queue health Check server health and connection queue Manage playback queue mode Manage playback modes volume Volume control device Device control focus Start focus mode for concentration (default: 2h) party Start party mode (default: 3h) workout Start workout mode (default: 1h) sleep Start sleep mode (default: 45m) morning Start morning mode (default: 30m) chill Start chill mode (default: 1h) history Show playback history config Configure client settings Play Command: cue play "song name" # Play full track cue play "song name" 2h # Play for 2 hours Or use subcommands for specific content types: cue play playlist "Chill Vibes" # Play full playlist cue play album "Dark Side of the Moon" 45m cue play artist "Bon Iver" # Play all top tracks cue play genre jazz # Continuous jazz Options: -h, --help show this help message and exit --version show the version number and exit Server Management: --server-stop Stop background server --server-status Show server status --server-logs Show server logs --server Run in server mode