This tool allows to download songs and videos from TIDAL. A paid plan is required! Audio quality varies up to HiRes Lossless / TIDAL MAX 24 Bit, 192 kHz depending on the song available. You can use the command line or GUI version of this tool.
$ 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 :-)
Requirements: Python 3.11 or 3.12 (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/46755209But also the GUI:
tidal-dl-ng-gui
# OR
tdng
# OR
tidal-dl-ng guiIf you like to have the GUI version only, have a look at the release page and download the correct version for your platform.
- Download Tracks, Videos, Albums, Playlists
- Metadata for songs
- Adjustable audio and video download quality.
Clone this repository and install the dependencies:
poetry install --all-extras --with dev,docsThe main entry points are:
tidal_ng_dl/cli.py
tidal_ng_dl/gui.pyThe GUI is build with PySide6 using the Qt Designer:
PYSIDE_DESIGNER_PLUGINS=tidal_dl_ng/ui pyside6-designerAfter 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
To build the project use this command:
make installThe 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.
- 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.
Thanks to all, who have contributed to this project!
This project is based on:
- https://fpgmaas.github.io/cookiecutter-poetry/
