Spotify
Connecting Spotify
Connect your Spotify account through a Spotify app of your own, so Orpheus can keep your rotation playlists there. The app is a free registration on Spotify's developer site. Because it is yours, you have your own allowance of requests, and nobody else's use of Orpheus can slow yours down. It takes about five minutes, once.
Orpheus never asks for your Spotify password and never sees it. You approve it on Spotify's own page, and it can only create playlists, change the tracks in the playlists it made, and check that they are still in your library.
How to
- Open Spotify settings from the menu. Until you are connected, the page is a checklist of four steps.
- Step 1 · Create your Spotify app: on Spotify's developer dashboard, choose Create app, and paste the Redirect URIs address exactly as the page shows it. Tick Web API only. You need Spotify Premium on the account that creates the app. Already have an app? Open Already have a Spotify app? on the same page instead.
- Step 2 · Add yourself under User Management: add the email address of the Spotify account you will connect, even though the app is your own.
- Step 3 · Copy the Client ID from the app's Basic Information tab. Leave the client secret alone; Orpheus does not use it.
- Step 4 · Connect: paste it into Client ID, press Connect Spotify, and approve on Spotify's page. You come back to Spotify settings, which now shows Connected.
- Next, add music on Your music and set up a rotation.
Reading playlists straight from Spotify
Instead of uploading exports, Orpheus can read a playlist from your Spotify account and check it again for changes. It is off unless you switch it on, because reading a big playlist uses a good share of your requests: Spotify hands a playlist over 50 tracks at a time.
- On Spotify settings, under Read playlists from Spotify, press Turn on. It can't be used, and its ? says why, until you reconnect if Spotify's access has ended or the connection was approved without reading your private playlists.
- Add the playlist on Your music.
- To stop, press Turn off. Playlists you added keep the tracks they had, and your rotations keep drawing from them.
Spotify gives an app less about each track than an export does: no genres and no sound information such as tempo and energy. Genre and sound filters therefore leave out tracks that have only come from Spotify.
Access ends after six months
Spotify ends every app's access to an account six months after it was approved, and it cannot be extended. The date is under Access ends on Spotify settings, and Orpheus emails you two weeks before it. Press Reconnect at any time to start a fresh six months; your rotations carry on where they were.
Disconnecting
Disconnect Spotify deletes the stored credential, every Spotify identifier Orpheus holds for you and any playlists it read from Spotify, and stops your rotations. Your uploads, play history and settings stay. The playlists Orpheus made stay in your Spotify library. To withdraw the approval on Spotify's side too, remove your app at spotify.com/account/apps.
Without it
Without a connection you can still upload music on Your music, set up rotations and press Preview a pick to see what they would choose. Nothing reaches Spotify: no playlist is created or refilled, and automatic runs are skipped and recorded on Run history as "skipped — Spotify not connected".
When something goes wrong
That does not look like a Spotify client ID
What was pasted into Client ID is not one. Copy it again from your app's Basic Information tab with the copy icon beside Client ID, not the client secret.
INVALID_CLIENT: Invalid redirect URI
Spotify shows this when the address under Redirect URIs in your app does not match Orpheus's character for character. Go back to Step 1, copy the address with Copy, add it to the app, and save. Check for a stray space.
INVALID_CLIENT: Invalid client
The Client ID was mistyped, or the app it belongs to was deleted. Copy it again in Step 3.
User not registered in the Developer Dashboard
The Spotify account you approved with is not on the app's user list. Add its email address in Step 2, using the address that account signs in with, and press Connect Spotify again.
You declined the permission request, so nothing was connected.
You pressed cancel on Spotify's page. Press Connect Spotify again and choose Agree.
The connection attempt expired. Start again — it has to be finished within ten minutes.
Too long passed between pressing Connect Spotify and approving. Press it again and finish on Spotify's page within ten minutes.
Spotify ended this connection
Six months passed since you approved, or the app was removed at spotify.com/account/apps. Your rotations have stopped. Press Reconnect on Spotify settings: it takes about ten seconds, and they carry on where they were.
Reconnect once to allow one more permission.
Your connection was approved before Orpheus began checking that its playlists are still in your library, which needs permission to read your private playlists. Press Reconnect and approve. Until you do, Orpheus cannot tell when you remove one of its playlists, and reading playlists from Spotify cannot be turned on.
Connected, but rotations fail with "Forbidden"
One possible cause is that the account that created the app no longer has Spotify Premium. Check its plan at spotify.com/account.
Checked against 1.2.1, 2026-11-04