Skip to content

dvdmuckle/spc

Repository files navigation

spc

Go rpmbuild Ubuntu

A lightweight mutliplatform CLI for Spotify

Installation

macOS

brew install dvdmuckle/tap/spc

Ubuntu Linux

sudo add-apt-repository ppa:dvdmuckle/spc
sudo apt-get update
sudo apt-get install 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 install github.com/dvdmuckle/spc@latest

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 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.

Running

Check out either spc help or the docs pages for help on how to use spc.

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. Saving of autogenerated playlists are as complicated as this project will get at this time.

Contributing

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.