Tidarr is a Docker image that provides a web interface to download up to 24-bit 192.0 kHz media (tracks, albums, playlists, music videos) from Tidal using Tiddl python binary. Format on the fly with Beets, automatically update your Plex library, push notifications, or use it as a Lidarr provider.

• Features
• Getting Started
• Tidal authentication
• Options
  • Download settings
  • PUID/PGID/UMASK
  • Password protection
  • OpenID Connect (OIDC) Authentication
  • Lock quality selector
  • Proxy
  • M3U track base path
  • Sync playlists and mixes
  • Custom CSS
  • Download History
  • Replay Gain
  • Playlist Albums
• Services:
  • Beets
  • Plex/Plexamp
  • Jellyfin
  • Navidrome search
  • Gotify
  • Ntfy
  • Apprise Api
  • Webhook push over
  • Lidarr connector
• Advanced
  • Custom Processing Script
  • No-download flag
  • API Documentation
• User requests
• Donate
• Develop

• Downloadable media : tracks, albums, playlists, mixes, music videos
• Max quality : FLAC, 24 bit 192.0 kHz (if available)
• Tidal trends content
• User playlists, mixes, favorites
• Search by keywords
• Search by url : artist url, album url, playlist url, track url, mix url
• Download covers
• Admin password
• Lidarr integration
• OpenID Connect (OIDC) authentication support
• M3U file for playlist with customizable path
• Watch and sync playlists, mixes, favorites and artists with cron
• Skip download if track exists
• Custom CSS
• Docker platforms:linux/amd64 and linux/arm64

• Beets.io - Tag releases
• Gotify - Push notifications
• Ntfy - Push notifications
• Apprise API - Push notifications
• Plex - Library update, search item button (album, track artiste)
• Jellyfin - Library update, search item button (album, track artiste)
• Navidrome - Library update, search item button (album, track artiste)
• Lidarr - [BETA] Use Tidarr as usenet indexer (download provider)
• Webhook push over - Push notifications using webhook (MatterMost)

• Song recognition : Shazarr project (Android)

• Server-side download list processing
• UI built with ReactJS + ExpressJS API
• Self-hostable with Docker (linux/amd64 and linux/arm64)
• Download Tidal content with Tiddl (3.2.0)

• REST API - Integrate Tidarr with external applications and automation tools
• Custom scripts - Execute your own shell scripts during post-processing pipeline (after download, before moving to library)

Example docker-compose.yml :

services:
  tidarr:
    image: cstaelen/tidarr
    container_name: "tidarr"
    ports:
      - 8484:8484
    volumes:
      - /any/folder/to/tidarr/config:/shared
      - /any/folder/to/library:/music
    restart: "unless-stopped"

or

docker run  \
		--rm \
		--name tidarr \
		-p 8484:8484 \
		-v /any/folder/to/tidarr/config:/shared \
		-v /any/folder/to/library:/music \
    cstaelen/tidarr:latest

(if no tiddl.json file provided) :

Authorize your device using the UI token dialog

or

docker compose exec -it -e tidarr tiddl auth login

or

docker exec -it -e tidarr tiddl auth

⚠️ Beware to set the right template path

To set your download options you can :

• use the UI configuration editor in settings dialog
• edit toml file /your/docker/path/to/tidarr/config/.tiddl/config.toml.

→ Tiddl config options

→ Tiddl path templating

environment:
  - ...
  - PUID=1234
  - PGID=123
  - UMASK=0022

If not set, no password is required to access the app.

environment:
  - ...
  - ADMIN_PASSWORD=<string> # if not set, no password are required to access

Tidarr supports OIDC authentication for integration with identity providers like Keycloak, PocketID, Authentik, etc.

When OIDC is configured, the login page will display a "Login with OpenID" button instead of the password field.

environment:
  - ...
  - OIDC_ISSUER=https://your-oidc-provider.com
  - OIDC_CLIENT_ID=tidarr
  - OIDC_CLIENT_SECRET=your-client-secret
  - OIDC_REDIRECT_URI=https://your-tidarr-domain.com/api/auth/oidc/callback

Force use of tiddl.json quality value and disable quality selector in app

environment:
  - ...
  - LOCK_QUALITY=true

Default base path used in .m3u : ./ You can custom base path used by track path in .m3u file :

environment:
  - ...
  - M3U_BASEPATH_FILE="../../"

Default value is daily sync at 3 am (0 3 * * *). You can set a custom cron expression using SYNC_CRON_EXPRESSION env var.

To run task at midnight (00:00) every Monday :

environment:
  - ...
  - SYNC_CRON_EXPRESSION="0 0 * * 1"

* Syntax:

• Minute (0 - 59)
• Hour (0 - 23)
• Day of the month (1 - 31)
• Month (1 - 12)
• Day of the week (0 - 7) (Sunday is both 0 and 7)

You can customize Tidarr's appearance using the UI in settings dialog, or by editing the custom.css file. This file is automatically created in your config folder on first launch.

File location: /your/docker/path/to/tidarr/config/custom.css

Track your downloaded items with the history feature. When enabled, Tidarr will maintain a list of all downloaded content and mark items as already downloaded in the UI.

environment:
  - ...
  - ENABLE_HISTORY=true

Features:

• Persistent download tracking across restarts
• Visual indicators for already downloaded items (green checkmark)
• Manual history clearing available in settings dialog

Enable automatic Replay Gain analysis for your music library. When activated, Tidarr will scan audio files and add loudness normalization metadata using FFmpeg and rsgain.

environment:
  - ...
  - REPLAY_GAIN=true

