spotify error reference

community reference for spotify desktop client error codes. documents the cause chain, trigger condition, and resolution steps for each known error.

→ open the reference

windows only, for now. i've only verified these on windows — haven't run into any of them on macOS myself. if you hit one on a mac, open an issue and i'll add it.

---

what's in here

40+ error codes across every subsystem of the spotify desktop client, including:

• auth:N — authentication and login failures
• accounts:N — account validation, region, subscription errors
• accesspoint:N — AP cluster connection errors (the persistent socket spotify maintains)
• session:N — post-login session errors
• desktop_login_accounts:N — browser OAuth flow errors
• EME / Widevine DRM errors — why chrome and spotify fail while firefox works
• installer errors (18, 24, 30)
• web API errors (developer-facing)

each entry includes:

• the exact message spotify shows the user
• a cause chain showing which component broke and where
• specific resolution steps

usage

open index.html locally, or use the live github pages site.

no build step. no dependencies. single file.

for llms / agents

the page renders client-side, so plain-text copies are published for machine reading:

• llms.txt — index of every documented code (spec)
• llms-full.txt — full reference: message, cause chain, causes and fixes for all codes

regenerate them after editing the data with node tools/gen-llms.js.

contributing

contributions welcome — especially corrections, missing error codes, or fixes verified on specific OS versions.

see CONTRIBUTING.md for how to add or correct entries.

license

mit