> For AI agents: the complete documentation index is available at https://www.tteam.icu/llms.txt, the full documentation bundle is available at https://www.tteam.icu/llms-full.txt.

# metube

MeTube 是基于 `yt-dlp` 的自托管视频下载 Web 界面，适合把下载任务放到服务器上统一管理。

## 安装

它可以作为 YouTube 及其他网站的视频下载器使用，本质上是 `youtube-dl / yt-dlp` 的网页界面。

```yaml file="./metube/docker-compose.yml" title="docker-compose.yml"
services:
  metube:
    image: ghcr.io/alexta69/metube
    container_name: metube
    restart: unless-stopped
    network_mode: host
    environment:
      - PORT=8081
    volumes:
      - ./downloads:/downloads
```

## yt-dlp

::: warning
使用下载工具时，需要自行确认目标站点条款和当地法律要求，尤其要注意版权和知识产权限制。
:::

`yt-dlp` 是一个免费开源的视频下载工具，基于已停止维护的 `youtube-dlc` 继续发展，支持 YouTube、Vimeo 等多个站点，并提供更多格式选择和后处理能力。

### 安装

需要先安装 `ffmpeg`，否则合并音视频、转码和封装格式时可能失败。

在 [yt-dlp](https://github.com/yt-dlp/yt-dlp) 的 [release](https://github.com/yt-dlp/yt-dlp/releases) 页面下载对应系统的二进制文件，解压后得到 `yt-dlp`，再移动到 `/usr/local/bin` 目录即可。

### 常用命令

```bash
yt-dlp \
  -f bestvideo+bestaudio/best \
  --paths /data/tmp \
  --exec "mv {} /nfs/data/" \
  'https://www.youtube.com/@xxx'
```

这个示例会选择最佳视频和音频，下载到 `/data/tmp`，完成后移动到 `/nfs/data/`。