1
# Arch Linux 示例
2
sudo pacman -Syu
3
sudo pacman -S yt-dlp ffmpeg nodejs

1
# ============================================================
2
# yt-dlp 配置文件
3
# ============================================================
4

5
# --- 网络与代理设置 ---
6
# 可以在命令行加 --proxy "URL"(URL为空不走代理)
7
--proxy ""
8

9
# 强制使用 IPv4，在很多地区，IPv4 的连接比 IPv6 更稳定，能有效解决 403 Forbidden 报错
10
--force-ipv4
11

12
# --- 验证与绕过限制 (重要) ---
13
# 从浏览器中读取 Cookie，这是绕过 429 (请求频繁) 和下载受限视频的关键
14
# 请改成已经登录过 YouTube 的浏览器
15
--cookies-from-browser firefox
16

17
# 指定 JS 运行时为 Node.js，用于处理 YouTube 的签名挑战，防止下载被限速
18
--js-runtime node
19

20
# 允许从 GitHub 自动获取最新的挑战解决脚本，确保在 YouTube 更新算法后依然有效
21
--remote-components ejs:github
22

23
# --- 视频质量与格式 ---
24
# 画质优先：下载最好的视频流(含VP9/AV1) + 最好的音频流，如果无法合并则选最好的单文件
25
-f "bestvideo+bestaudio/best"
26

27
# 强制合并格式为 MKV，MKV 兼容性极佳，能完美封装高清编码并支持多音轨、多字幕嵌入
28
--merge-output-format mkv
29
# 针对单流视频（如 m3u8），如果不是 mkv 则自动转封装为 mp4
30
--remux-video mp4
31

32
# 保持文件的原始修改时间 (如果不需要可以取消注释)
33
# --no-mtime
34

35
# --- 输出路径与文件名 ---
36
# 自定义下载文件的保存路径
37
# 逻辑：优先按播放列表存，没有则按网站域名存；文件名使用 "标题 [日期].后缀"
38
-o "~/Videos/youtube-dl/%(playlist_title,webpage_url_domain|SingleVideos)s/%(title)s [%(upload_date>%Y-%m-%d|Unknown)s].%(ext)s"
39

40
# --- 字幕设置 ---
41
# 默认下载并嵌入字幕
42
--write-subs
43
--embed-subs
44
# 如果想要字幕和视频文件分离，可以在命令行加 --no-embed-subs
45
# --no-embed-subs
46

47
# 下载每个字幕文件之间暂停 5 秒，这是防止 YouTube 识别并封锁 IP 的重要安全措施
48
--sleep-subtitles 5
49

50
# 语言设置：匹配 B 站 AI 字幕 (ai-zh) 及各类中英文字幕
51
--sub-langs ".*zh.*,.*en.*,-danmaku"
52

53
# --- 元数据与附加信息 ---
54
# 在视频文件中嵌入元数据，如视频描述、上传者信息等
55
--embed-metadata
56

57
# 在视频中嵌入章节信息 (如果视频原作者划分了时间轴)
58
--embed-chapters
59

60
# --- 多线程下载 ---
61
# 使用 aria2c 作为外部下载器以实现多线程下载（需安装aria2c）
62
#--external-downloader aria2c
63
#--downloader-args "aria2c:-x 16 -s 16 -k 1M"
64

65
# ffmpeg_i 确保 -allowed_extensions ALL 作用于输入文件之前
66
--downloader-args "ffmpeg_i:-allowed_extensions ALL"
67

68
# 开启内置并发分片下载 (作为 aria2 的补充或备选)
69
--concurrent-fragments 10
70

71
# 忽略地理位置限制
72
--geo-bypass