yt-dlp 视频下载器

功能概述

使用 yt-dlp 下载视频和音频，支持数千个网站：

视频平台: YouTube, Bilibili, 抖音, 快手, Twitter/X, Instagram, TikTok, Vimeo
社交媒体: 微博, 小红书, Facebook, Reddit
其他: TED,Coursera, 各种新闻网站等

默认下载位置

所有下载默认保存到: ~/Downloads/

使用方式

基础视频下载

当用户提供视频链接时，自动下载最佳质量的视频：

yt-dlp -o "~/Downloads/%(title)s.%(ext)s" "<VIDEO_URL>"

下载选项

1. 最佳质量视频（默认）

yt-dlp -f "bestvideo+bestaudio/best" \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "<VIDEO_URL>"

2. 仅下载音频（MP3）

yt-dlp -x --audio-format mp3 \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "<VIDEO_URL>"

3. 下载字幕

yt-dlp --write-subs --write-auto-subs --sub-lang zh-Hans,zh,en \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "<VIDEO_URL>"

4. 下载整个播放列表

yt-dlp -o "~/Downloads/%(playlist_title)s/%(title)s.%(ext)s" \
  "<PLAYLIST_URL>"

5. 查看可用格式

yt-dlp -F "<VIDEO_URL>"

6. 下载特定格式

yt-dlp -f "137+140" \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "<VIDEO_URL>"

常用参数说明

| 参数 | 说明 | |------|------| | -o | 输出文件名模板 | | -f | 格式选择 | | -F | 列出所有可用格式 | | -x | 仅提取音频 | | --audio-format | 音频格式 (mp3, m4a, etc.) | | --write-subs | 下载字幕 | | --write-auto-subs | 下载自动生成的字幕 | | --sub-lang | 字幕语言 | | --no-playlist | 不下载播放列表 | | --playlist-items | 下载播放列表中的特定项 | | --limit-rate | 限制下载速度 | | --proxy | 使用代理 |

文件名模板变量

| 变量 | 说明 | |------|------| | %(title)s | 视频标题 | | %(id)s | 视频ID | | %(ext)s | 文件扩展名 | | %(uploader)s | 上传者 | | %(upload_date)s | 上传日期 | | %(duration)s | 时长（秒） | | %(resolution)s | 分辨率 | | %(playlist_title)s | 播放列表标题 |

工作流程

当用户提供视频链接时：

解析链接: 确认网站类型和视频可用性
询问需求: 是否需要特定格式或质量
执行下载: 使用合适的参数下载
返回结果: 告知下载位置和文件名

示例交互

用户: 下载这个视频 https://www.youtube.com/watch?v=xxxxx

助手: 正在下载视频...

yt-dlp -f "bestvideo+bestaudio/best" \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "https://www.youtube.com/watch?v=xxxxx"

下载完成！文件保存在: ~/Downloads/视频标题.mp4

用户: 只要音频

助手: 正在提取音频...

yt-dlp -x --audio-format mp3 \
  -o "~/Downloads/%(title)s.%(ext)s" \
  "https://www.youtube.com/watch?v=xxxxx"

下载完成！文件保存在: ~/Downloads/视频标题.mp3

注意事项

某些网站可能需要登录或 cookies
部分地区可能需要代理
下载受版权保护的内容请遵守当地法律
Bilibili 等国内网站可能需要额外配置