Files
orpheusdl-tidal/README.md
Dniel97 95593cc50c Improved mobile session
- Added `enable_mobile` setting to enable mobile session login
- Updated README to reflect changes
- Added really useless SessionType Enum
2021-10-16 15:11:28 +02:00

3.5 KiB

OrpheusDL - Tidal

A Tidal module for the OrpheusDL modular archival music program

Report Bug · Request Feature

Table of content

About OrpheusDL - Tidal

OrpheusDL - Tidal is a module written in Python which allows archiving from Tidal for the modular music archival program.

Getting Started

Follow these steps to get a local copy of Orpheus up and running:

Prerequisites

Installation

  1. Clone the repo inside the folder orpheusdl/modules/
    git clone https://github.com/Dniel97/orpheusdl-tidal.git tidal
    
  2. Execute:
    python orpheus.py
    
  3. Now the config/settings.json file should be updated with the Tidal settings

Usage

Just call orpheus.py with any link you want to archive:

python orpheus.py https://tidal.com/browse/album/92265334

Configuration

You can customize every module from Orpheus individually and also set general/global settings which are active in every loaded module. You'll find the configuration file here: config/settings.json

Global

"global": {
    "general": {
        ...
        "download_quality": "lossless"
    },
    "formatting": {
        "album_format": "{artist}/{name}{quality}{explicit}",
        ...
    },
    "codecs": {
        "proprietary_codecs": false,
        "spatial_codecs": true
    },
    ...
}

download_quality: Choose one of the following settings:

  • "hifi": FLAC with MQA up to 48/24
  • "lossless": FLAC with 44.1/16
  • "high": AAC 320 kbit/s
  • "low": AAC 96 kbit/s

album_format:

  • {quality} will add
     [Dolby Atmos]
     [360]
     [M]
    
    depending on the album quality
  • {explicit} will add
     [E]
    
    to the album path

proprietary_codecs: Enables/Disables MQA (Tidal Masters) downloading regardless the "hifi" setting from download_quality

spatial_codecs: Enables/Disables downloading of Dolby Atmos (EAC-3, AC-4) and Sony 360RA

Tidal

 "tidal": {
    "tv_token": "aR7gUaTK1ihpXOEP",
    "tv_secret": "eVWBEkuL2FCjxgjOkR3yK0RYZEbcrMXRc2l8fU3ZCdE=",
    "mobile_token": "dN2N95wCyEBTllu4",
    "enable_mobile": true
}

tv_token: Enter a valid TV client token

tv_secret: Enter a valid TV client secret for the tv_token

mobile_token: Enter a valid MOBILE client token

enable_mobile: Enables a second MOBILE session which needs a username and password (can be the same "TV" account) to archive Sony 360RA and Dolby AC-4 if available

Contact

Yarrm80s (pronounced 'Yeargh mateys!') - @yarrm80s

Dniel97 - @Dniel97

Project Link: OrpheusDL Tidal Public GitHub Repository

Acknowledgements