Unleash Your Audio Library

A cross-platform graphical user interface for OrpheusDL. Search & download across multiple music streaming services with ease.

Trailer Thumbnail
Amazon Music
Apple Music
Beatport
Beatsource
Deezer
Qobuz
SoundCloud
Spotify
Tidal
YouTube
Amazon Music
Apple Music
Beatport
Beatsource
Deezer
Qobuz
SoundCloud
Spotify
Tidal
YouTube
Amazon Music
Apple Music
Beatport
Beatsource
Deezer
Qobuz
SoundCloud
Spotify
Tidal
YouTube
Amazon Music
Apple Music
Beatport
Beatsource
Deezer
Qobuz
SoundCloud
Spotify
Tidal
YouTube

What It Does

A completely overhauled experience eliminating the need for terminal commands.

Universal Links

Simply paste links from your favorite streaming platforms. Or use a text-file with url links to download in batch.

Smart Search

Search across all platforms simultaneously without needing an account. View duration, track count, and release year, complete with Dolby Atmos, Hi-Res & Explicit tags.

Advanced Configuration

Easily edit settings, manage modules, and authenticate directly from the clean interface without touching JSON Files.

OrpheusDL GUI interface overview animated
Click to enlarge

What's New?

Chronological updates, new features, and bug fixes for the OrpheusDL GUI project.

v2.0.3

3/6/26
  • 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

v2.0.2

3/4/26
  • General
    • 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.
    • 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
  • Apple Music
    • Fixed incorrect duration tag in ALAC/ATMOS tracks, which previously caused tracks to play too short.

v2.0.1

31/3/26
  • Fixes
    • Beatport label wasn't showing proper covers, artist names, year, and catalog number
    • When using arrow up and down in search result, lazy-loading for covers wasn't kicking in
    • When using page up/down or home/end focus bar wasn't jumping along
    • When hitting enter to expand an entry in search result, the focus of selection bar was gone

v2.0.0

30/3/26
  • Enhanced Search Info
  • Advanced Track Variables
    • Support for {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
    • Added support for super-high resolution (3000px) cover art.
  • Spotify
    • Added ISRC metadata to track downloads.
  • TIDAL
    • Fixed support for both synced and embedded lyrics.
  • Quality Indicators
    • Now displayed in concurrency downloads (vs sequential).
  • Keyboard Shortcuts
    • Added a full suite of shortcuts. Press F1 for an overview.
  • Audio Customization
    • Added an OPUS bitrate adjustment slider.
  • Search Filtering
    • Select specific platforms to include when searching 'all'.
  • Android Support
  • Updated Core
    • Synced with latest gamdl 2.9.3, deno 2.7.9, and yt-dlp 2026.03.17.

How to Install

Get up and running in minutes on your preferred platform.

Installing on Windows

  1. Download the compiled installer `.exe` from the Releases page.
  2. Double-click the executable to install or run.
  3. Follow the prompt to install any missing dependencies if signaled.
Windows Installation

Installing on macOS

  1. Download the compiled `.dmg` from the Releases page.
  2. Drag the app to your Applications folder.
  3. If prompted about unverified developer, approve it in Settings > Privacy & Security.

Standard Install

macOS Standard Install

Older macOS (No Homebrew)

macOS Legacy Install

Installing on Linux

  1. Download the compiled `.AppImage`, `.deb` or `.zip` from the Releases page.
  2. Ensure it has executable permissions (`chmod +x`).
  3. Run the application. Make sure `ffmpeg` is installed on your system.
Linux Installation

Installing on Android

  1. Install Termux via F-Droid.
  2. Download install_orpheus.sh from the repo.
  3. Open it in Termux.
  4. Ensure it has executable permissions (chmod +x install_orpheus.sh).
  5. Run it: ./install_orpheus.sh.
  6. Run the Web UI: cd OrpheusDL && source venv/bin/activate && python webui.py
Android Installation

Prefer using CLI?

Follow the instructions at:
https://github.com/bascurtiz/orpheusdl

Watch demo:

OrpheusDL CLI Demo

Master the Modules

Comprehensive video guides for every feature to maximize your experience.

How to set up Amazon Music

How to set up Amazon Music

Region/country & sign-in.

How to set up Apple Music

How to set up Apple Music

Cookies-based setup.

How to set up Deezer

How to set up Deezer

'arl' cookie extraction.

How to set up Qobuz

How to set up Qobuz

Local storage token guide.

How to set up SoundCloud

How to set up SoundCloud

Oauth token extraction.

How to set up Spotify

How to set up Spotify

Dashboard App creation.

How to set up YouTube

How to set up YouTube

Private window cookie export.

Tutorial Wrapper Windows

How to set up Wrapper Windows

Docker-focused steps for Windows.

Tutorial Wrapper macOS

How to set up Wrapper macOS

Docker-focused steps for macOS.

Tutorial Wrapper Linux

How to set up Wrapper Linux

Docker-focused steps for Linux.