后处理器列表

后处理器在下载完成后对文件进行处理。以下是完整的后处理器列表。

配置方式

CLI

# CLI 自动添加后处理器
yt-dlp -x --audio-format m4a --embed-thumbnail --add-metadata "URL"

Python

ydl_opts = {
    'postprocessors': [
        {'key': '后处理器名称', ...其他参数},
    ],
}

音频处理

FFmpegExtractAudio

提取音频流并转换格式。

{
    'key': 'FFmpegExtractAudio',
    'preferredcodec': 'm4a',    # mp3, m4a, flac, opus, wav, vorbis, aac
    'preferredquality': '0',     # 0=best, 10=worst, 或 '192', '320'
}

CLI 对应	说明
`-x, --extract-audio`	启用音频提取
`--audio-format FMT`	音频格式
`--audio-quality Q`	音频质量

元数据嵌入

EmbedThumbnail

将缩略图嵌入到音频/视频文件。

{'key': 'EmbedThumbnail'}

使用前需设置 'writethumbnail': True，且需要 FFmpeg 和 AtomicParsley（mp3 格式需要）。

CLI 对应	说明
`--embed-thumbnail`	嵌入缩略图

FFmpegMetadata

将视频元数据（标题、创建者等）写入文件。

{'key': 'FFmpegMetadata'}

CLI 对应	说明
`--add-metadata`	添加元数据

EmbedSubtitle

将字幕嵌入到视频文件中。

{'key': 'EmbedSubtitle'}

CLI 对应	说明
`--embed-subs`	嵌入字幕

格式转换

FFmpegVideoConvertor

转换视频容器格式。

{
    'key': 'FFmpegVideoConvertor',
    'preferedformat': 'mp4',   # mp4, mkv, webm, avi, flv
}

CLI 对应	说明
`--recode-video FMT`	转换视频格式

FFmpegVideoRemuxer

重新封装视频（不重新编码，速度极快）。

{
    'key': 'FFmpegVideoRemuxer',
    'preferedformat': 'mp4',
}

CLI 对应	说明
`--remux-video FMT`	重封装视频

字幕处理

FFmpegSubtitlesConvertor

转换字幕格式。

{
    'key': 'FFmpegSubtitlesConvertor',
    'format': 'srt',   # srt, ass, vtt, lrc
}

CLI 对应	说明
`--convert-subs FMT`	转换字幕格式

SponsorBlock

标记或删除视频中的赞助片段。

{
    'key': 'SponsorBlock',
    'categories': ['sponsor', 'intro', 'outro', 'selfpromo'],
}

ModifyChapters

根据 SponsorBlock 修改视频章节。

{
    'key': 'ModifyChapters',
    'remove_sponsor_segments': ['sponsor', 'intro'],
}

CLI 对应	说明
`--sponsorblock-mark CATS`	标记片段
`--sponsorblock-remove CATS`	删除片段

SponsorBlock 类别：

类别	说明
`sponsor`	赞助广告
`intro`	片头
`outro`	片尾
`selfpromo`	自我宣传
`interaction`	互动提醒
`preview`	预告
`music_offtopic`	无关音乐
`filler`	填充内容

其他后处理器

FFmpegFixupM3u8

修复 m3u8 下载的文件。

FFmpegFixupM4a

修复 m4a 文件头。

FFmpegFixupStretchedVideo

修复拉伸的视频比例。

FFmpegThumbnailsConvertor

转换缩略图格式。

{
    'key': 'FFmpegThumbnailsConvertor',
    'format': 'png',   # png, jpg
}

后处理器顺序

推荐的后处理器执行顺序（Python postprocessors 列表中的排列）：

'postprocessors': [
    # 1. 首先提取/转换音视频
    {'key': 'FFmpegExtractAudio', ...},
    # 或 {'key': 'FFmpegVideoConvertor', ...},

    # 2. 然后嵌入附加内容
    {'key': 'EmbedThumbnail'},
    {'key': 'EmbedSubtitle'},
    {'key': 'FFmpegMetadata'},

    # 3. 最后是赞助片段处理
    {'key': 'SponsorBlock', ...},
    {'key': 'ModifyChapters', ...},
]

后处理器列表

On this page