A command-line tool to help you authenticate and register a Spotify account with your Spotizerr instance. This utility simplifies the process by programmatically capturing Spotify session credentials and posting them to your Spotizerr backend.
- Interactive Setup: Guides you through the process of connecting to your Spotizerr instance.
- API Credential Check: Automatically checks if your Spotizerr instance has the required Spotify API
client_idandclient_secretand prompts you to add them if they are missing. - Spotify Connect Integration: Uses
librespot-spotizerrto create a temporary Spotify Connect device, allowing you to capture credentials securely by simply playing a song. - Colored Output: Uses color-coded terminal output to highlight important information and make the process easier to follow.
- Clean Exit: Gracefully handles interruptions and ensures a clean shutdown.
- Python 3.7+
- A running instance of Spotizerr.
- Spotify
client_idandclient_secret. You can get these by creating an application on the Spotify Developer Dashboard.
-
Clone the repository or download the files:
git clone https://github.com/Xoconoch/spotizerr-auth cd spotizerr-auth -
Install the required Python packages: It is recommended to use a virtual environment.
python -m venv .venv source .venv/bin/activate pip install -r requirements.txt
Run the script from your terminal:
python spotizerr-auth.pyThe script will guide you through the following steps:
-
Enter Spotizerr URL: You'll be prompted for the base URL of your Spotizerr instance. You can press Enter to use the default (
http://localhost:7171). -
Configure API Credentials: The script checks if your Spotizerr instance is configured with a Spotify
client_idandclient_secret.- If they are missing, it will ask if you want to configure them.
- Select
yand enter your credentials when prompted. This is a one-time setup.
-
Enter Account Details:
- Provide a name 552E for the account to identify it in Spotizerr.
- Enter your two-letter Spotify region code (e.g.,
US,DE,MX).
-
Authenticate via Spotify Connect:
- The utility will start a Spotify Connect device on your network (e.g.,
librespot-spotizerr). - Open Spotify on any device (phone, desktop), start playing a track, and use the "Connect to a device" feature to transfer playback to the new device.
- Once you transfer playback, the script captures the session, creates a
credentials.jsonfile, and shuts down the Connect server.
- The utility will start a Spotify Connect device on your network (e.g.,
-
Register with Spotizerr: The script automatically sends the captured credentials to your Spotizerr instance, creating or updating the account.
-
Cleanup: Finally, it will ask if you want to delete the
credentials.jsonfile. It's recommended to do so for security.
After these steps, your Spotify account will be registered in Spotizerr and ready to use.
The script uses librespot-spotizerr's Zeroconf implementation to advertise a Spotify Connect device on the local network. When you transfer playback to this device, librespot-spotizerr handles the authentication with Spotify's servers and stores the session details (including the necessary refresh token) in a local credentials.json file.
Once this file is created, the script reads it and makes a POST request to the Spotizerr API endpoint /api/credentials/spotify/{accountName}. The request body is a JSON object containing the user's region and the contents of credentials.json, which Spotizerr then stores for future use.
The initial check for client_id and client_secret ensures that Spotizerr has the necessary global API credentials to perform metadata lookups and other API-dependent tasks.