TIDDL 3.0 is here!

Feel free to test this version and let us know if you are missing any features or if there are bugs!

⚠️ Remember that you have to login again if you were using tiddl 2.0 before.

Major Changes

• Before we were using click, now we are using typer for much cleaner command line interface
• Python 3.13 is now required, (3.12 could be working tho)
• Source code is separated into core and cli

App Directory

Now tiddl files are located at your home path in .tiddl folder

api_cache.sqlite (API cache database)
auth.json (Tidal token data)
config.toml (your config)
latest.log (latest debugging logs)
/debug_data (debugging API endpoints)

New Configuration File

Now we are using .toml instead of .json file for configs. Every option is explained with comments as .toml files allows it.

There are templates, download, metadata, cover and m3u options to configure exactly how you want!

Command Line Interface

• Currently only url subcommand is available with download command
• Now you have to type download first, then url (tiddl download url <url>)
• If your terminal supports links, then after download, you can click filename directly in your terminal and it will open the downloaded item
• New file templating system

Documentation

• New templating docs
• Example config with explained options

Other Important Changes

⚠️ master quality is now called max quality