本文档旨在指导用户如何使用 yt-dlp 工具下载视频，并在下载过程中嵌入章节信息、元数据和缩略图。我们将通过示例代码演示如何配置 yt-dlp 的 postprocessors，以实现这些功能，并解释相关配置选项的含义和使用方法，帮助读者更好地利用 yt-dlp 提升视频下载体验。
使用 yt-dlp 嵌入元数据和章节
yt-dlp 是一款强大的命令行工具，可以从各种网站下载视频和音频。它还提供了丰富的功能，允许用户在下载过程中对视频进行后处理，例如嵌入元数据、章节信息和缩略图。
要使用 yt-dlp 嵌入元数据和章节，需要配置 ydl_opts 字典中的 postprocessors 列表。postprocessors 列表包含一系列字典，每个字典描述一个后处理操作。
以下是一个示例代码，演示如何使用 yt-dlp 下载视频并嵌入元数据、章节信息和缩略图：
import yt_dlp
url = 'https://www.youtube.com/watch?v=BaW_jenozKc'
ydl_opts = {
'format': 'bestvideo[height<=720][ext=mp4]+bestaudio[ext=m4a]/best[height<=720][ext=mp4]',
'postprocessors': [
{'key': 'FFmpegVideoConvertor', 'preferedformat': 'mp4'},
{'key': 'FFmpegMetadata'},
{'key': 'EmbedThumbnail'}
],
'writethumbnail': True
}
with yt_dlp.YoutubeDL(ydl_opts) as ydl:
ydl.download(url)代码解释：
- format: 指定下载的视频和音频的格式。
- postprocessors: 一个列表，包含要执行的后处理操作。
- FFmpegVideoConvertor: 使用 FFmpeg 将视频转换为指定的格式 (mp4)。
- FFmpegMetadata: 将元数据嵌入到视频文件中。注意：章节信息通常与元数据一起嵌入，但前提是源视频本身包含章节信息。
- EmbedThumbnail: 将缩略图嵌入到视频文件中。
- writethumbnail: 设置为 True 时，yt-dlp 会将缩略图写入磁盘，EmbedThumbnail 才能正确工作。
注意事项：
- 章节信息： yt-dlp 默认情况下会在嵌入元数据时添加章节信息（如果视频源本身包含章节信息）。如果你的视频没有章节信息，那么即使启用了 EmbedMetadata，也不会添加任何章节。
- 缩略图： 要使用 EmbedThumbnail，必须先使用 writethumbnail: True 将缩略图写入磁盘。
- FFmpeg： 确保你的系统上安装了 FFmpeg，并且 yt-dlp 可以找到它。否则，FFmpegVideoConvertor 和 FFmpegMetadata 将无法正常工作。
总结：
通过配置 yt-dlp 的 postprocessors 选项，可以方便地在下载视频的同时嵌入元数据、章节信息和缩略图。请确保理解每个选项的含义和依赖关系，以便根据自己的需求进行配置。 记住，章节信息的嵌入依赖于视频源本身是否包含章节数据，而缩略图的嵌入则需要先将缩略图写入磁盘。
