How omar-mk06/song-downloader works
Song Downloader is a Spicetify extension with an optional localhost server. A player-bar button or track context-menu action enters the download workflow: it gets track details, prefers spotdl through the server, and falls back to a web lookup and browser download. The server saves songs and registers its folder in Spotify Local Files; the extension then requests an index refresh. The README documents these capabilities, while the edges below are limited to relationships visible in the sampled source or README.
Main entry points: downloadSong.js Download workflow · spotdl-server.py HTTP endpoints
Components 20
Spotify Extension
- Download actions
downloadSong.js - Download workflow
downloadSong.js - Track details
downloadSong.js - Local Files refresh
downloadSong.js
Download Methods
- Server client
downloadSong.js - Web fallback lookup
downloadSong.js - Browser file save
downloadSong.js
Local Server
- HTTP endpoints
spotdl-server.py - spotdl runner
spotdl-server.py - Folder setup
spotdl-server.py - Prefs registration
spotdl-server.py - Download folder
External Services
- Spotify track API
- Download mirror
- Audio CDN
- Spotify Local Files
- spotdl package
Other components
- Spotify user
- Spotify UI
- Spotify prefs
Connections 21
- Spotify user → Spotify UI: uses
README.md - Spotify UI → Download actions: selects track
README.md - Download actions → Download workflow: starts download
downloadSong.js - Download workflow → Track details: gets details
downloadSong.js - Track details → Spotify track API: queries track
downloadSong.js - Download workflow → Server client: checks and requests
downloadSong.js - Server client → HTTP endpoints: HTTP requests
README.md - Download workflow → Web fallback lookup: falls back
downloadSong.js - Web fallback lookup → Download mirror: queries mirror
downloadSong.js - Download mirror → Audio CDN: returns link
- Download workflow → Browser file save: saves fallback
downloadSong.js - Browser file save → Audio CDN: fetches audio
downloadSong.js - HTTP endpoints → spotdl runner: runs download
spotdl-server.py - spotdl runner → spotdl package: invokes package
spotdl-server.py - spotdl runner → Download folder: writes songs
README.md - HTTP endpoints → Folder setup: handles setup
spotdl-server.py - Folder setup → Download folder: creates folder
spotdl-server.py - Folder setup → Prefs registration: registers folder
spotdl-server.py - Prefs registration → Spotify prefs: updates prefs
spotdl-server.py - Download workflow → Local Files refresh: refreshes after success
downloadSong.js - Local Files refresh → Spotify Local Files: requests refresh
downloadSong.js