Tidal DL Web

A modern web interface for downloading music from Tidal, built on top of tidal-dl-ng.

⚠️ Disclaimer

This project is for educational purposes only. I am not responsible for any problems, damages, or legal issues that may arise from using this software. Use at your own risk and ensure you comply with Tidal's Terms of Service and all applicable laws in your jurisdiction.

Features

• Web Interface: Clean and responsive dashboard to manage your downloads.
• Search: Search for Tracks, Albums, Artists, and Playlists.
• Grouped Results: Search results are organized by Album or Artist for easy navigation.
• Download Queue: Monitor your downloads with detailed progress (Track X of Y, Percentage).
• Controls: Pause, Resume, and Cancel downloads directly from the queue.
• Dockerized: Easy to deploy and run using Docker.

Installation & Usage

Prerequisites

• Docker and Docker Compose installed on your machine.
• A valid Tidal account (subscription required for high quality).

Running with Docker

1. Clone the repository:

   git clone <repository-url>
   cd tidal-dl-web
   

2. Start the application:

   docker-compose up -d
   

3. Access the Web UI: Open your browser and navigate to http://localhost:8002.

4. Login: Follow the on-screen instructions to authenticate with your Tidal account using the device login flow.

Configuration

You can configure the download path in docker-compose.yml:

environment:
  - DOWNLOAD_PATH=/app/downloads
volumes:
  - ./downloads:/app/downloads

• DOWNLOAD_PATH: The internal path where files are saved in the container.
• ./downloads:/app/downloads: Maps the local downloads folder to the container's download directory.

Development

To run in development mode with live reloading:

The docker-compose.yml is already configured to mount the app directory and enable reload. Just make changes to the code, and the server will auto-restart.

Credits

Based on tidal-dl-ng.