yt-dlp - Arch Linux 中文维基

跳至內容

# yt-dlp

出自 Arch Linux 中文维基

相關文章

- mpv
- FFmpeg

翻譯狀態：

- 本文（或部分內容）譯自 yt-dlp，最近一次同步於 2025-10-03，若英文版本有所更改，則您可以幫助同步與翻譯更改的內容。
- 您可以在 ArchWiki 的對應頁面找到本文翻譯的原始修訂歷史。
- 本文可能與英文原文存在出入。

yt-dlp 是一款可讓您輕鬆從一千多個網站下載視頻和音頻的命令行程序。查看受支持的網站列表。

注意：yt-dlp 是 youtube-dl 的一個分支，創建於原項目停滯之後。上游的 youtube-dl 仍可通過 youtube-dlAUR 來安裝；本頁的命令通常仍可正常使用，但請參閱默認行為差異列表以了解具體區別。

## 安裝

安裝yt-dlp包。同時建議安裝 FFmpeg（用來封裝部分網站的文件），請參閱可選依賴項。

yt-dlp 還有各種圖形前端，如 tartubeAUR 和 yt-dlg-gitAUR。

您還可以安裝 yt-dlp-drop-inAUR，它提供了一個占位的 `/usr/bin/youtube-dl` 可執行文件（只是重定向到 yt-dlp），以兼容那些仍在尋找 youtube-dl 可執行文件的過時程序。

## 配置

系統全局配置文件是 `/etc/yt-dlp.conf`，用戶的配置文件為`~/.config/yt-dlp/config`。配置示例：

    --ignore-errors
    # --no-playlist

    # 保存至 ~/Videos
    -o ~/Videos/%(title)s.%(ext)s

    # 首选1080p或更低的分辨率
    -f bestvideo[height<=?1080]+bestaudio/best

更多信息請參見[1]

自定義配置文件也可以指定：

    $ yt-dlp URL --config-locations PATH

## 用法

請參見 yt-dlp(1) 手冊。

    $ yt-dlp [OPTIONS] URL

提示：在某些情況下（如 YouTube）`URL` 可以用視頻ID代替。

### 格式選擇

當多種格式的視頻可用時，yt-dlp將默認下載最好的格式。

獲取可用格式的列表：

    $ yt-dlp -F URL

選擇一個特定的要下載：

    $ yt-dlp -f format URL

### 提取音頻

使用`-x`下載音頻（需要 FFmpeg）：

    $ yt-dlp -x -f bestaudio URL

根據可用的源流，這通常可以修正純音頻容器。若無可用的純音頻流，請從上述示例中移除 `-f bestaudio` 參數。此操作會先下載視頻文件，並在後續處理中提取其音頻。默認情況下會刪除已下載的視頻文件，添加 `-k` 參數可保留視頻文件。

同時包括專輯封面：（需要atomicparsley包）：

    $ yt-dlp -x -f bestaudio[ext=m4a] --add-metadata --embed-thumbnail URL

### 字幕

查看哪些語言可用：

    $ yt-dlp --list-subs URL

下載帶有選定字幕（用逗號分隔）的視頻：

    $ yt-dlp --write-sub --sub-lang LANG URL

對於自動生成的字幕：

    $ yt-dlp --write-auto-sub --sub-lang LANG URL

添加`--skip-download`僅獲取字幕。

### Cookie

要導入 cookie，添加 `--cookies-from-browser <browser>`。

例如，從 chromium 導入：

    $ yt-dlp --cookies-from-browser chromium URL

## 方法與技巧

### 更快的下載

一些網站限制了傳輸速度。您通常可以通過選擇非DASH流或使用支持多連接下載的外部下載器 aria2 來繞過這種限制。例如：

    $ yt-dlp --downloader aria2c --downloader-args '-c -j 3 -x 3 -s 3 -k 1M' URL

### 播放列表

將 yt-dlp 用於播放列表通常歸結為以下選項：

    $ yt-dlp --ignore-errors --continue --no-overwrites --download-archive progress.txt usual options URL

這組選項允許下載在中斷後仍能有效繼續。如果您正在進行歸檔操作，請添加您可能需要的常規選項，例如 `--write-xxx` 和 `--embed-xxx`。

### 修剪（部分下載）

可以通過將 `yt-dlp -g -f format URL` 的輸出作為 ffmpeg 的輸入，並結合 `-ss`（用於輸入）、`-t` 和 `-c copy` 選項來下載視頻片段。

### 來自剪貼板的URL

可以通過設置一個 Shell 別名、桌面啟動器（英語：desktop launcher）或鍵盤快捷鍵，從 X Window 選區中輸出選中（或複製）的 URL 以下載視頻或音頻。具體方法可參閱剪貼板工具。

## 另請參閱

- GitHub 代碼倉庫

分類：​

- 下載工具
- 串流

yt-dlp
新增話題