An advanced CLI client for Spotify, built on top of the PainKiller CommandPrompt framework. Provides full terminal control over Spotify including AI-assisted artist enrichment, playlist building, tagging, backup, search, and much more.

Ask ChatGPT: https://chatgpt.com/g/g-680fb8d660748191a59e8aad386c727c-playlist-prompt-client

• .NET 9.0 SDK installed.

• A Spotify Developer account with a registered application:
  Register here

  You will need:

  • Client ID
  • Redirect URI (e.g., http://localhost:5000/callback/)

• Store your Client ID securely using the built-in Security module:

  secret --create "spotify_prompt"

• Ollama Service

  The Spotify Prompt Client uses AI with Ollama and Gemma3 to get related artists, since Spotify removed the Get Artist's Related Artists in their WebAPI. You can download this software here: https://ollama.com/download it is a lightweight service running in the background. You CAN USE this client without it, but some of it´s functionality regarding building playlists will not work.

1. Clone the repository:

   git clone https://github.com/your-org/SpotifyPromptClient.git
   cd SpotifyPromptClient

2. Configure your application settings (CommandPromptConfiguration.yaml):

   spotify:
     redirectUri: "http://localhost:5000/callback/"
     refreshMarginInMinutes: 10
     scopes:
       - user-read-playback-state
       - user-modify-playback-state
       - playlist-read-private
       - playlist-modify-public
       - playlist-modify-private

3. Build the project:

   dotnet build

4. Run the CommandPrompt host:

   dotnet run --project src/PainKiller.CommandPrompt.Host

1. Login to Spotify:

   login

2. Update and list your playlists:

   list --update
   list

3. Control playback:

   play
   next
   pause

4. Example Search albums and then create a playlist with build command:

   search album --artist queen //(select some great queen albums in the list)
   build new                   //(choose * as tag, Albums, Selected, No year range, 100 as max count, 20 as number of tracks)

5. Use AI enrichment:

   ai
   artist --ai

• Session selections: You can accumulate selected tracks, albums, and artists across commands (search, album, artist) and operate on them, just turn on append if you want to accumulate your selection that could be use when building a playlist with build command.
• AI Integration: Integrates with a local or remote AI server (Ollama) for artist enrichment and tagging.
• Backup: Important Spotify data is persisted and can be backed up at any time.
• Automatic Token Handling: No manual refresh needed; tokens are refreshed automatically when needed.

• Ensure the Redirect URI registered in Spotify Dashboard matches your configuration exactly.
• If the access token expires and refresh fails, first try to start your player with play command or run login again.
• Update your Spotify application scopes if you encounter permission issues.

Enjoy controlling Spotify directly from your terminal!

Learn more about Spotify Web API