tiddl-gui

Download Tidal tracks, albums, and playlists at maximum quality — straight from your browser.

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.

Live app: https://19jvjeffery.github.io/tiddl-gui/web/index.html

No installation needed — open the link and go.

How to use

1 — Log in

Open the Account tab and click Login with Tidal.

A Tidal authorisation page opens in a new tab. Approve it there, then return — the app polls automatically and logs you in. Your token is stored in localStorage and refreshed automatically; nothing is ever sent to a third-party server.

2 — Download

Open the Download tab and paste any of the following:

Input format	Example
Full Tidal URL	https://tidal.com/browse/track/103805726
Track	track/103805726
Album	album/103805723
Playlist UUID	playlist/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Mix ID	mix/0123456789abcdef

Select a quality level and click Download. Files are saved directly to your browser's downloads folder.

Quality	Format	Details
Low	.m4a	96 kbps
High	.m4a	320 kbps
Lossless	.flac	16-bit, 44.1 kHz
Max	.flac	Up to 24-bit, 192 kHz

Note

Lossless / Max quality requires an eligible Tidal subscription. Encrypted (DRM) streams cannot be saved in the browser.

3 — Search

Open the Search tab, type an artist, track, album, or playlist name, and press Search. Click a track to add it to the download queue, or click an artist, album, or playlist card to browse its contents and download items individually or all at once.

4 — Library

Open the Library tab (requires sign-in) to browse your saved tracks, albums, and playlists.

5 — CORS proxy

Tidal's API blocks direct browser requests. All API calls are routed through a CORS proxy; the default is corsproxy.io and needs no setup.

To use a different proxy, open Settings and update the Proxy prefix URL field.

Run locally

git clone https://github.com/19JVJeffery/tiddl-gui.git
cd tiddl-gui
python3 -m http.server 8080 --directory web

Open http://localhost:8080. Any static file server works (npx serve web, npx http-server web, etc.).

Credits

tiddl-gui is a browser-based GUI built on top of the original tiddl command-line tool by oskvr37. The API integration and download logic are inspired by that project.