Setup¶
When you first launch Starlib, the setup wizard guides you through connecting your SoundCloud account.
1. Get SoundCloud API credentials¶
Starlib needs API credentials to access your SoundCloud data.
- Go to the SoundCloud Developer Portal (log in if prompted).
- Click Register a new application.
- Give it any name (e.g. "Starlib").
-
Set the Redirect URI to:
-
Save the app and copy the Client ID and Client Secret.
2. Enter credentials in Starlib¶
On the setup screen, enter:
| Field | Value |
|---|---|
| Client ID | From your SoundCloud app |
| Client Secret | From your SoundCloud app |
| Music folder | Path to your local music folder (defaults to ~/Music/tracks) |

Click Save to continue.
3. Connect your SoundCloud account¶
After saving your credentials, you'll be taken to the home screen. Click Connect with SoundCloud to log in with your SoundCloud account.
SoundCloud will ask you to authorise Starlib. After approval, you'll be redirected back to the app and can start using it.
