A simple Spotify CLI made with Click and Spotipy
This was done as a personal exercise in making CLIs. It's inspired by shpotify which is available for MacOS.
pip install spty
Alternatively, you can fork the repo if you wish to play around with it.
This is optional, but enabling tab completion will let you explore and issue commands faster without having to consult --help.
For zsh:
_SPTY_COMPLETE=source_zsh spty >> ~/.zshrc
For bash:
_SPTY_COMPLETE=source_bash spty >> ~/.bashrc
spty does not communicate with your local Spotify app directly but rather over API calls. It's a remote controller. As a prerequisite, you'll have to "create" a Spotify app at Spotify for Developers.
See their App Settings guide for more instructions. Note that your app's name and description doesn't matter as much for this CLI.
A spotify app must be running before the CLI can be used.
spty Show all commands
spty config (Re)configure your Spotify app values
spty play Play or resume playback
spty play TRACK Find a track and play it
spty play album ALBUM Find an album and play it
spty play artist ARTIST Find an artist and play its discography
spty play list PLAYLIST Find a playlist and play it
spty pause Pause the playback
spty stop Stop the playback
spty replay Replay the current song
spty next Skip to the next song
spty previous (prev) Play the previous song
spty fast-forward (ffwd) Fast-forward by SECONDS (10 by default)
spty rewind (rew) Rewind by SECONDS (10 by default)
spty seek Play current song at TIMESTAMP (e.g. 1:30)
spty vol Show current volume
spty vol up Increase volume by 10
spty vol down Decrease volume by 10
spty vol PERC Set volume to PERC (0-100)
spty repeat Set repeat mode (track, context, or off)
spty shuffle Toggle shuffle or explicitly turn it on/off
spty status Show playback status
spty status track Show track title
spty status title Show album title
spty status artist Show artist/s
spty status -v Show playback status, including shuffle and repeat state
spty share Show the current song's url and uri
stpy share url Show the current song's url
stpy share uri Show the current song's uri