spc

A lightweight mutliplatform CLI for Spotify

Installation

macOS

brew install dvdmuckle/tap/spc

Fedora Linux

sudo dnf copr enable dvdmuckle/spc
sudo dnf install spc

Other Platforms

Download one of the releases and unarchive the spc binary somewhere in your PATH. Alternatively, download and install with: go get -u github.com/dvdmuckle/spc Make sure $GOPATH/bin is in your PATH for this to work.

Setup

To set up the app, run spc config to generate a skeleton config file at ~/.config/spc/config.yaml. Next, head to http://developer.spotify.com/ 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 config as noted. 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 in order to interact with the API.

Running

Because this app is in constant development, please refer to spc help for what functionality is available in the app.

Goals

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. The roadmap may change in the future.

Roadmap

Feature	Implemented yet?	Essential?
Auth	Yes	Yes
Switch Device	Yes	No
Play	Yes	Yes
Pause	Yes	Yes
Toggle playback	No	No
Search	Yes	Yes
Volume	Yes	Yes
Status	Yes	Yes
Skip Track	Yes	Yes
Previous Track	Yes	Yes
Config	Yes	No
Seek	Yes	No

Contributing

For feature requests, feel free to create an issue or creating a PR changing the above roadmap.

collenirwin/spc

spc