Spotify Folders Backup

A small utility to backup all your Spotify playlists including the folder structure. As the Spotify API does not support folders, the folder structure is reconstructed from the Spotify cache with spotify‑folders (all credit to mikez).

Playlists are automatically resolved to albums where appropriate. In this case, the individual tracks are not included in the backup.

Instructions

1. Prepare Spotify
   1. Clear cache in Spotify settings
   2. [Windows only] Fully close Spotify (Alt+F4)
2. Prepare script
   1. Copy .env.template to .env and fill in your Spotify credentials
   2. [Optional] Specify a custom cache directory, account, or folder by running spotify‑folders manually and writing the result to folders.json
3. Run script
   1. Install uv as described here
   2. Run with uv run backup
4. Result can be found in Backup