🎶 A command-line interface to Spotify on Linux
Python Makefile Shell
Switch branches/tags
Nothing to show
Clone or download



A command-line interface to Spotify on Linux.

This project is inspired by the similar project called shpotify, which does similar things, but on macOS.

View this project on PyPi at https://pypi.org/project/spotify-cli-linux/.


with pip (recommended):

pip install spotify-cli-linux

with wget:

sh -c "$(wget https://raw.githubusercontent.com/pwittchen/spotify-cli-linux/master/install.sh -O -)"

with curl:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/pwittchen/spotify-cli-linux/master/install.sh)"


run the following command from your terminal:


use one of the following parameters:

--help, -h          shows help
--version, -v       shows version
--status            shows status (song name and artist)
--status-short      shows status in a short way
--play              plays the song
--pause             pauses the song
--playpause         plays or pauses the song (toggles a state)
--next              plays the next song
--prev              plays the previous song
--volumeup          increases sound volume
--volumedown        decreases sound volume

solving problems

When you've seen the following error:

No module named dbus

Then try to install python-dbus! On Ubuntu you can do it as follows:

sudo apt-get install python-dbus

If you are using another distro, then try to install python-dbus with your package manager.

usage with tmux

If you want to use this script in your tmux panel, you can check tmux-plugin-spotify.

code formatting

Source code should be formatted according to PEP8 style guides.

Install autopep8 and pycodestyle as follows:

pip install --upgrade autopep8
pip install --upgrade pycodestyle

Then run:

make format

to verify code formatting, type:

make check_format


configure your ~/.pypirc file as follows:

index-servers =

next, install twine:

pip install twine

then, update version in setup.py file and use wrapper in a Makefile:

make dist
make release
make clean