Download your favorite Spotify songs and playlists, along with album art and metadata (from YouTube if a match is found), in a GUI!
App
- Custom URI scheme
- Self update
- Use Spotify API
- Search
- By title
- By artist
- By playlist
- By album
- Download
- By song
- By artist
- By playlist
- By album
- Recommendations (User API key)
- Search
- spotDL integration
- Start app with
spotdl app
- spotDL binaries sidecar
- All platforms
- Windows
- Darwin
- Linux
- All platforms
- spotDL auth options (optional)
-
--user-auth
-
--client-id
-
--client-secret
-
--auth-token
-
- spotDL download options
-
--audio-providers
-
--lyrics-providers
-
--output
-
--output-dir
-
--bitrate
-
--threads
-
--format
-
--save-file
-
--preload
-
--m3u
-
--overwrite
-
--ytm-data
-
--generate-lrc
-
--force-update-metadata
-
- Others (almost 100% of spotDL features can be implemented as this app uses compiled spotDL binaries under the hood as a sidecar)
- Start app with
- Standalone (package spotDL binaries, and ffmpeg)
- Dependant (use installed spotDL CLI, and ffmpeg)
- Check if spotDL installed, download if not
- Check if ffmpeg installed, download if not
- Views
- Custom titlebar in Windows/Linux
- Accelerators (macro shortcuts)
- Window menu
- File
- Open download folder
- Select download folder
- Exit
- View
- Toggle developer tools
- Window
- Minimize
- Always on top
- Help
- Documentations
- Release notes
- Report issue
- Join us on Discord
- Check for updates
- About
- File
- Custom "about" window
- Sidenavbar
- Search page
- Download queue page
- Context menu
Documentation
- Installation
- Usage
- FAQ
- Open-source notices
- Code documentation (JSDoc, Rust)
- Contributing guidelines
- Github wiki
Workflows
- Release
- Format code on dev push
Details are subject to change over time.
To avoid legal issues with Spotify's Digital Rights Management techonology, spotDL downloads songs from YouTube, YouTube Music, and other supported music providers.
Platform | Versions |
---|---|
Windows | 7 and above |
macOS (todo) | |
Linux (todo) |
An arrow down (representing a download symbol), on fire, in YouTube red colors, because spotDL mainly downloads from YouTube/YTMusic, with the Spotify symbols inside.
It's not a fish!
spotDL GUI is following Cargo's Semantic Versioning
See Contributing