Skip to main content

A lightweight spotify CLI

Project description

# 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spoppy-2.4.0.tar.gz (40.1 kB view details)

Uploaded Source

Built Distribution

spoppy-2.4.0-py3-none-any.whl (37.4 kB view details)

Uploaded Python 3

File details

Details for the file spoppy-2.4.0.tar.gz.

File metadata

  • Download URL: spoppy-2.4.0.tar.gz
  • Upload date:
  • Size: 40.1 kB
  • Tags: Source
  • Uploaded using 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

File hashes

Hashes for spoppy-2.4.0.tar.gz
Algorithm Hash digest
SHA256 beea965614bb2a0de7e98d95e20b10687521e2913f77c37cb9669085224e29b1
MD5 8f357c12bbc1a03c8e9d77cef992d681
BLAKE2b-256 e3a12d34bc8c8a43c3f2c02cdc998ebb5fd937c2c33e86f06381b3a77099fdf4

See more details on using hashes here.

File details

Details for the file spoppy-2.4.0-py3-none-any.whl.

File metadata

  • Download URL: spoppy-2.4.0-py3-none-any.whl
  • Upload date:
  • Size: 37.4 kB
  • Tags: Python 3
  • Uploaded using 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

File hashes

Hashes for spoppy-2.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2e6d69696e8fd6fb0ce1f3cda7c6f067b4b1b8bcdfd9dc0a658a52a2c792ac10
MD5 8f1b6f2aad9ee128761a5478a862ad79
BLAKE2b-256 a47a9b11f5866ecc38963508ed706c819b290c5390d1392f082a1ba7d93d2ec6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page