ytdl-material

Download and watch video and audio from a web app you host yourself. Paste a link to download something, or subscribe to channels and playlists and new uploads show up automatically. Everything goes into a library you can watch from any browser, solo or together. It runs on yt-dlp, which it installs and updates for you. See the full feature list.

Documentation · Quick start · Troubleshooting

Setup

Docker

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: reference. See the NAS and ARM host guide for host-specific instructions.

Migration

For an existing installation, follow the migration guide before replacing your Compose file or changing database engines.

Build manually

See the install and build guide.

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.