Spotr - A spotify tool for the terminal

A very simple CLI for controlling your spotify on the fly in the terminal. Made in python for simplicity

Debug

Argparser

Installation

$ pip install spotrpy

Or clone the repo and install locally

$ pip install -e .

2. Register an app in spotify for developers "https://developer.spotify.com/dashboard/applications"

   • Also set callback URI to "https://www.google.com/"

3. Run any spotr command (If command is not recognized check if python bin is in PATH)

4. You will be prompted to create config.json and paste in client and secret id from spotify app

5. After these steps everything should work and you can enjoy spotr

Built-in Commands

auth                Authorize Spotify api
authorize           Authorize Spotify api
artist              Display artist information
ascii               Ascii image for current track
current             Display information about the currently playing track
next                Play next track
playback            Set playback state
playlist            Start playing one of your playlists
playlistadd         Add currently playing track to a playlist
previous            Play previous track
qsearch             Quicksearch for tracks
queue               Display current queue
recent              Select one of recently played tracks
recommend           Play random / recommended tracks based on recent tracks
replay              Replay/Restart currently playing track
search              Search for anything on spotify, Types - track, playlist, album
seek                Seek posistion for track (in seconds)
shuffle             Toggle shuffle, on / off
start               Start/resume playing
resume              Start/resume playing
stop                Stop/Pause playing
pause               Stop/Pause playing
volume              Ajust volume
vol                 Ajust volume
web                 Open currently playing track in a broswer

Modifications

Commands are declared in commands.py, Then you can set any function or class-method as callable.

API documentation