lazyspotify: Your Terminal Spotify Client

lazyspotify is a command-line interface for Spotify, designed specifically for macOS and Linux users. This lightweight terminal client provides a robust solution for managing and enjoying your Spotify music library directly from the command line.

Key Features

• Control Spotify Seamlessly: Play tracks, navigate libraries, and enjoy full playback controls without leaving the terminal.
• Simple Setup: Requires a Spotify Premium account and a few straightforward configurations to get started.
• User-Friendly Configuration: Customize your client with an intuitive config.yml file, allowing for easy management of settings, including your Spotify client ID.
• Rich Functionality: Includes support for clipboard interactions, playlist management, and various other features that enhance usability.

Requirements

To use lazyspotify, ensure the following components are in place:

• A Spotify Premium account.
• A functioning system keyring if required for authentication.
• The patched lazyspotify-librespot daemon, primarily if building from source.

Usage Demonstrations

Visualize the features of lazyspotify with these intuitive demos:

• Play a Track from a Playlist:
• Player Controls:
• Library Navigation:
• Search Functionality:

Getting Started

To start using lazyspotify, a Spotify app client ID is necessary:

1. Open the Spotify Developer Dashboard and create a new app.
2. Use the following details when setting up your app:
   • App Name: lazyspotify
   • App Description: Terminal-based Spotify client
   • Website: lazyspotify GitHub
   • Redirect URI: http://127.0.0.1:8287/callback
3. Save your app's Client ID in the config.yml or export it as an environment variable.

Configuration

Configuration files are saved in the following locations:

• macOS: ~/Library/Application Support/lazyspotify/config.yml
• Linux: ~/.config/lazyspotify/config.yml

The app automatically generates a default config.yml if missing, which can easily be edited to include your Spotify client ID and other settings.

For instance, a minimal configuration could appear as follows:

auth:
  client_id: your_spotify_app_client_id

Running lazyspotify

Simply invoke the lazyspotify application using:

lazyspotify

If built from source, run it directly via:

./target/lazyspotify

Development

Contributions and enhancements to lazyspotify are welcome. Set up the development environment by running:

make run
go test ./...

Engage with lazyspotify for a streamlined and efficient Spotify experience from the comfort of your terminal.