A fork of scdl that keeps a whole list of playlists in sync. No SoundCloud account or token needed; just a list of playlist links.
flowchart LR
A["src/sc-playlists-list.md<br/>your playlist links"] --> B{"anything new?<br/>4 requests max"}
B -- no --> S["skip"]
B -- yes --> C["scdl + yt-dlp<br/>download and tag"]
C --> D["playlists/sc/<br/>one folder per playlist"]
C -- "failed track" --> Y["found on YouTube<br/>saved as [YT] ..."]
Y --> D
playlists/sc/
Night drive/
Artist - Title.m4a
[YT] Artist - Not on SoundCloud anymore.m4a
[unsync] Artist - Removed from the playlist.m4a
my own edit.wav ← yours, never touched
- Only fetches what's new. An unchanged playlist costs at most 4 requests and no download.
- Never deletes your music. A track removed from a playlist is renamed
[unsync] ...and stays on disk. Files you add to a playlist folder are left alone. - Follows your changes. A renamed playlist moves its folder. A new share link for the same playlist picks up where the old one stopped.
- Tells a dead link from an empty playlist. An expired secret link is reported with its line number instead of being read as "every track was removed".
- Falls back to YouTube. Tracks that fail on SoundCloud (DRM, or a 30-second GO+ preview instead of the song) are looked up on YouTube and saved with a
[YT]tag. - Runs on its own. A daily Windows task syncs at 18:00 and pings your phone only when something changed. The ping holds counts and line numbers, never names or links.
- YouTube playlists too. The same sync for YouTube, as m4a audio or small mp4 video.
You need Python 3.10+, uv and ffmpeg on your PATH.
uv sync
. .\.venv\Scripts\Activate.ps1Then list your playlists in src/sc-playlists-list.md, one link per line. For a private playlist, paste its secret share link:
https://soundcloud.com/<user>/sets/<playlist>
https://soundcloud.com/<user>/sets/<playlist>/s-<token>
Lines that don't start with http are ignored. The file is git-ignored, so your links stay on your machine.
python src/sync_sc_playlists.pyIt checks every playlist, downloads the new tracks, tries YouTube for the ones that failed, and lists any dead link by its line number. Run it with --force-all now and then to find tracks that were removed from a playlist.
To have it run by itself every day at 18:00, run this once from an admin PowerShell in the repo folder:
powershell -ExecutionPolicy Bypass -File deploy\windows\register-task.ps1For phone alerts, copy .env.example to .env and set an ntfy topic. See docs/scheduled-sync.md.
| Usage | Every command and flag: SoundCloud, YouTube audio and video, GO+ tracks, logins, files and folders |
| Scheduled sync | The daily Windows task, what an unattended run does differently, alerts |
| How the sync works | The fast check, archives, dead links, renames, and why |
| Development | Updating yt-dlp and upstream scdl, tests, project layout, TODO |