Control Spotify through the OS X Terminal, also over ssh
Latest commit 9d92e78 Aug 23, 2016 @dronir committed on GitHub Merge pull request #21 from mahi97/master
minor bug fix
Failed to load latest commit information. update readme Aug 22, 2016
SpotifyControl minor bug fix Aug 23, 2016

Control Spotify at OS X Terminal

An AppleScript for controlling Spotify through a terminal:

The scenario for which it was originally designed is controlling Spotify,
which is playing on a Mac, via ssh, while working on a Linux machine 
on the other side of the room.

Currently supported functions are: play/pause, next/previous track, jumping in time, toggling shuffle/repeat and changing volume. This pretty much covers everything the AppleScript hooks of Spotify allow.

Tested Platforms (Spotify

  • OS X El Captian (10.11)
  • OS X Yosemite (10.10)
  • OS X Mavericks (10.9)
  • OS X Mountain Lion (10.8)
  • OS X Lion (10.7)


The simplest way to install the script is to clone the repository, cd into repository's directory, and run this command below to make a symbolic link into /usr/local/bin/:

ln -s $(pwd)/SpotifyControl /usr/local/bin/spotify


  • To start Spotify playback, type spotify start or spotify play. If you do this locally and Spotify is not running, it will start. Remotely, Spotify will not start properly. Optionally, pass a Spotify URI as a second argument.
  • To pause Spotify playback, type spotify stop or spotify pause.
  • To toggle playback, type spotify play/pause.
  • To go to the next track, type spotify next.
  • To go to the previous track, type spotify previous or spotify prev.
  • To print information about the currently playing track, type spotify info
  • To jump to a particular time in the track, type spotify jump N, where N is the track position in seconds.
  • To fast forward, type spotify forward N where N is the number of seconds to jump ahead.
  • To rewind, type spotify rewind N where N is the number of seconds to jump backwards.
  • To change volume, type spotify volume N where N is a number between 0 and 100.
  • Increase volume, type spotify increasevolume N where N is a number between 0 and 100 that you want to increment by.
  • Decrease volume, type spotify decreasevolume N where N is a number between 0 and 100 that you want to decrement by.
  • To toggle shuffle, type spotify shuffle.
  • To toggle repeat, type spotify repeat.
  • To show a list of these commands, just type spotify.

Over SSH

To enable the SSH server on OS X, go to Sharing in the System Preferences and enable Remote Login. The Sharing screen will also then tell you the command to use to connect to your Mac in the local network.


You may use, adapt, modify, and etc. Any way you want.