Setup OrpheusDL on Windows

This guide is made for installing OrpheusDL in Windows, but you can easily setup OrpheusDL on other platforms:

  1. Windows: https://rentry.co/OrpheusDL_on_Windows
  2. Android (Termux): https://rentry.co/OrpheusDL_on_Termux
  3. iOS (iSH terminal): https://rentry.co/OrpheusDL_on_iOS

See the original repository for more configuration settings: https://github.com/OrfiTeam/OrpheusDL

1. Installing Chocolatey, a package manager for windows, Python and Git:

  • Type CMD in the search bar the press the key combo shift + ctrl + enter, click "yes" on the following pop-up. This will open the Command Prompt terminal with administrator privileges.
  • Now copy paste the following command for installing Chocolatey:
    @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
    
  • If there aren't any error, re-open cmd with the following command:
    powershell -Command "Start-Process cmd -Verb RunAs" && exit
  • Install Python, Git and FFmpeg using Chocolatey:
    choco install python git ffmpeg -y && exit

2. Installing OrpheusDL

  • Choose or create a directory for installing OrpheusDL, then inside the address bar write cmd and press enter as shown below:
    CMD
  • Clone OrpheusDL and install its requirements using this command:
    git clone https://github.com/OrfiTeam/OrpheusDL.git && cd OrpheusDL && pip install -r requirements.txt

3. Installing OrpheusDL modules

1. Each module corresponds to a specific streaming service. For example installing the Qobuz module will let you download music from www.qobuz.com

2. You can install multiple modules to be able to download from multiple streaming services, but remember to setup an account for each of them.

3. If you want to use your own Deezer and Qobuz premium accounts, read the Extra section

  • Make sure you're still inside "OrpheusDL" directory, then install whichever module you want by executing the corresponding command:
  • Qobuz (UserID and Token): git clone https://github.com/thekvt/orpheusdl-qobuz modules/qobuz

    Requires UserID and Token. You can get them here: https://rentry.co/firehawk52#qobuz-tokens

  • Deezer (ARL): git clone https://github.com/thekvt/orpheusdl-deezer modules/deezer

    Requires ARL. You can get it here: https://rentry.co/firehawk52#deezer-arls

  • Tidal: git clone --recurse-submodules https://github.com/Dniel97/orpheusdl-tidal.git modules/tidal

    Requires Username and Password. You can get them from Firehawk telegram group DO NOT CHANGE PASSWORDS

  • Jiosaavn: git clone https://github.com/bunnykek/orpheusdl-jiosaavn modules/jiosaavn

    No account required.

4. Setting up accounts credentials

  1. Make sure you're still inside "\OrpheusDL" directory. Run OrpheusDL for the first time to create the settings.json file: python orpheus.py
  2. Open the settings.json file with NotePad: notepad config\settings.json
  3. Scroll to the bottom and insert account credentials:
    • Qobuz (UserID and Token): insert UserID and Token.
      Also insert app_id: 579939560 and app_secret: fa31fc13e7a28e7d70bb61e91aa9e178
      Example:
      1
      2
      3
      4
      5
      6
      7
      "qobuz": {
          "app_id": "579939560",
          "app_secret": "fa31fc13e7a28e7d70bb61e91aa9e178",
          "quality_format": "{bit_depth}B-{sample_rate}kHz",
          "user_id": "YOUR_USERID_HERE",
          "auth_token": "YOUR_TOKEN_HERE"
      },
      
    • Deezer (ARL): insert ARL.
      Also insert bf_secret: g4el58wc0zvf9na1 and track_url_key: jo6aey6haid2Teih
      Example:
      "deezer": {
          "client_id": "447462",
          "client_secret": "a83bf7f38ad2f137e444727cfc3775cf",
          "bf_secret": "g4el58wc0zvf9na1",
          "track_url_key": "jo6aey6haid2Teih",
          "prefer_mhm1": false,
          "email": "",
          "password": "",
          "arl": "YOUR_ARL_HERE"
      }
      

Once finished editing the settings.json file, you must save by pressing ctrl+s, then you can close NotePad

    • Jiosaavn: no account required, so no need to change anything
    • Tidal: You need to "bind" OrpheusDL to your tidal account:
      • Make sure you're still inside OrpheusDL
      • Execute python orpheus.py [any tidal link] example: python orpheus.py https://listen.tidal.com/track/119743046
      • Input 1 to choose TV login
      • Now it should automatically open the "Bind a device" tidal page, if it doesn't you can copy the link and manually open it in a browser (example bind link: https://link.tidal.com/XXXXX)
      • Log in with an account and click on "Bind Device"
      • Once finished, you can close the page and go back to CMD; you should see OrpheusDL starting to download from tidal

5. How to use OrpheusDL

  • Open a Terminal (cmd or powershell) inside the OrpheusDL directory
  • Execute python orpheus.py [link] example: python orpheus.py https://www.deezer.com/en/track/780474902
  • To download multiple albums you can list them python orpheus.py [link1] [link2] [link3] or you can create a list.txt file inside "\OrpheusDL" directory and paste one link per line, then python orpheus.py list.txt
  • If everything went well, OrpheusDL will start downloading.
  • Once finished, you can find downloaded music inside "\OrpheusDL\downloads"
  • ENJOY !!

#Extra

If you want to use your own Qobuz and Deezer accounts, you have 2 options:

  1. Using the following telegram bot to get ARL, UserID and Token from username and password: https://t.me/account_tools_bot
  2. Installing the following Qobuz and Deezer modules instead of the corresponding ones listed in step_4:
    • Qobuz (username and password): git clone https://github.com/yarrm80s/orpheusdl-qobuz modules/qobuz
    • Deezer (username and password): git clone https://github.com/uhwot/orpheusdl-deezer modules/deezer

You can only have 1 active module for each streaming service. Example: you cannot install both Deezer (ARL) and Deezer (username and password)

For updating: open CMD inside OrpheusDL directory and execute the following command
cd .. && git -C OrpheusDL pull && cd OrpheusDL/modules && git -C deezer pull & git -C qobuz pull & git -C tidal pull & git -C jiosaavn pull


Credits: Thanks to TheKVT - bunnykek - Dniel97 - OrpheusDL dev team - Firehawk and his team


Support channel: https://t.me/firehawk52official (If you have any questions or need help)

Troubleshooting
  • Help! OrpheusDL is only downloading 30 seconds songs from Qobuz and only lossy songs from Deezer!

    Your Qobuz token or Deezer ARL expired, get a new one and insert it in settings.json (follow from step 4_2)

  • OrpheusDL downloads fine all other songs, exept this specific one!

    The most common reason is beacuse that song is region locked. Get an account from the same region or try to see if the song is available on other streaming sites.

  • Help! Somehow OrpheusDL gets stuck when downloading from Qobuz

    You didn't insert app_id and app_secret in step 4 or they could be expired. Get new ones from here

  • Help! When trying to download from Deezer, I get ValueError: Incorrect AES key length (0 bytes)

    You didn't insert bf_secret and track_url_key in step 4 or they could be expired. Get new ones from here

  • I accidentally started to download a playlist containing 8794 songs! How to stop it!

    You can press ctrl+c at any time to stop any running script.

Edit Report
Pub: 19 Aug 2024 17:51 UTC
Edit: 12 Dec 2024 15:05 UTC
Views: 5846