mirrors/OrpheusDL-GUI
Watch
1
0
Fork
You've already forked OrpheusDL-GUI
 0
mirror of https://github.com/bascurtiz/OrpheusDL-GUI.git synced 2026-10-11 17:36:47 +00:00
Code Issues Projects Releases Packages Wiki Activity
A cross-platform graphical user interface for OrpheusDL. Search & download across multiple music streaming services with ease. https://orpheusdl-gui.x10.mx
556 commits 1 branch 14 tags 24 MiB
  • Python 97.8%
  • Shell 1.3%
  • Inno Setup 0.5%
  • Batchfile 0.4%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
bascurtiz a893a9f28e Update
2026-09-01 12:11:20 +02:00
installer - Clean up deprecated beatsource/jiosaavn directories in installers 2026-08-21 11:32:05 +02:00
platforms - Amazon Music Integration: Added full support for the Amazon Music platform, including credentials settings, a custom OAuth login flow dialog, decryption-based track previews, and quality tag formatting 2026-05-25 17:05:53 +02:00
vendor/another_unplayplay - Clean up deprecated beatsource/jiosaavn directories in installers 2026-08-21 11:32:05 +02:00
.gitignore Update update_checker.py and add .gitignore 2025-04-16 21:07:52 +02:00
animated.gif Updated gif to v2.0.3 2026-06-02 21:42:07 +02:00
badge.svg Refined badge 2026-05-22 13:25:59 +02:00
gui.py Update 2026-09-01 12:11:20 +02:00
gui.spec - Clean up deprecated beatsource/jiosaavn directories in installers 2026-08-21 11:32:05 +02:00
hook-ffmpeg.py Ffmpeg fuckery fix for macOS 2026-01-05 18:42:40 +01:00
hook-yt_dlp.py Explicitly include internal yt_dlp modules 2026-03-05 18:27:27 +01:00
icon.icns CMYK variant of icns 2026-03-15 21:19:42 +01:00
icon.ico Optimize log styling and improve auto-scroll behavior; fix SoundCloud parsing metadata lookup 2026-03-11 21:40:23 +01:00
icon.png 1024px icon for Linux 2026-03-12 02:16:44 +01:00
icon.svg Better .svg file for Linux 2026-01-11 17:42:25 +01:00
key_emu_prod.py - Clean up deprecated beatsource/jiosaavn directories in installers 2026-08-21 11:32:05 +02:00
README.md Adjusted size of AI badge 2026-03-08 01:47:22 +01:00
requirements-gui.txt Added improvement #89 2026-07-25 00:06:50 +02:00
runtime_prod.py - Clean up deprecated beatsource/jiosaavn directories in installers 2026-08-21 11:32:05 +02:00
update_checker.py Linux: _open_url() uses the helper; added _open_path() and _open_config_folder(); removed raw xdg-open / startfile / open for config/download/app folders; dropped local webbrowser patch 2026-06-04 18:05:48 +02:00

README.md

OrpheusDL GUI

GUI overview

Trailer

Watch trailer: https://youtu.be/RAXsW67SjGU

How to install:

  1. Download the compiled installer from the Releases page.
  2. Double-click the exe/app

If you prefer running from source:

  1. Make sure OrpheusDL is installed
  2. Clone this repository (git clone https://github.com/bascurtiz/OrpheusDL-GUI) or download the ZIP file.
  3. Ensure all files from this repository are placed in the same folder where your orpheus.py is located.
  4. Update your package list: sudo apt update
  5. Install the Python virtual environment and Tkinter packages: sudo apt install python3-venv python3-tk
  6. Create a virtual environment: python3 -m venv venv
  7. Activate the virtual environment: source venv/bin/activate
  8. Install the required dependencies: pip3 install -r requirements-gui.txt
  9. Ensure FFmpeg is installed (usually includes ffplay).
    • Ubuntu/Debian: sudo apt install ffmpeg
    • Fedora: sudo dnf install ffmpeg
    • Arch: sudo pacman -S ffmpeg
  10. Run the GUI: python3 gui.py

Compatibility

Operating Systems

OS Tested
Windows 10 ✅
Windows 11 ✅
macOS 11.4+ ✅
Linux Ubuntu 24 ✅

Platforms

Platform Tested Platform Tested Platform Tested Platform Tested
Apple Music ✅ Beatport ✅ Beatsource ✅ Bugs *
Deezer ✅ Genius * Idagio * JioSaavn ❌
KKBOX * Musixmatch * Napster * Nugs.net *
Qobuz ✅ SoundCloud ✅ Spotify ✅ Tidal ✅
YouTube ✅

* If this platform isn't working properly and you have a valid subscription you can share, please open an issue or contact me. I'm willing to debug!


Badge