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!). You can use the command line or GUI version of this tool.

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

🧁 Features

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

▶️ Getting started with development

🚰 Install dependecies

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:

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.

✨ Releasing a new version

  • Create an API Token on Pypi.
  • Add the API Token to your projects secrets with the name PYPI_TOKEN by visiting this page.
  • Create a new release on Github.
  • Create a new tag in the form *.*.*.

For more details, see here.

‼️ Dislaimer

  • 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! 1

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.4.17.tar.gz (188.6 kB view details)

Uploaded Source

Built Distribution

tidal_dl_ng-0.4.17-py3-none-any.whl (190.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: tidal_dl_ng-0.4.17.tar.gz
  • Upload date:
  • Size: 188.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.7 Linux/6.2.0-1018-azure

File hashes

Hashes for tidal_dl_ng-0.4.17.tar.gz
Algorithm Hash digest
SHA256 1bf51672416a66cab6f95f551dd6e6f90f3230de22bf5307b25df85f7462e784
MD5 ec0ea805f5d6092ef1e88f1529ae8958
BLAKE2b-256 125b052f4876821dff8db2cd3f0ec5b7bf207e632cdf060f7fc860a3a9469958

See more details on using hashes here.

File details

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

File metadata

  • Download URL: tidal_dl_ng-0.4.17-py3-none-any.whl
  • Upload date:
  • Size: 190.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.7 Linux/6.2.0-1018-azure

File hashes

Hashes for tidal_dl_ng-0.4.17-py3-none-any.whl
Algorithm Hash digest
SHA256 493a6fc767e1e7b4643848e755799ccde5cddf6dada3bf89909a8deeacbb103b
MD5 fec8c7f85672e5f94d6fcfc114cbd5c5
BLAKE2b-256 12d760890a2dfb80c619c077a89d6c143a8d62b7540af67a629e2d4f053d457e

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