A lightweight mutliplatform CLI for Spotify
brew install dvdmuckle/tap/spc
sudo add-apt-repository ppa:dvdmuckle/spc
sudo apt-get update
sudo apt-get install spc
sudo dnf copr enable dvdmuckle/spc
sudo dnf install spc
Download one of the releases and unarchive the spc
binary somewhere in your PATH
. Alternatively, download and install with:
go install github.com/dvdmuckle/spc@latest
Make sure $GOPATH/bin
is in your PATH
for this to work.
To set up the app, run spc config
to generate a skeleton config file at ~/.config/spc/config.yaml
or .config/spc/config.yaml
in your user directory on Windows.
Next, head to http://developer.spotify.com/dashboard to create a new Spotify app. Make sure to set a callback URL for http://localhost:8888/callback
. Paste the ClientID and ClientSecret in the newly created config file as noted in the file. Make sure the ClientSecret is base64 encoded.
You can now run spc auth
to start the OAuth2 flow, which will have you grant the Spotify app you created, and thus spc
, the correct API permissions.
This app requires a Spotify Premium account for any commands involving playback.
Check out either spc help
or the docs pages for help on how to use spc
.
The goal of this project is to present a simple, lightweight command line interface for Spotify, inspired by spotify-tui. Support for play, pause, volume, and a simple search are all that are considered right now. Saving of autogenerated playlists are as complicated as this project will get at this time.
For feature requests, feel free to create an issue or submit a PR with your changes. To take on an open issue, either submit a PR referencing the issue number, or ask to be assigned the issue in question in the issue comments.