selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
tidaloader logo

Self-host tidaloader

Self-hosted Tidal music downloader with playlist imports

BetaOpen SourceMIT
Docker ComposeCompose file & guide
docker compose up -d
Updated5 months ago
LanguageJavaScript
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
160
Port
8001 (Web UI and API)
Docker
ghcr.io/rayz3r0/tidaloader
Spotify Playlist Download screenTrack Search screenArtist Page full view

What is tidaloader?

Tidaloader lets you download music from Tidal in formats like FLAC Hi-Res, FLAC Lossless, Opus, MP3, and AAC. You can search for tracks, albums, artists, and playlists, or paste Tidal URLs directly. It imports Spotify playlists without track limits using SpotAPI, and pulls ListenBrainz recommendations like Weekly Jams and Year in Review. Monitored Tidal playlists sync automatically on a schedule. Your local library is organized by artist with cover art, metadata tags (MusicBrainz IDs, track numbers, release years), and optional lyrics from LrcLib. Beets integration can run after each download. The queue handles concurrent downloads with retries and persists across restarts. Over 20 themes are available with a light/dark toggle. The UI is responsive for mobile and desktop. Run it via Docker Compose, plain Docker, or manual install on Linux, macOS, Windows, or Android Termux. Authentication uses a built-in username/password.

Should you self-host tidaloader?

tidaloader scores 46/100 on selfhost.directory (how scoring works) and ranks #21 of 31 in Music. It has 160 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Beets (77/100, 15 857 stars). It scores higher overall, so compare the two before you pick. See tidaloader vs Beets side by side.

Features

  • Beets Integration
  • File organization templates
  • Group compilations
  • ListenBrainz playlist integration
  • Local library management
  • Lyrics Support
  • Monitored Tidal playlists
  • Multi-format audio downloads
  • Queue Management
  • REST API
  • Rich metadata tagging
  • Spotify playlist import
  • Theme Support
  • Tidal search and download

tidaloader README

How to install tidaloader

Install tidaloader with Docker Compose

Environment variables
MUSIC_DIR, AUTH_USERNAME, AUTH_PASSWORD, MAX_CONCURRENT_DOWNLOADS, QUEUE_AUTO_PROCESS, PLAYLISTS_DIR

services: tidaloader: image: ghcr.io/rayz3r0/tidaloader:latest container_name: tidaloader ports: - "8001:8001" environment: - MUSIC_DIR=/music - AUTH_USERNAME=admin - AUTH_PASSWORD=changeme - MAX_CONCURRENT_DOWNLOADS=3 - QUEUE_AUTO_PROCESS=true volumes: - ./music:/music restart: unless-stopped

docker compose up -d

Recommended installation method

More in Audio

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…