# README
spotify-cli
About
A (barebones) Spotify CLI, done for Hackweek at Instructure, in Go.
Currently, supports searching for tracks and artists, browsing and playing the current user's playlists, adjusting playback state (play, pause, next, previous), and transferring playback to another device.
Installation
To install from source, a working Go installation and a registered Spotify application is required. See the Go website for instructions on how to download the latest version of Go. To register an application with Spotify, visit their website.
You'll get an client ID and a secret key for your app. Store this information in the SPOTIFY_ID and SPOTIFY_SECRET environment variables so that the application can take actions on your behalf. If you want a method to securely store and access this info, which you really should, see Vaulted.
Once that's done, clone the repo:
git clone github.com/Hawkbawk/spotify-cli
Then, move into the directory and run go install:
cd spotify-cli && go install
From there, assuming you have your GOBIN environment variable set, simply run
spotify-cli
from any bash terminal to start the command line application. Use
the arrows keys or VIM movement keys to select an option, "/" to search
(on menu's that support it), and enter to confirm. That's it! You're ready to
control your Spotify experience, all from the command line.
Note
It's important to note that you have to have a version of the Spotify app running on one of your devices, as Spotify's Web API doesn't currently support directly streaming tracks to a registered application, which is fair, but still no fun for developers who just want to tinker.
Reporting Bugs & Requesting Features
This is a Hackweek project, so bugs are fully expected. This was written in a week after all, during an internship no less. However, feel free to submit any bug reports/feature requests on the project's GitHub page. If you even want to try fixing the bug you notice, go ahead and submit a pull request!