Module storage 

Persistent storage for configuration, tokens, and pins.

All data is stored in the user’s config directory:

• Linux/macOS: ~/.config/spotify-cli/
• Windows: %APPDATA%/spotify-cli/

Files

• config.toml - User configuration (client_id, search settings)
• token.json - OAuth access and refresh tokens (fallback)
• pins.json - Pinned resource shortcuts

Secure Storage

Tokens can be stored securely in the system keychain:

• macOS: Keychain
• Linux: Secret Service (GNOME Keyring, KWallet)
• Windows: Windows Credential Manager

Modules

config

Configuration file handling.

fuzzy

keyring

Secure token storage using system keychain.

paths

pins

token_store

OAuth token persistence.

unified_token

Unified token storage with automatic backend selection.