README.md

Tidal Downloader

TIDDL is Python CLI application that allows downloading Tidal tracks.

It's inspired by Tidal-Media-Downloader - currently not mantained project. This repository will contain features requests from that project and will be the enhanced version.

Warning

This app is for personal use only and is not affiliated with Tidal. Users must ensure their use complies with Tidal's terms of service and local copyright laws. Downloaded tracks are for personal use and may not be shared or redistributed. The developer assumes no responsibility for misuse of this app.

Installation

Install package using pip

pip install tiddl

Run the package cli with tiddl

$ tiddl

Usage: tiddl [OPTIONS] COMMAND [ARGS]...

  TIDDL - Download Tidal tracks ✨

Options:
  -v, --verbose  Show debug logs
  --help         Show this message and exit.

Commands:
	...

Basic usage

Login with Tidal account

tiddl auth login

Download track / album / artist / playlist

tiddl url https://listen.tidal.com/track/103805726 download
tiddl url https://listen.tidal.com/album/103805723 download
tiddl url https://listen.tidal.com/artist/25022 download
tiddl url https://listen.tidal.com/playlist/84974059-76af-406a-aede-ece2b78fa372 download

Tip

You don't have to paste full urls, track/103805726, album/103805723 etc. will also work

Set download quality and output format

tiddl ... download -q master -o "{artist}/{title} ({album})"

This command will:

• download with highest quality
• save track with title and album name in artist folder

Note

More about file templating on wiki.

Development

Clone the repository

git clone https://github.com/oskvr37/tiddl

Install package with --editable flag

pip install -e .

Run tests

python -m unittest

Resources

Tidal API wiki