普通视图

yt-dlp:一款功能丰富的命令行音频/视频下载器

2025年12月18日 19:49

yt-dlp 是一个功能强大的命令行工具,用于从各种网站下载视频、音频和其他媒体内容。它支持的站点非常广泛,涵盖了全球范围内的主流媒体平台、社交媒体平台、新闻网站、教育平台等。

yt-dlp

yt-dlp 简介

  • 项目名称:yt-dlp
  • 项目地址https://github.com/yt-dlp/yt-dlp
  • 项目描述:yt-dlp 是一款功能丰富的命令行音频/视频下载器,支持数千个网站。它是基于现已停止维护的 youtube-dlc 开发的 youtube-dl 分支。
  • 项目状态:活跃开发中,最新版本为 2025.12.08,拥有 139k 颗星和 11.2k 个分叉。
  • 项目特点
    • 支持多种网站的音频/视频下载。
    • 提供丰富的命令行选项,用于定制下载行为。
    • 支持多种格式选择、后处理(如提取音频、嵌入元数据等)。
    • 支持从浏览器导入 cookies,便于登录下载。
    • 支持 SponsorBlock,可用于去除 YouTube 视频中的赞助部分。

安装方法

  • 二进制文件:提供多种平台的预编译二进制文件,包括 WindowsLinuxMacOS 等。
  • pip 安装:可通过 Python 的包管理工具 pip 安装。
  • 其他包管理器:支持通过 Homebrew(MacOS)、Chocolatey(Windows)等第三方包管理器安装。

下载地址

文件 描述
yt-dlp 平台无关的zipimport二进制文件。需要 Python(推荐用于Linux/BSD)。
yt-dlp.exe Windows(Win8+)独立 x64 二进制文件(推荐用于Windows
yt-dlp_macos 通用 macOS (10.15+) 独立可执行文件(推荐用于macOS

使用方法

  • 基本命令yt-dlp [OPTIONS] [--] URL [URL...]
  • 常用选项
    • -f:指定下载的视频格式。
    • -o:指定输出文件名模板。
    • -P:指定下载路径。
    • -x:提取音频。
    • --embed-thumbnail:将缩略图嵌入视频文件。
    • --write-info-json:将视频元数据写入 .info.json 文件。
  • 高级功能
    • 支持通过 .netrc 文件进行身份验证。
    • 支持自定义配置文件,可放置在多个位置(如用户目录、系统目录等)。
    • 支持插件系统,可扩展功能。

配置文件

  • 配置文件位置
    • 主配置文件:通过 --config-locations 指定。
    • 便携配置文件:与可执行文件同目录下的 yt-dlp.conf
    • 用户配置文件:~/.config/yt-dlp/yt-dlp.conf~/.yt-dlp.conf
    • 系统配置文件:/etc/yt-dlp/yt-dlp.conf
  • 配置文件格式:支持命令行选项的格式,例如 -x--embed-thumbnail 等。

输出模板

  • 模板语法:使用 %(字段)s 格式,支持多种字段,如 titleidext 等。
  • 特殊功能
    • 支持日期时间格式化,如 %(upload_date>%Y-%m-%d)s
    • 支持条件表达式,如 %(field|默认值)s
    • 支持字段替换和解析,通过 --parse-metadata--replace-in-metadata

格式选择

  • 默认行为:下载最佳质量的视频和音频。
  • 格式选择语法
    • 使用 -f 指定格式,如 bv*+ba/b
    • 支持过滤和排序,如 -S 选项。
    • 支持多种格式,如 mp4webm 等。
  • 高级用法
    • 支持下载多个格式并合并。
    • 支持下载特定分辨率或比特率的格式。

后处理选项

  • 提取音频:通过 -x 选项提取音频。
  • 嵌入元数据:通过 --embed-metadata 嵌入元数据到视频文件。
  • 转换格式:支持将视频转换为其他格式,如 --remux-video
  • 处理字幕:支持下载和嵌入字幕。

插件系统

  • 插件类型:支持提取器插件和后处理插件。
  • 安装方法:可通过配置目录、pip 或其他方式安装插件。
  • 开发指南:提供插件开发指南和示例代码。

兼容性选项

  • 与 youtube-dl 兼容:提供 --compat-options 选项,用于恢复与 youtube-dl 相同的行为。
  • 与 youtube-dlc 兼容:同样支持与 youtube-dlc 的兼容性设置。

很抱歉,我无法直接访问网页链接。不过,根据您提供的文件内容,我可以为您整理一份关于 yt-dlp 支持的站点的详尽笔记。

支持的站点分类

以下是根据功能和类型对支持的站点进行的分类整理:

1. 主流视频平台
  • YouTube:支持下载视频、播放列表、用户视频、搜索结果等。
  • Bilibili:支持下载视频、音频、有声专辑、收藏列表等。
  • TikTok:支持下载视频、用户视频、直播等。
  • Dailymotion:支持下载视频、播放列表、用户视频等。
  • Vimeo:支持下载视频、播放列表、用户视频等。
2. 社交媒体平台
  • Facebook:支持下载视频、广告、故事等。
  • Instagram:支持下载视频、用户视频、故事等。
  • Twitter:支持下载视频、直播、推文中的视频等。
  • Twitch:支持下载直播、视频、剪辑等。
3. 新闻媒体平台
  • CNN:支持下载新闻视频。
  • BBC:支持下载 BBC iPlayer 视频。
  • Fox News:支持下载新闻视频。
  • The New York Times:支持下载视频。
4. 教育平台
  • Khan Academy:支持下载课程视频。
  • Coursera:支持下载课程视频。
  • Udemy:支持下载课程视频。
  • edX:支持下载课程视频。
5. 音乐平台
  • Spotify:支持下载音乐、播放列表等。
  • SoundCloud:支持下载音乐、播放列表、用户音乐等。
  • QQ Music:支持下载音乐、专辑、MV 等。
  • NetEase Cloud Music:支持下载音乐、专辑、MV 等

其他信息

  • 支持站点列表:可在 supportedsites.md 查看支持的站点列表。
  • 文档:提供详细的 Wiki 文档。
  • 社区支持:可通过 Discord 获取社区支持。
❌