Skip to main content

# spoppy Lightweight Spotify Command-Line interface for Linux [![Build Status](https://travis-ci.org/sindrig/spoppy.svg?branch=master)](https://travis-ci.org/sindrig/spoppy)

## Requirements

Python 2.7 or Python 3.3+

See requirements.txt for required python packages. They will be automatically installed when you install via pip.

You will need a Spotify Premium account and a Spotify username (if you signed up via Facebook you can [follow the instructions here](https://community.spotify.com/t5/Help-Accounts-and-Subscriptions/How-do-i-find-my-username-when-using-Facebook-login/td-p/859795) to get your username).

You will need libspotify, pyaudio or pyalsaaudio, and libffi-dev installed.

You will either need to install pyaudio or alsaaudio by (pyaudio instructions [Here](https://people.csail.mit.edu/hubert/pyaudio/) and pyalsaaudio instructions [here](http://larsimmisch.github.io/pyalsaaudio/pyalsaaudio.html#installation)).

Use your distribution’s package manager for libffi-dev (f.x. apt-get install libffi-dev).

To install libspotify, see [Pyspotify installation](https://pyspotify.mopidy.com/en/latest/installation/#install-from-source). (Archives are available at [libspotify-archive](https://mopidy.github.io/libspotify-archive/)), thanks to the great guys at [Mopidy](https://www.mopidy.com/)!.

For DBus integration you’ll need python-dbus and python-gobject2. Use your distribution’s package manager. Spoppy will work without these packages but won’t expose it’s DBus procedures.

## Installation

pip install spoppy

To install globally you will probably need superuser privileges.

After installation run spoppy in your terminal and you’re all set!

## Screenshots

### Top menu ![Top menu](/screenshots/top_menu.png?raw=true “Top menu”) ### Playlist overview ![Playlist overview](/screenshots/playlist_overview.png?raw=true “Playlist overview”) ### Playlist ![Playlist](/screenshots/playlist.png?raw=true “Playlist”) ### Player view ![Player](/screenshots/player.png?raw=true “Player”) ### Player operations ![Player operations](/screenshots/player_operations.png?raw=true “Player operations”) ### Search results ![Search results](/screenshots/search_results.png?raw=true “Search results”) ### Certain artists can be banned ![Banned artists](/screenshots/banned_artist.png?raw=true “Banned artists”) ### Operations on a specific song ![Song info](/screenshots/song_info.png?raw=true “Song info”)

## Development

  1. Create a virtualenv (python 2.7 or python 3.3+)

  2. Clone this project

  3. Activate your virtualenv

  4. Install requirements (pip install -r requirements.txt)

  5. Run python scripts/spoppy (you will be asked for username/password)

## DBus integration

  1. Run make install_dbus

  2. Make sure you have python-gobject2 installed

  3. Symlink gi (and possibly glib) to your virtualenv (that is, if you’re not installing globally!)

  4. The service will be available at “/com/spoppy” (f.x. qdbus com.spoppy /com/spoppy com.spoppy.PlayPause)

## Debugging

To enable verbose logging, set the SPOPPY_LOG_LEVEL environment variable to ‘DEBUG’.

## Testing

make test

Metadata

Release files for spoppy 2.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for spoppy 2.4.0
File Size Uploaded
spoppy-2.4.0.tar.gz 40.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for spoppy 2.4.0
File Interpreter ABI Platform
spoppy-2.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 77.4 kB

Release files / spoppy-2.4.0.tar.gz

Download URL spoppy-2.4.0.tar.gz
Size 40.1 kB
Tags Source
SHA-256 checksum
How to use checksums
beea965614bb2a0de7e98d95e20b10687521e2913f77c37cb9669085224e29b1
BLAKE2b-256 checksum
How to use checksums
e3a12d34bc8c8a43c3f2c02cdc998ebb5fd937c2c33e86f06381b3a77099fdf4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.2

Release files / spoppy-2.4.0-py3-none-any.whl

Download URL spoppy-2.4.0-py3-none-any.whl
Size 37.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2e6d69696e8fd6fb0ce1f3cda7c6f067b4b1b8bcdfd9dc0a658a52a2c792ac10
BLAKE2b-256 checksum
How to use checksums
a47a9b11f5866ecc38963508ed706c819b290c5390d1392f082a1ba7d93d2ec6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.2

Release history Release notifications | RSS feed

This release

2.4.0 This release

2 release files

2.3.9

2 release files

2.3.8

2 release files

2.3.7

2 release files

2.3.6

2 release files

2.3.5

1 release file

2.3.4

1 release file

2.3.3

1 release file

2.3.2

1 release file

2.3.1

1 release file

2.3.0

1 release file

2.2.1

1 release file

2.2.0

1 release file

2.1.5

1 release file

2.1.4

1 release file

2.1.3

1 release file

2.1.2

1 release file

2.1.1

1 release file

2.1.0

1 release file

2.0.3

1 release file

2.0.2

1 release file

2.0.1

1 release file

2.0.0

1 release file

1.10.3

1 release file

1.10.2

1 release file

1.10.1

1 release file

1.10.0

1 release file

1.9.3

1 release file

1.9.2

1 release file

1.9.1

1 release file

1.9.0

1 release file

1.8.1

1 release file

1.7.5

1 release file

1.7.4

1 release file

1.7.3

1 release file

1.7.2

1 release file

1.7.1

1 release file

1.7.0

1 release file

1.6.1

1 release file

1.6.0

1 release file

1.5.2

1 release file

1.5.1

1 release file

1.5.0

1 release file

1.4.6

1 release file

1.4.5

1 release file

1.4.4

1 release file

1.4.3

1 release file

1.4.2

1 release file

1.4.1

1 release file

1.4.0

1 release file

1.3.1

1 release file

1.3.0

1 release file

1.2.2

1 release file

1.2.1

1 release file

1.2.0

1 release file

1.1.0

1 release file

1.0.2

1 release file

1.0.1

1.0.0

1 release file

0.2.2

1 release file

0.2.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page