# 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**:
   ```bash
   git clone <repository-url>
   cd tidal-dl-web
   ```

2. **Start the application**:
   ```bash
   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`:

```yaml
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](https://github.com/exislow/tidal-dl-ng).