Releases: bascurtiz/OrpheusDL-GUI
Release list
v2.0.3
Changelog:
- Amazon Music: New platform support!
Spotify:
- When downloading with Spotify, the album artist should be the main artist of the album (so that's 1 artist), while artist tag could be - several
- Added Lyrics to metadata when downloading Spotify
- Added label, upc, copyright holders to the metadata
- Warning upfront when d/ling (account might get suspended)
- Added warning to CLI too (like GUI) + pausing in between downloads when using multiple links like python orpheus.py link1 link2 etc.
Apple Music:
- Library playlists bigger than 100 are now able to download too
- Added LABEL/PUBLISHER to the metadata
- Added UPC/BARCODE to the metadata
- Removed redundant GENRE: 'Music' that was added next to specific genre in metadata
- When connection is lost with wrapper it will pause (and plays a sound to indicate user-interaction is needed), then retries in 10s to auto-resume
- Synced lyrics (.lrc file) will now be downloaded too (when enabled in Global Settings)
- Albumartist will be one artist, while Artist can have featuring artists too
- Album songs will now have release-date of the album (not when they were released on Apple Music)
- Updated wrapper video tutorials based on latest wrapper (for each OS)
Deezer:
- When downloading album url with Deezer, it writes PUBLISHER to the metadata, but not when downloading track url.
- When downloading album url with Deezer, it doesn't seem to write LYRICS to the metadata. When we download a track url instead, it does. Now both do.
- Synced lyrics (.lrc file) will now be downloaded too (when enabled in Global Settings)
- Now supports link.deezer.com too
Qobuz:
- New auth method which lets you login on their site (next to token/id usage — removed defunct login with email+pw)
- Enhanced error-message when id/token expired
SoundCloud:
- No more traceback error, but user-friendly message when no token is filled in settings
TIDAL:
- Added LABEL/PUBLISHER to the metadata
- Corrected to write VOCALS to LYRICIST tag
- Personal playlists will now show up in search results too
- Artist search will now expand without capped to 20 albums
YouTube:
- User-friendly messages and guidance when ffmpeg, youtube-cookies or deno isn't present
Global:
- Added Split metadata (true or false) + Metadata separator (user-defined)
- Added TRACK_URL to metadata for all platforms (handy to see the source of your download)
- Added LRCLIB as external lyrics provider (change default to LRCLIB in Global Settings)
- Now respects whether embed lyrics will write synced (or static) lyrics based on settings applied
- Added playlist_postion + album_position
- Drag and drop support for input of text-file with urls
- Embed + external cover now are independently in size from each other (based on global settings)
- Search result covers now auto lazy-load when sorting columns
Linux:
- Wayland (and X11) should both open up URLs automatically now
OrpheusDL_GUI-Setup-2.0.3.exe (Windows)
OrpheusDL_GUI-Installer.dmg (macOS)
OrpheusDL_GUI-x86_64.AppImage Linux (universal, works on most distros)
OrpheusDL_GUI-2.0.3-amd64.deb Linux (Debian/Mint/Ubuntu-based distros)
OrpheusDL_GUI-Arch-PKGBUILD.zip Linux (Arch Linux)
v2.0.2
Changelog:
- Added a direct link to the release page in update pop-up for easier access.
- The installer now reminds the user to close the application before proceeding.
- Fixed an issue where two versions appeared in the Control Panel (old and new). The old version is now properly overwritten.
- The installer no longer overwrites settings.json and no longer deletes cookies such as cookies.txt and youtube-cookies.txt.
- Replaced the Search button with a Stop button - when searching - to allow cancelling searches.
- Fixed an issue where disabled platforms (e.g. YouTube) saved in settings.json were reset after restarting the app.
- Apple Music: Fixed incorrect duration tag in ALAC/ATMOS tracks, which previously caused tracks to play too short.
- Fixed an issue where Deezer ARL and Qobuz ID/Token could not be entered or saved.
- Improved filename formatting: {explicit} now uses the stylized 🅴 symbol instead of [E] in filenames, albums, and playlists.
- Updated to deno v2.7.11
Installer:
OrpheusDL_GUI-Setup-2.0.2.exe (Windows)
OrpheusDL_GUI-Installer.dmg (macOS)
OrpheusDL_GUI-x86_64.AppImage Linux (universal, works on most distros)
OrpheusDL_GUI-2.0.2-amd64.deb Linux (Debian/Mint/Ubuntu-based distros)
OrpheusDL_GUI-Arch-PKGBUILD.zip Linux (Arch Linux)
v2.0.1
Changelog:
- Fix: Beatport label wasn't showing proper covers, artist names, year, and catalog number
- Fix: When using arrow up and down in search result, lazy-loading for covers wasn't kicking in
- Fix: When using page up/down or home/end focus bar wasn't jumping along
- Fix: When hitting enter to expand an entry in search result, the focus of selection bar was gone
Installer:
OrpheusDL_GUI-Setup-2.0.1.exe (Windows)
OrpheusDL_GUI-Installer.dmg (macOS)
OrpheusDL_GUI-x86_64.AppImage Linux (universal, works on most distros)
OrpheusDL_GUI-2.0.1-amd64.deb Linux (Debian/Mint/Ubuntu-based distros)
OrpheusDL_GUI-Arch-PKGBUILD.zip Linux (Arch Linux)
v2.0.0
Changelog:
- Added much more search result info, see comparison v1.0.9 vs 2.0.0 below
- Added support for more track variables:
{artist} {artist_id} {artist_initials} {album_artist} {name} {album} {track_number} {total_tracks} {disc_number}
{total_discs} {id} {album_id} {label} {catalog_number} {isrc} {release_year} {explicit} {quality} - Apple Music: 3000px cover art support
- Spotify: ISRC added to metadata
- TIDAL: Fixed synced + embedded lyrics support
- Quality: now also showing in concurrency downloads (vs. sequential)
- Keyboard shortcuts added (keyboard shortcuts overview: F1)
- OPUS bitrate adjustment slider added
- Selectable which platforms to include when searching 'all' platforms
- Updated to the latest gamdl 2.9.3 (+ deno 2.7.9 & yt-dlp 2026.03.17)
- Introducing: Web UI for Android via Termux (more info: https://orpheusdl-gui.x10.mx/#installation , tab Android)
- Fixed minor bugs and improvements
Installer:
OrpheusDL_GUI-Setup-2.0.0.exe (Windows)
OrpheusDL_GUI-Installer.dmg (macOS)
OrpheusDL_GUI-x86_64.AppImage Linux (universal, works on most distros)
OrpheusDL_GUI-2.0.0-amd64.deb Linux (Debian/Mint/Ubuntu-based distros)
OrpheusDL_GUI-Arch-PKGBUILD.zip Linux (Arch Linux)
v1.0.9
Changelog:
- All platforms now use public API to search (handy, so even if you don't have an account, you can search on all from the get-go)
- Dynamically linked quality/formats to right-click context menu in search results
- Apple Music: Fixed album/artist/playlist are now downloadable, just like tracks
- Apple Music: Now able to download in Lossless ALAC + Dolby Atmos (using wrapper; see Apple Music tab how to set up)
- Apple Music: Added Dolby Atmos checkbox to Apple Music, like TIDAL to explore/filter search results
- Spotify: Since it now uses the public API, no more rate-limiting on search results
- Enhancement: Better usage of coloring in download output
- Enhancement: Added platform icons in dropdown menu + type menu (album/playlist/track/artist/label/channel)
- Enhancement: Showing HI-RES & ATMOS tags in Additional column in Search results for Apple Music & TIDAL
- Updated to the latest gamdl + yt-dlp + ejs + deno
- Several bug fixes & improvements
Installer:
OrpheusDL_GUI-Setup-1.0.9.exe (Windows)
OrpheusDL_GUI-Installer.dmg (macOS)
OrpheusDL_GUI-x86_64.AppImage - Linux (universal, works on most distros)
OrpheusDL_GUI-1.0.9-amd64.deb - Linux (Debian/Mint/Ubuntu-based distros)
OrpheusDL_GUI-Arch-PKGBUILD.zip - Linux (Arch Linux)
v1.0.8
Changelog:
- Added YouTube module support, based on yt-dlp (handy for those tracks that are simply not available elsewhere)
- YouTube: OPUS/AAC/MP3 stream support
- YouTube: search on channel/playlist/tracks
- YouTube: makes use of EJS with Deno + cookies (like yt-dlp recommends)
- Beatport + Beatsource: added Label search/download
- Deezer: added ARL support to login
- Qobuz: added id/token support to login
- Spotify: added support for the new limited API with clientid/secret
- Tidal: added Dolby Atmos search & explore (like RedSea did) per type (playlist/album/track)
- Added Search on all platforms at once
- Added Search result right-click context menu (to select format/quality + open link directly in browser)
- Added cover thumbnails in search results (+ big size artwork when clicked to save/copy)
- Added audio previews for all platforms (YouTube doesn't have such, so it will open the video url instead)
- Added Clear storage session buttons per platform in settings (when switching to different account/expired subscription)
- Improved How to set up instructions + See demo videos when applicable
- Bug fixes & improvements
Installer:
OrpheusDL_GUI-Setup-1.0.8.exe (Windows)
OrpheusDL_GUI-Installer.dmg (macOS)
OrpheusDL_GUI-x86_64.AppImage - Linux (universal, works on most distros)
OrpheusDL_GUI-1.0.8-amd64.deb - Linux (Debian/Mint/Ubuntu-based distros)
OrpheusDL_GUI-Arch-PKGBUILD.zip - Linux (Arch Linux)
v1.0.7
An installer!
Easy setup, just download, and run it.
Installation:
Windows - Demo how to install: https://youtu.be/rMeBUanEK9Q (1m4s)
macOS - Demo how to install: https://youtu.be/j39ryXFAxzw (1m54s)
macOS - For older macOS / if Homebrew isn't supported: https://youtu.be/7pE6xgm1fsg (1m30s)
Linux - Demo to install: https://youtu.be/51eESmveCME (1m8s)
Changelog:
- Now able to save downloads on different drive than where OrpheusDL GUI is installed
- Spotify support is back
- Solid FFmpeg support now
- Help sections added per module
Installer:
- OrpheusDL_GUI-Setup-1.0.7.exe (Windows)
- OrpheusDL_GUI-Installer.dmg (macOS)
- OrpheusDL_GUI-x86_64.AppImage - Linux (universal, works on most distros)
- OrpheusDL_GUI-1.0.7-amd64.deb - Linux (Debian/Ubuntu-based distros)
- OrpheusDL_GUI-Arch-PKGBUILD.zip - Linux (Arch Linux)
v1.0.6
-
Added Multi-select in search results (holding shift or ctrl and click multiple entries to download in one-go)
-
Added Concurrent downloads to speed up download process (user-defined 1-10 - set to 5 by default)
-
Several bugfixes (in & outside GUI), so:
Reinstall OrpheusDL from scratch is recommended!
Just follow the video link description (updated) here:
https://www.youtube.com/watch?v=AGsYTQuO7nk
Compiled for macOS, Linux and Windows.
v1.0.5
-
Added Apple Music support, search & download functionality (using gamdl: https://github.com/glomatico/gamdl)
-
More color-coding + Icons added + Download log output consistent & cleaned up
-
Several bugfixes (in & outside GUI), so:
Reinstall OrpheusDL from scratch is recommended!
Just follow the video link description (updated) here:
https://www.youtube.com/watch?v=AGsYTQuO7nk
Compiled for macOS, Linux and Windows.
v1.0.4
-
Added Spotify support, search and download functionality with easy setup
-
Added FFmpeg support, from PATH or/and pointing to ffmpeg.exe for audio codec conversions
-
Added Beatport playlist support
-
Added Soundcloud album support
-
Added HLS stream support
Reinstall OrpheusDL from scratch is recommended!
Just follow the video link description (updated) here:
https://www.youtube.com/watch?v=AGsYTQuO7nk
Compiled for macOS, Linux and Windows.
