Skip to content

Fix Spotify OAuth and merge deduped exports #67

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
vintagechocolate wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Fix Spotify OAuth and merge deduped exports #67

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ae94d7d
Fix Spotify OAuth authorization flow
vintagechocolate Apr 25, 2026
cb1b599
Update exports to merge and dedupe playlists
vintagechocolate Apr 25, 2026
870f4c5
Use current playlist endpoint
vintagechocolate Apr 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
*.txt
*.json
__pycache__/*
.DS_Store
39 changes: 38 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,51 @@ You can run the script from the command line:

python3 spotify-backup.py playlists.txt

or, to get a JSON dump, use:
The browser authorization flow uses Spotify's Authorization Code with PKCE flow.
If the bundled Spotify app client ID is rejected for your account, create your own
Spotify app, add `http://127.0.0.1:43019/redirect` as a redirect URI, and run:

SPOTIFY_CLIENT_ID=your_client_id python3 spotify-backup.py playlists.txt

or:

python3 spotify-backup.py playlists.txt --client-id=your_client_id

or, to get a merged JSON export, use:

python3 spotify-backup.py playlists.json --format=json

To merge your Liked Songs and playlists into one JSON export, use:

python3 spotify-backup.py playlist.json --dump=liked,playlists --format=json

JSON exports are written as a single `Spotify Backup` playlist using your Spotify
user ID. Tracks from all selected playlists are merged before writing this
simplified shape:

{
"name": "Spotify Backup",
"id": "your_spotify_user_id",
"tracks": [
{
"artist": "Artist Name",
"name": "Track Name",
"album": "Album Name",
"thumbnail": "https://i.scdn.co/image/...",
"duration": "3:24",
"stream": null
}
]
}

By default, it includes your playlists. To include your Liked Songs, you can use:

python3 spotify-backup.py playlists.txt --dump=liked,playlists

All exports remove duplicate tracks by Spotify URI before writing the output, so
the same track will not appear twice in either TXT or JSON files. Liked Albums are
also deduplicated by Spotify album URI when included in TXT output.


If for some reason the browser-based authorization flow doesn't work, you can also [generate an OAuth token](https://developer.spotify.com/web-api/console/get-playlists/) on the developer site (with the `playlist-read-private` permission) and pass it with the `--token` option.

Expand Down
Loading