KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

ytdl-material

★ 34 Open GitHub ↗

Self-hosted YouTube downloader built on Material Design

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>
  <img src="./src/assets/images/logo_64px.png" alt="ytdl-material logo" width="32" />
  ytdl-material
</h1>

[![Docker pulls badge](https://img.shields.io/docker/pulls/voc0der/ytdl-material.svg)](https://hub.docker.com/r/voc0der/ytdl-material)
[![Docker image size badge](https://img.shields.io/docker/image-size/voc0der/ytdl-material?sort=date)](https://hub.docker.com/r/voc0der/ytdl-material)
<a href="https://github.com/voc0der/ytdl-material/tree/main/backend/test">
  <img src="https://img.shields.io/badge/coverage-46.0%25-red" alt="Code coverage percentage" />
</a>
[![GitHub issues badge](https://img.shields.io/github/issues/voc0der/ytdl-material)](https://github.com/voc0der/ytdl-material/issues)
[![License badge](https://img.shields.io/github/license/voc0der/ytdl-material)](https://github.com/voc0der/ytdl-material/blob/main/LICENSE.md)
[![Version badge](https://img.shields.io/github/v/release/voc0der/ytdl-material?display_name=tag)](https://github.com/voc0der/ytdl-material/releases/latest)
[![Dependencies badge](https://github.com/voc0der/ytdl-material/actions/workflows/dependencies.yml/badge.svg?branch=main)](https://github.com/voc0der/ytdl-material/actions/workflows/dependencies.yml)

ytdl-material is a full suite UI for [yt-dlp](https://github.com/yt-dlp/yt-dlp). It's coded using [Angular 21](https://angular.dev/) for the frontend, and [Node.js](https://nodejs.org/) on the backend. See a list of features [here](https://github.com/voc0der/ytdl-material/wiki/Features).

<hr>

## Docker

### Setup

1. Download [docker-compose.yml](https://github.com/voc0der/ytdl-material/blob/main/docker-compose.yml):

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

2. Start it:

```bash
docker compose pull   # if needed
docker compose up -d
```

Docker environment variables: [docker-environment.md](./docker-environment.md). See [Wiki](https://github.com/voc0der/ytdl-material/wiki#environment-specific-guideshelp) for host-specific instructions.

#### Migration
If migrating from [YoutubeDL-Material](https://github.com/Tzahi12345/YoutubeDL-Material), download [docker-compose-youtubedl-material.yml](https://github.com/voc0der/ytdl-material/blob/main/docker-compose-youtubedl-material.yml) instead.

#### Build manually
See the [install and build guide](./install-and-build.md).

## API

Enable the public API in Settings -> *Extra*, generate an API key if needed, then enable API docs (restart required) for endpoint details.

## Contributing

Review [CONTRIBUTING.md](./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.

ytdl-material

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README