浏览文档
指南
复制适用于视频、音频、字幕、数据集和采集恢复的命令。
本页内容
环境配置与命令约定
先安装当前的 nightly 版及全部依赖
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
python -m yt_dlp --list-impersonate-targets下载命令以 Deno 和 --impersonate="" 为基础。后者需要 curl-cffi,并会选择可用的浏览器指纹。Linux/macOS 命令使用 Bash 语法。对于定时任务,确保服务环境也能使用这些依赖。
这些终端示例使用 Python 安装的 yt-dlp。使用虚拟环境中的 Python,或将 python -m yt_dlp 换成独立的 yt-dlp 命令。建议优先使用 Linux,安装指南也提供 macOS 和 Windows 步骤。安装 FFmpeg/ffprobe 用于合并流,并安装 Deno 用于执行 YouTube 挑战脚本。将示例 URL 换成源视频地址。
| 公约 | 為什麼重要 |
|---|---|
| 引用URL和模板 | 屏幕不同的是,它会解释像 & 、空间和偏见这样的角色。 |
| 保持 %(ext)s 在文件名中 | 选择的媒体和后处理决定延伸。 |
| 使用 --no-playlist 为一个时钟 URL | 从播放列表链接的视频不应该意外地扩展你的工作。 |
| 查看您的保存配置 | 例子可以继承全球性配置,使用 --ignore-config 为隔离测试。 |
| Windows .bat:双模板百分比标志 | 使用 %(id)s 在集成文件中,但 %(id)s 在互动 PowerShell 和正常配置文件中。 |
视频质量和 MP4
基线: 最新的夜间, Deno 和 FFmpeg,与 --impersonate="". 命令示例使用 Bash; 取代样品 URL 与您的来源。
下载一个视频与默认选择
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
-o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"可用的格式列表
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
-F "https://www.youtube.com/watch?v=jNQXAC9IVRw"1080p 更喜欢
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"最大功率 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
-f "bv*[height<=1080]+ba/b[height<=1080]" "https://www.youtube.com/watch?v=jNQXAC9IVRw"H.264 视频和 AAC 音频在 MP4
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
-f "bv[vcodec^=avc1][height<=1080]+ba[acodec^=mp4a]/b[vcodec^=avc1][acodec^=mp4a][height<=1080]" \
--merge-output-format mp4 "https://www.youtube.com/watch?v=jNQXAC9IVRw"人工智能数据集: MP4 + 容器 + 元数据
最佳视频 + 音频, MP4, 录像和 元数据
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
-f "bestvideo+bestaudio/best" --merge-output-format mp4 --remux-video mp4 \
--write-info-json --write-subs --write-auto-subs --sub-langs "en" --sub-format "vtt/best" \
--sleep-subtitles 5 --concurrent-fragments 1 -P dataset -o "%(id)s/%(id)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"外部下载器: aria2c
兩個連接,原住民 DASH/HLS
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --downloader aria2c \
--downloader "dash,m3u8:native" --downloader-args "aria2c:-x 2 -s 2 -j 1" \
--concurrent-fragments 1 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"aria2有自己的网络实施。 yt-dlp的 curl-cffi的定义不配置 aria2的指纹。如果只有外部下载器失败,请使用 --downloader native 并比较相同的源和 proxy 路线。
音频和 MP3
保存原始音频流
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -P audio \
-o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"转换为 MP3 在目标比特率
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
--audio-format mp3 --audio-quality 192K -P audio \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"M4A 无代码
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f "ba[ext=m4a]" -P audio \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"MP3 包含集成数据和覆盖
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
--audio-format mp3 --embed-metadata --embed-thumbnail -P audio \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"字幕和字幕
可用的路线列表
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
--list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"下载提供的英语字幕仅
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
--sub-langs "en.*" --sub-format "vtt/best" -P captions -o "%(id)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"允许自动英语捕捉
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
--write-auto-subs --sub-langs "en.*" --sub-format "vtt/best" -P captions \
-o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"将所选的路径转换为 SRT
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
--write-auto-subs --sub-langs "en" --convert-subs srt -P captions \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"包含在 MKV 中提供的字幕
python -m yt_dlp --js-runtimes deno --impersonate="" --write-subs --sub-langs "en" \
--embed-subs --remux-video mkv -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"查询所有字符语言可以大大增加请求和文件的数量。保持所需的语言为日常工作明确。保存源代码和语言在数据集存储库中,以免从他们描述的媒体中分离过渡。
甲状数据和输出路径
将视频的数据打印为 JSON
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
--dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json写完整的甲状腺数据侧面,没有媒体
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-info-json \
-P metadata -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"下载小字只
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-thumbnail \
-P thumbnails -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"处理后打印最终媒体路径
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
--print after_move:filepath -P downloads -o "%(id)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"将完成的路径添加到一个示威
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
--print-to-file after_move:filepath completed-paths.txt -P downloads \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"时间范围和章节
此分類上一篇: 5 通過 10
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
--download-sections "*00:00:05-00:00:10" -o "clips/%(id)s-%(section_start)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"重新编码在所要求的切割
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
--download-sections "*00:00:05-00:00:10" --force-keyframes-at-cuts \
-o "clips/%(id)s-%(section_start)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"将分类视频分成文件
python -m yt_dlp --split-chapters -o "chapter:%(id)s-%(section_number)03d.%(ext)s" \
"https://www.youtube.com/watch?v=YOUR_VIDEO_ID"使用不同的输出政策或档案用于剪辑和完整的视频。 源级档案输入不会编码所选择的 start/end 时间,因此一个共享的档案可以删除您打算创建的后续剪辑。
播放列表和URL列表
下载已知的URL列表
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"查看YouTube播放列表,无需完整的视频提取
python -m yt_dlp --flat-playlist \
--dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl下载前五个播放列表的输入
python -m yt_dlp --playlist-items 1:5 -P collection -o "%(playlist_index)03d-%(id)s.%(ext)s" \
"https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID"根据日期和时间限制可用的视频
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
--batch-file urls.txt停止下载后10次下载
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt档案与恢复
重新编写同一政策的集合
python -m yt_dlp --download-archive archive.txt --continue --no-abort-on-error -P collection \
-o "%(id)s.%(ext)s" --batch-file urls.txt平安一个下载进程,并将退休的约束
python -m yt_dlp --sleep-requests 1 --sleep-interval 5 --max-sleep-interval 10 --retries 3 \
--fragment-retries 3 --socket-timeout 30 --batch-file urls.txt转换带宽
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"减少原生分裂竞争
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"配置和文件名
只需加载您的明确收藏配置
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt可读的名称与稳定身份
python -m yt_dlp --js-runtimes deno --impersonate="" -P downloads \
-o "%(channel_id)s/%(upload_date)s-%(title).150B [%(id)s].%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"使用单独的临时目录
python -m yt_dlp --js-runtimes deno --impersonate="" -P "home:downloads" -P "temp:work" \
-o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"对于长寿的收藏,决定是否应该是人可读或稳定的应用密钥。频道名称和标题可能会改变。Channel/video ID 是更好的 deduplication 关键,描述字段保留在 meta 数据中。
Cookies和运行时间路径
使用访问的浏览器配置文件
python -m yt_dlp --js-runtimes deno --impersonate="" \
--cookies-from-browser "chrome:Profile 1" \
--no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"阅读现有私人Cookie文件
python -m yt_dlp --js-runtimes deno --impersonate="" --cookies private/youtube-cookies.txt \
--no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"使用下载进程PATH外的Deno执行
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
--no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"诊断与验证
检查清洁的抽出
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
--no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"捕捉私人诊断记录
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
--no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw" > diagnostic.log 2>&1检查保存流和持续时间
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"解密保存的文件,而不创建输出
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -更新 Python 包并检查其版本
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version