Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/owenthereal/spotctl
A command-line interface to Spotify, written in Go
https://github.com/owenthereal/spotctl
cli golang spotify
Last synced: about 2 months ago
JSON representation
A command-line interface to Spotify, written in Go
- Host: GitHub
- URL: https://github.com/owenthereal/spotctl
- Owner: owenthereal
- License: mit
- Created: 2017-12-21T06:00:01.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-06-28T21:41:47.000Z (over 6 years ago)
- Last Synced: 2024-12-11T12:12:03.415Z (2 months ago)
- Topics: cli, golang, spotify
- Language: Go
- Size: 3.48 MB
- Stars: 243
- Watchers: 8
- Forks: 16
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Spotctl
`spotctl` is command-line interface to control Spotify from your favorite terminal.
## Demo
One of the highlights is that `spotctl player` shows a real-time Spotify player that allows you to control it, right in your terminal!
[](https://asciinema.org/a/154262)
## Installation
## Homebrew
If you're on a Mac, you can install with [Homebrew](https://brew.sh/):
```
brew install https://raw.githubusercontent.com/jingweno/spotctl/master/Formula/spotctl.rb
```
## Download
You can download the latest release for your operating system [here](https://github.com/jingweno/spotctl/releases).
## Manual Installation
`spotctl` needs to connect to Spotify's API in order to control it.
To manually build it, you first need to sign up (or into) Spotify's developer site and [create an Application](https://developer.spotify.com/my-applications/#!/applications/create).
Once you've done so, you can find its Client ID and Client Secret values and run the following command:
```
SPOTIFY_CLIENT_ID=XXX SPOTIFY_CLIENT_SECRET=YYY ./bin/build
```
## Running
**Please make sure the Spotify app is opened before running any `spotctl` commands**, since it talks to the Spotify API which in turns talks to the Spotify app in your local box.
Here is a list of available commands:
```
$ spotctl -h
A command-line interface to Spotify.
Usage:
spotctl [command]
Available Commands:
help Help about any command
login Login with your Spotify credentials
logout Clear your local Spotify credentials
next Skip to the next track
pause Pause Spotify playback
play Resume playback or play a track, album, artist or playlist by name
player Show the live player panel
prev Return to the previous track
repeat Toggle repeat playback mode
shuffle Toggle shuffle playback mode
status Show the current player status
version Show version.
vol Set or return volume percentage
Flags:
-h, --help help for spotctl
Use "spotctl [command] --help" for more information about a command.
```
## License
[MIT](https://github.com/jingweno/spotctl/blob/master/LICENSE)