Automatically download complete albums for all tracks in a playlist. When enabled, Tidarr will extract unique album IDs from each track in the playlist and add them to the download queue.

environment:
  - ...
  - PLAYLIST_ALBUMS=true

Add to your docker-compose file in environment: section :

environment:
  - ...
  - ENABLE_BEETS=true

Beets options in </mounted/config/folder/>beets-config.yml:

You can active:

• Plex scan after download
• Plex search button on artist, album and track pages

Add to your docker-compose file in environment: section :

environment:
  - ...
  - PLEX_URL=<url|ip:port>
  - PLEX_LIBRARY=<music_library_id>
  - PLEX_TOKEN=<x-plex-token>
  # Plex path to the library root 
  - PLEX_PATH=/path/to/music/library

• PlexToken : your Plex token : https://www.plexopedia.com/plex-media-server/general/plex-token/
• Library ID : In Plex server web ui, go to your music library tab and check source= in the URL http://192.168.1.20:32400/web/index.html#!/media/abcdef12345678/com.plexapp.plugins.library?**source=3**
• Folder (optional) : path to folder to scan url (if not set, all music library will be scanned)

Doc : https://www.plexopedia.com/plex-media-server/api/library/scan-partial/

You can active:

• Jellyfin scan after download

Add to your docker-compose file in environment: section :

environment:
  - ...
  - JELLYFIN_URL=<url|ip:port>
  - JELLYFIN_API_KEY=<X-Emby-Token>

• Jellyfin API Key : your Jellyfin API Key : Go to Dashboard -> API Keys

You can activate:

• Navidrome scan after download
• Navidrome search button on artist, album and track pages

Add to your docker-compose file in environment: section :

environment:
  - ...
  - NAVIDROME_URL=http://navidrome.url
  - NAVIDROME_USER=navidrome_user
  - NAVIDROME_PASSWORD=navidrome_password

Add to your docker-compose file in environment: section :

environment:
  - ...
  - GOTIFY_URL=<url|ip:port>
  - GOTIFY_TOKEN=<gotify_app_token>

Add to your docker-compose file in environment: section:

environment:
  - ...
  - NTFY_URL=<url|ip:port>
  - NTFY_TOPIC=<ntfy_topic>
  - NTFY_TOKEN=<ntfy_token_security> # optional if it is not public
  - NTFY_PRIORITY=<ntfy_priority> # optional (default=3)

Add to your docker-compose file in environment: section :

environment:
  - ...
  - APPRISE_API_ENDPOINT=http://{apprise_api_url}:{port}/notify/{config_id}
  - APPRISE_API_TAG=tidarr # optional

If no tag is defined, default tag value will be "all".

Many push over services can be used as an URL to curl with a payload. Example with MatterMost :

curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Hello, this is some text\nThis is more text. 🎉"}' https://your-mattermost-server.com/hooks/xxx-generatedkey-xxx

You can set URL in Tidarr env vars

environment:
  - ...
  - PUSH_OVER_URL=https://your-mattermost-server.com/hooks/xxx-generatedkey-xxx

It should also works with other services using the same payload format {"text": "..."}.

Tidarr can be integrated with Lidarr as both a Newznab indexer and a SABnzbd download client. This allows you to leverage Lidarr's powerful library management while using Tidarr for high-quality music downloads from Tidal.

What you can do:

• Automatically search for albums in Tidal via Lidarr
• Trigger downloads directly from Lidarr
• Manage queue from Lidarr
• Use Lidarr post processing
• Manage your music library with Lidarr's metadata matching

services:
  tidarr:
    volumes:
      - ...
      - /path/to/lidarr/downloads:/shared/nzb_downloads  # Shared download location

  lidarr:
    volumes:
      - ....
      - /path/to/lidarr/downloads:/downloads             # Same physical folder

Tidarr supports executing a custom shell script during the post-processing pipeline. This allows you to perform custom operations on downloaded files before they are moved to your library.

If you want to use Tidarr only as UI and not download files, you can set NO_DOWNLOAD=true in the environment variables.

This way you can use Tidarr to manage your download history, watchlist, and keep benefits of json DB (sync_list.json, queue.json) to manage download via custom scripts.

If you want to interact with Tidarr from other applications (scripts, external services, automations), you can use the Express API.

As I'm the only maintainer for now, user requested features can take time.

1. Feel free to create an issue with enhancement or bug tag.
2. Be my guest, fork and dev !

If you would like to support this project, please do not hesitate to make a donation. It contributes a lot to motivation, gives me the energy to continue maintaining the project and adding the features requested by the users :)

Want more features and/or contribute ? Be my guest, fork and dev <3

Check docker environment variables in compose.yml before running :

make dev

Open http://localhost:3000 with your browser to see the result.

The docker-build Makefile target now relies on Docker Buildx so you can produce images for several architectures in one command.

• Build a multi-platform image (default: linux/amd64 and linux/arm64):

make docker-build IMAGE_TAG=latest BUILD_VERSION=1.2.3

• Build a custom platform image or local image for your host (example linux/arm64):

make docker-build PLATFORMS=linux/arm64 IMAGE_TAG=dev BUILD_VERSION=0.0.0-dev

Run tests :

make testing-build
make testing-run

• Renovate old torrent dl media library with full FLAC
• Just for coding
• Just for fun

• https://github.com/oskvr37/tiddl
• https://github.com/yaronzz/Tidal-Media-Downloader
• https://github.com/hmelder/TIDAL/wiki/search
• https://github.com/RandomNinjaAtk/arr-scripts (Lidarr extended scripts)