ciembor/spotify-cmd

Command line Spotify client

📻 spotify-cmd v0.1.4

spotify-cmd is a Spotify client that allows controlling the playback of albums and playlists from a user's library (based on names or Spotify URIs) and individual tracks (based solely on Spotify URIs). The application is intended for use with spotifyd, but it works with any Spotify-enabled device.

Installation

Ensure you have Python 3 installed. Package is available on PyPi: https://pypi.org/project/spotify-cmd/. Install it using pip3:

pip3 install spotify-cmd

Configuration

The application configuration should be located in ~/.config/spotify-cmd/config.ini. Below is a detailed guide on each configuration option:

[SPOTIFY]
client_id = your_client_id
client_secret = your_client_secret
device_name = your_device_name
redirect_uri = http://localhost:8888/callback

[SPOTIFY_CMD_DAEMON]
socket_path = /tmp/spotify-cmd-daemon.sock
socket_buffer_size = 1024

• client_id, client_secret are required. Obtain these by creating an app at the Spotify Developer Dashboard.
• device_name is required. spotify-cmd-daemon will force to use it even if other is currently active.
• redirect_uri is used for Spotify authentication. If not set, it defaults to 'http://localhost:8888/callback'.
• socket_path specifies the Unix socket path for the daemon. Defaults to '/tmp/spotify-cmd-daemon.sock'.
• socket_buffer_size defines the buffer size for socket communication. Defaults to 1024.

Commands

spotify-cmd offers the following commands:

• get playlists: Lists the user's playlists.
• get albums: Lists the user's albums.
• play playlist <name>, play album <name>, play uri <spotify_uri>: Plays a specific playlist, album, or resource by Spotify URI.
• play, pause, next, previous: Controls playback.
• set shuffle <on|off>: Toggles shuffle mode.
• set volume <0-100>: Sets the volume level.
• find <search_type> <query>: Searches for items on Spotify. Acceptable search types are album, artist, playlist, track, episode, and show.

Output Format

Select output format using the --format flag:

• --format text: Plain text output (default).
• --format json: Output in JSON format.
• --format verbose: Verbose text information.

Usage Examples

spotify-cmd get albums
spotify-cmd get playlists
spotify-cmd play album "Listening Tree"
spotify-cmd play playlist "Discover Weekly"
spotify-cmd play uri spotify:album:5zKTfU3vyuZfLgtYRfJyza
spotify-cmd find artist "Nils Frahm"

For Developers

Developers can create interfaces for spotify-cmd-daemon using /tmp/spotify-cmd-daemon.sock. Socket handling and data format details are in the ./src/common directory (there is no documentation).

Planned Features and Upcoming Development

• Displaying tracks from specific albums or playlists.
• MPRIS D-Bus interface support to reduce server queries.
• spotify-cmd-ui: A ncurses-based UI for track display and control, working with the same daemon.
• Search functionality. [Done in 0.1.4]
• Support for other resource types like artists.
• Config instructions after installation / creation of default config.

License

This project is licensed under the terms of the GNU General Public License. Detailed information can be found in the LICENSE.md file.

Author

Project created by Maciej Ciemborowicz.