Skip to main content

TIDAL Medial Downloader Next Generation!

Project description

๐Ÿ”ฐ TIDAL Downloader Next Generation! (tidal-dl-ng)

Release Build status Commit activity License

This tool allows to download songs and videos from TIDAL. A paid plan is required! Audio quality varies up to HiRes / TIDAL MAX 24 Bit, 192 kHz depending on the song and your TIDAL plan. You can use the command line or GUI version of this tool.

App Image

$ tidal-dl-ng --help

 Usage: tidal-dl-ng [OPTIONS] COMMAND [ARGS]...

โ•ญโ”€ Options โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚ --version  -v                                                                โ”‚
โ”‚ --help     -h        Show this message and exit.                             โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ
โ•ญโ”€ Commands โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚ cfg    Print or set an option. If no arguments are given, all options will   โ”‚
โ”‚        be listed. If only one argument is given, the value will be printed   โ”‚
โ”‚        for this option. To set a value for an option simply pass the value   โ”‚
โ”‚        as the second argument                                                โ”‚
โ”‚ dl                                                                           โ”‚
โ”‚ gui                                                                          โ”‚
โ”‚ login                                                                        โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

If you like this projects and want to support it, you can buy me a coffee :-)

Buy Me A Coffee 61e11d430afb112ea33c3aa5_Button-1-p-500

๐Ÿ’ป Installation / Upgrade

Requirements: Python 3.11 (other versions might work but are not tested!)

pip install --upgrade tidal-dl-ng
# AND if you like to have the GUI as well
pip install --upgrade tidal-dl-ng[gui]

You can use the command line (CLI) version to download media:

tidal-dl-ng dl https://tidal.com/browse/track/46755209
# OR
tdn dl https://tidal.com/browse/track/46755209

But also the GUI:

tidal-dl-ng-gui
# OR
tdng
# OR
tidal-dl-ng gui

If you like to have the GUI version only, have a look at the release page and download the correct version for your platform.

๐Ÿง Features

  • Download Tracks, Videos, Albums, Playlists
  • Metadata for songs
  • Adjustable audio and video download quality.

โ–ถ๏ธ Getting started with development

๐Ÿšฐ Install dependencies

Clone this repository and install the dependencies:

poetry install --all-extras --with dev,docs

The main entry points are:

tidal_ng_dl/cli.py
tidal_ng_dl/gui.py

๐Ÿ“บ GUI Builder

The GUI is build with PySide6 using the Qt Designer:

PYSIDE_DESIGNER_PLUGINS=tidal_dl_ng/ui pyside6-designer

After all changes are saved you need to translate the Qt Designer *.ui file into Python code:

pyside6-uic tidal_dl_ng/ui/main.ui -o tidal_dl_ng/ui/main.py

๐Ÿ— Build the project

To build the project use this command:

make install

The CI/CD pipeline will be triggered when you open a pull request, merge to main, or when you create a new release.

To finalize the set-up for publishing to PyPi or Artifactory, see here. For activating the automatic documentation with MkDocs, see here. To enable the code coverage reports, see here.

โ€ผ๏ธ Disclaimer

  • For educational purposes only. I am not liable and responsible for any damage that happens.
  • You should not use this method to distribute or pirate music.
  • It may be illegal to use this app in your country.

๐Ÿซ‚ Contributors

Thanks to all, who have contributed to this project!

This project is based on:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tidal_dl_ng-0.12.5.tar.gz (274.6 kB view details)

Uploaded Source

Built Distribution

tidal_dl_ng-0.12.5-py3-none-any.whl (279.6 kB view details)

Uploaded Python 3

File details

Details for the file tidal_dl_ng-0.12.5.tar.gz.

File metadata

  • Download URL: tidal_dl_ng-0.12.5.tar.gz
  • Upload date:
  • Size: 274.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.11.8 Linux/6.5.0-1016-azure

File hashes

Hashes for tidal_dl_ng-0.12.5.tar.gz
Algorithm Hash digest
SHA256 3ca50f1d7d704f2ba9451851ec567dba1935f9f980a00410fa58d2c9efc6c9df
MD5 7b913b667d2b3f5a82225c2f706601f6
BLAKE2b-256 4d9742a4f922fcc8781641d8d93b222b72c7db1c5de47d94468b12accf7888f0

See more details on using hashes here.

File details

Details for the file tidal_dl_ng-0.12.5-py3-none-any.whl.

File metadata

  • Download URL: tidal_dl_ng-0.12.5-py3-none-any.whl
  • Upload date:
  • Size: 279.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.11.8 Linux/6.5.0-1016-azure

File hashes

Hashes for tidal_dl_ng-0.12.5-py3-none-any.whl
Algorithm Hash digest
SHA256 60db6195e14279ccfc5c7163552e1278bbba8bc597f9b3bd66a56d743a069458
MD5 e9f7aab87cd39e5b8fd0247e05b9d40b
BLAKE2b-256 3ec507245418e9aadde598c1547f818550b6ae1622f582f52ba2535ab673203f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page