ce-yt-dlp

项目简介

ce-yt-dlp 全称为 Custom Extension yt-dlp，是 yt-dlp 的外部插件集合。它提供可按需开启的定制能力，可在不改动核心库的前提下切换到增强版 YoutubeDL 以及自定义提取器。

目录

• 部署流程
• 使用选项
• 自定义功能
• 自定义提取器

部署流程

环境要求

• 可运行的 yt-dlp 环境。
• 第三方请求库 requests。

安装 yt-dlp 依赖时，可根据需要执行以下命令之一：

pip install -e '.[default]'
pip install '.[default]'

接入步骤

1. 在 yt-dlp 项目根目录下放置 yt_dlp_plugins 插件项目。
2. 编写下载脚本时，将原生 YoutubeDL 替换为插件中的 CustomYoutubeDL。
3. 保持原有 yt-dlp 使用方式不变，通过配置项开启对应的自定义能力。

基础示例

from yt_dlp_plugins.custom_youtube_dl import CustomYoutubeDL


ydl_opts = {
    "outtmpl": "downloads/%(id)s.%(format_id)s.%(ext)s",
    "format": "bestvideo*+bestaudio/best",
    "subtitleslangs": ["en", "en-orig", "zh-Hans", "zh-Hant"],
    "writeautomaticsub": True,
    "subtitlesformat": "json3",
}

VIDEO_URL = "https://www.youtube.com/watch?v=wSSmNUl9Snw"

with CustomYoutubeDL(ydl_opts) as ydl:
    info = ydl.extract_info(VIDEO_URL, download=True)

使用选项

自定义功能选项

使用自定义功能前，必须先开启 use_custom_youtube_dl 总开关。

自定义提取器选项

使用自定义提取器功能前，必须先开启 use_custom_youtube_dl 总开关。

更多说明：

• use_custom_jsc 详情
• use_custom_sabr 详情

自定义功能

自定义功能位于 yt_dlp_plugins/custom_youtube_dl.py，通过覆盖或重写 YoutubeDL 的方法与属性，实现业务定制能力。

使用示例

from yt_dlp_plugins.custom_youtube_dl import CustomYoutubeDL


ydl_opts = {
    "outtmpl": "downloads/%(id)s.%(format_id)s.%(ext)s",
    "format": "bestvideo*+bestaudio/best",
    "subtitleslangs": ["en", "en-orig", "zh-Hans", "zh-Hant"],
    "writeautomaticsub": True,
    "subtitlesformat": "json3",

    # 开启自定义功能，并启用多字幕下载增强逻辑
    "use_custom_youtube_dl": True,
    "use_custom_writeautomaticsub": True,
}

VIDEO_URL = "https://www.youtube.com/watch?v=wSSmNUl9Snw"

with CustomYoutubeDL(ydl_opts) as ydl:
    info = ydl.extract_info(VIDEO_URL, download=True)

覆写方法一览

更多说明：

• 错误码对照表详情

自定义提取器

自定义提取器位于 yt_dlp_plugins/extractor/custom_youtube.py，通过覆盖或重写 YoutubeIE 的方法与属性，实现业务定制能力。

使用示例

from yt_dlp_plugins.custom_youtube_dl import CustomYoutubeDL


ydl_opts = {
    "outtmpl": "downloads/%(id)s.%(format_id)s.%(ext)s",
    "format": "bestvideo*+bestaudio/best",
    "subtitleslangs": ["en", "en-orig", "zh-Hans", "zh-Hant"],
    "writeautomaticsub": True,
    "subtitlesformat": "json3",

    # 开启自定义插件功能，并指定播放器客户端
    "use_custom_youtube_dl": True,
    "use_custom_plugins": True,
    "use_custom_player_client": [
        "tv",
        "web_safari",
        "android_sdkless",
    ],
}

VIDEO_URL = "https://www.youtube.com/watch?v=wSSmNUl9Snw"

with CustomYoutubeDL(ydl_opts) as ydl:
    info = ydl.extract_info(VIDEO_URL, download=True)

覆写方法一览

更多说明：

• Hook 点对照表详情