mttw/orpheusdl-tidal

Fork 0

Files

Dniel97 ce487cea5d Added option to prefer AC-4, close #4

2022-01-31 00:51:37 +01:00

4.1 KiB

Raw Blame History

OrpheusDL - Tidal

A Tidal module for the OrpheusDL modular archival music program

Report Bug · Request Feature

Table of content

About OrpheusDL - Tidal
Getting Started
- Prerequisites
- Installation
Usage
Configuration
- Global
- Tidal
Contact
Acknowledgements

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

Already have OrpheusDL installed

Installation

Clone the repo inside the folder orpheusdl/modules/

git clone https://github.com/Dniel97/orpheusdl-tidal.git tidal

Execute:
```
python orpheus.py
```
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
    },
    "covers": {
	    "main_resolution": 1400
	    // ...
    }
    // ...
}

download_quality: Choose one of the following settings:

"hifi": FLAC with MQA up to 48/24
"lossless": FLAC with 44.1/16 (is MQA if the album is available in MQA)
"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

main_resolution: Tidal only supports 80x80, 160x160, 320x320, 480x480, 640x640, 1080x1080 and 1280x1280px (1280px won't work for playlists). If you choose 1400 or anything above 1280, it will get the highest quality even if the highest is 4000x4000px. That's because Tidal doesn't provide the "origin artwork" size, so the module will just get the largest.

Tidal

 "tidal": {
    "tv_token": "7m7Ap0JC9j1cOM3n",
    "tv_secret": "vRAdA108tlvkJpTsGZS8rGZ7xTlbJ0qaZ2K9saEzsgY=",
    "mobile_token": "dN2N95wCyEBTllu4",
    "enable_mobile": true,
    "prefer_ac4": false
}

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

prefer_ac4: If enabled and a mobile session is available (enable_mobile is set to true) this will ensure to get Dolby AC-4 on Dolby Atmos tracks

Contact

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

Dniel97 - @Dniel97

Project Link: OrpheusDL Tidal Public GitHub Repository

4.1 KiB Raw Blame History