yt-dlp - 强大的命令行音视频下载工具

应用简介

yt-dlp 是一个功能丰富的命令行音频/视频下载器，支持数千个网站。该项目是基于现已不活跃的 youtube-dlc 项目的一个分支，源自著名的 youtube-dl。它专为需要在 macOS（及其他操作系统）上高效、灵活地下载网络媒体内容的用户设计。

官方网站

• GitHub 仓库: https://github.com/yt-dlp/yt-dlp
• 社区 Discord: discord.gg/H5MNcFW63r

核心功能特点

1. 广泛的网站支持

• 支持从数千个网站下载视频和音频，包括 YouTube, Bilibili, Netflix, Twitch, Twitter, Facebook, TikTok 等主流与地区性平台。
• 高度可扩展的提取器架构，能够快速适配新网站或网站改版。

2. 强大的格式选择与处理

• 智能格式选择：自动选择最佳的视频和音频组合（如最高质量、最佳编码），也可自定义选择规则。
• 格式过滤与排序：支持按分辨率、编码器、帧率、文件大小等条件筛选和排序可用格式。
• 合并与转码：自动下载并合并独立的视频流和音频流（如 m4a + webm），并可选择使用 ffmpeg 进行后处理转码。

3. 丰富的下载控制选项

• 断点续传：支持恢复中断的下载。
• 限速下载：可设置最大下载速度，避免占用全部带宽。
• 下载列表与归档：支持从播放列表、频道或用户主页下载，并可利用归档文件避免重复下载。
• 片段下载：支持仅下载视频的特定时间段。

4. 全面的元数据与字幕处理

• 嵌入元数据：可将标题、描述、上传者、上传日期、缩略图等信息嵌入到下载的文件中（如 MP4 的 moov atom，MKV 的 metadata）。
• 字幕下载：支持下载和嵌入多种格式的字幕（SRT, ASS, VTT 等），包括自动生成的字幕。
• 缩略图处理：可下载并将视频缩略图嵌入为封面或保存为单独文件。

5. 灵活的输出控制

• 自定义输出模板：使用强大的模板系统自定义保存文件的文件名和路径结构，可包含标题、ID、上传者、分辨率等变量。
• 后处理钩子：支持在下载完成后执行自定义命令或脚本（如调用其他工具进行二次处理）。

6. 高级特性

• SponsorBlock 集成：通过集成 SponsorBlock API，可自动跳过视频中的赞助、互动提醒等片段（需用户选择类别）。
• Cookies 与认证：支持导入浏览器 Cookies 文件以访问需要登录或年龄验证的内容。
• 插件系统：支持开发和使用插件以扩展功能，例如添加对新网站的支持或自定义后处理逻辑。

在 macOS 上的优势

1. 原生兼容与高性能：

   • 提供 yt-dlp_macos 通用 macOS (10.15+) 独立可执行文件，无需安装 Python 环境即可运行，开箱即用。
   • 作为命令行工具，资源占用极低，无需图形界面开销，尤其适合服务器或作为自动化脚本的一部分。

2. 深度系统集成：

   • 可轻松与 zsh、bash 等 macOS 默认 shell 集成，通过别名 (alias) 简化常用命令。
   • 可与 cron 计划任务或 launchd 结合，实现定时自动下载。
   • 可无缝衔接 macOS 上强大的多媒体处理生态，如与 ffmpeg (可通过 brew 安装) 完美配合进行格式转换、合并等后处理。

3. 强大的自动化能力：

   • 通过编写 Shell 脚本或使用 Automator，可以构建复杂的媒体抓取和工作流。
   • 配置文件 (yt-dlp.conf) 可以集中管理常用选项，避免重复输入长命令。

4. 活跃的社区与持续更新：

   • 作为 youtube-dl 的活跃分支，更新非常频繁，能快速应对各大视频网站的改动。
   • 拥有庞大的用户和开发者社区，问题解决和功能请求响应迅速。

安装方法（macOS 推荐）

1. 直接下载独立可执行文件 (推荐):

   • 访问 GitHub Releases 页面，下载 yt-dlp_macos 文件。
   • 在终端中，将其移动到可执行路径并赋予权限：

   sudo mv ~/Downloads/yt-dlp_macos /usr/local/bin/yt-dlp
   sudo chmod a+rx /usr/local/bin/yt-dlp
   

2. 使用 Homebrew 安装:

   brew install yt-dlp
   

3. 使用 pip 安装 (需 Python):

   python3 -m pip install -U yt-dlp
   

基础使用示例

# 下载一个视频（最佳可用质量）
yt-dlp https://www.youtube.com/watch?v=VIDEO_ID

# 下载为最佳 MP4 格式（如果可能）
yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" https://youtu.be/VIDEO_ID

# 仅下载音频并转换为 MP3
yt-dlp -x --audio-format mp3 https://youtu.be/VIDEO_ID

# 下载整个播放列表
yt-dlp --yes-playlist https://www.youtube.com/playlist?list=PLAYLIST_ID

# 使用自定义文件名模板下载
yt-dlp -o '%(uploader)s/%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s' https://youtu.be/VIDEO_ID

总结

yt-dlp 是 macOS 命令行用户和高级媒体管理者的首选下载工具。它将强大的灵活性、对海量网站的支持以及高效的性能完美结合。对于不畏惧终端、追求自动化且需要从互联网获取媒体内容的用户来说，yt-dlp 是一个不可或缺的瑞士军刀式工具。通过其详细的配置选项和活跃的社区支持，几乎可以应对任何网络视频下载的挑战。