ytdl-material

ytdl-material is a full suite UI for yt-dlp. It's coded using Angular 22 for the frontend, and Node.js on the backend. See a list of features here.

Docker

Setup

1. Download docker-compose.yml:

curl -L https://raw.githubusercontent.com/voc0der/ytdl-material/refs/heads/main/docker-compose.yml -o docker-compose.yml

1. Start it:

docker compose pull   # if needed
docker compose up -d

Docker environment variables: docker-environment.md. See Wiki for host-specific instructions.

Migration

If migrating from YoutubeDL-Material, download docker-compose-youtubedl-material.yml instead.

Build manually

See the install and build guide.

API

Generate an API token from Your Profile to let scripts and other apps act as you. Send it as Authorization: Bearer <token>. RSS feeds use a separate feed-only token generated by the RSS dialog. Enable API documentation in Settings -> Extra and restart for endpoint details.

Contributing

Review CONTRIBUTING.md for contributor guidelines; pull requests and issues for bugs or feature requests are welcome.

Legal Disclaimer

This project is in no way affiliated with Google LLC, Alphabet Inc. or YouTube (or their subsidiaries) nor endorsed by them.