YT-DLP Downloader – Chrome 扩展插件-原创

# YT-DLP Downloader – Chrome 扩展

> 一个把 yt-dlp 装进 Chrome 里的视频下载插件，受保护的视频也能下。

—

## 📦 项目结构


yt-dlp-chrome/
├── extension/ # Chrome 插件源码
│ ├── manifest.json # MV3 清单
│ ├── popup.html # 弹窗 UI
│ ├── popup.js # 弹窗逻辑
│ ├── popup.css # 弹窗样式
│ ├── background.js # 后台 service worker
│ └── icons/ # 图标
├── native-host/ # 本地桥接服务
│ ├── yt_dlp_host.py # Python 桥接脚本（核心）
│ ├── yt_dlp_host.bat # Windows 启动包装
│ ├── com.ytdlp.downloader.host.json # NM 清单
│ └── install.bat # 一键安装脚本
├── yt-dlp/ # 可选：自带 yt-dlp.exe 和 ffmpeg.exe
└── README.md # 本文档


—

## 🚀 一键安装（推荐）

### 步骤 0：环境准备

需要装好 3 样东西（每个都一行命令）：

**① yt-dlp.exe**（核心下载器）
powershell
# 管理员 PowerShell
winget install yt-dlp.yt-dlp

验证：CMD 输入 yt-dlp --version，能看到版本号即成功。

**② ffmpeg.exe**（合并音视频用）
powershell
winget install Gyan.FFmpeg

验证：ffmpeg -version

**③ Python 3.7+**（仅本地桥接脚本需要，不装 python 跑不了）
powershell
winget install Python.Python.3.12

验证：python --version

> 💡 三个一起装也可以：
> powershell
> winget install yt-dlp.yt-dlp; winget install Gyan.FFmpeg; winget install Python.Python.3.12
>

—

### 步骤 1：解压并加载扩展

1. 把整个 yt-dlp-chrome 文件夹解压到任意位置（比如 D:\Tools\yt-dlp-chrome）
2. 打开 Chrome，地址栏输入 chrome://extensions/
3. 右上角打开 **「开发者模式」**
4. 点 **「加载已解压的扩展程序」**
5. 选择 yt-dlp-chrome\extension 文件夹
6. 加载成功后，扩展列表会显示 **「YT-DLP Downloader v12」**
7. **记录下扩展 ID**（一串 32 字符的小写字母，例如 abcdefghijklmnopqrstuvwxyzabcdef）

—

### 步骤 2：注册 Native Host

> 这一步让 Chrome 能调用本地 yt-dlp.exe。

1. 进入 yt-dlp-chrome\native-host 文件夹
2. **右键 → 以管理员身份运行** install.bat
3. 按提示输入刚才记下的扩展 ID
4. 脚本会自动：
– 检测 Chrome 用户数据目录
– 生成 Native Messaging 清单
– 注册到 Chrome / Edge 注册表
– 校验 yt-dlp.exe 是否安装

—

### 步骤 3：重启 Chrome

关闭所有 Chrome 窗口，重新打开。

—

### 步骤 4：使用

1. 打开任意视频页面（YouTube / B站 / 抖音 / 快手 / 微博 / Twitter / 任意 m3u8 流媒体……）
2. 等视频加载完成（必须播放几秒，否则 yt-dlp 抓不到元数据）
3. 点 Chrome 右上角扩展图标 → **「YT-DLP Download器」** 弹窗
4. 选画质 / 格式 / 保存目录 → 点 **「⏬ 立即下载」**
5. 下载进度会在后台保存；关闭弹窗后重新打开仍能看到进度。下载历史会永久保存。

—

## ⚙️ 弹窗功能说明

| 字段 | 作用 |
|——|——|
| 画质 | best / 1080p / 720p / 480p / worst |
| 格式 | MP4 / MKV / WebM / 仅音频 MP3 |
| 保存到 | 下载保存目录（默认 H:\IDM下载\video），可改成任意路径 |
| 下载字幕 | 勾上会自动嵌入软字幕（多语言） |
| 立即下载 | 用默认设置下载 |
| 查看可用格式 | 列出 yt-dlp 检测到的所有格式，复制到剪贴板 |

—

## 🛠️ 常见问题

### Q1：点「立即下载」提示 “Native Host 调用失败”
**原因**：Chrome 找不到本地桥接服务。
**排查**：
1. install.bat 是否以管理员身份运行
2. 是否重启了 Chrome
3. 打开 chrome://extensions/ → 点「YT-DLP Downloader」下的「检查视图」→ 「Service Worker」控制台，看有没有错误
4. CMD 里手动运行 python "D:\Tools\yt-dlp-chrome\native-host\yt_dlp_host.py"，看会不会立刻退出（说明 Python 没装好）

### Q2：提示 “找不到 yt-dlp.exe”
**排查**：
cmd
where yt-dlp.exe

应该返回 C:\Users\你的用户名\AppData\Local\Microsoft\WindowsApps\yt-dlp.exe 或类似路径。
如果没返回，重新装：winget install yt-dlp.yt-dlp

### Q3：下载的视频没有声音
**原因**：没装 ffmpeg，没合并视频流和音频流。
**修复**：winget install Gyan.FFmpeg，重启 Chrome 再试。

### Q4：抖音视频下不下来
抖音对 CDN 鉴权严格，建议在浏览器里先完整播放一遍视频（让 cookie 生效），再点下载。
如果还失败，把链接复制到本地 Windows CMD 跑：
cmd
yt-dlp -v "<抖音链接>"

看具体报错。

### Q5：Chrome 商店要求付费？
**不用 Chrome 商店**。本扩展走「加载已解压的扩展程序」方式，完全免费，不用商店。

### Q6：Edge 浏览器能用吗？
可以。install.bat 会同时注册到 Edge。

—

## 🔄 更新 yt-dlp

yt-dlp 每周都有更新，建议每月升级一次：
powershell
winget upgrade yt-dlp.yt-dlp

新版本对各视频站的兼容性更好。

—

## 📝 卸载

1. chrome://extensions/ → 找到「YT-DLP Downloader」→ 点「移除」
2. 删除 yt-dlp-chrome 整个文件夹
3. 删除注册表项：

HKCU\Software\Google\Chrome\NativeMessagingHosts\com.ytdlp.downloader.host
HKCU\Software\Microsoft\Edge\NativeMessagingHosts\com.ytdlp.downloader.host


—

## 🎯 支持的网站（yt-dlp 默认支持）

完整列表见 [yt-dlp 支持的网站](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md)，
包括但不限于：

– 国内：B站 / 抖音 / 快手 / 小红书 / 微博 / 西瓜 / 爱奇艺 / 优酷 / 腾讯视频
– 海外：YouTube / Twitter/X / Instagram / TikTok / Reddit / Vimeo / Facebook
– 流媒体：HLS / m3u8 / DASH（IDM 抓不到的，它都行）

—

## 🆚 vs 其他方案对比

| 方案 | 优点 | 缺点 |
|——|——|——|
| **本扩展** | 一键调用 yt-dlp，UI 集成 | 需配 Native Messaging |
| IDM | 老牌稳定 | 受保护视频抓不到 |
| 猫抓插件 | 商店直装 | 抓 m3u8 是分片，需手动合并 |
| yt-dlp 命令行 | 100% 兼容 | 无 UI，每次复制 URL |
| Cobalt 在线 | 零安装 | 依赖第三方服务 |

—

## 📜 许可

本项目代码 MIT 协议。yt-dlp 本身是 Unlicense。
请仅下载你有权限下载的内容。

## v9 更新

– 下载文件优先使用原网页标题命名。
– 优先读取 H1、og:title、twitter:title、document.title。
– 自动清理 Windows 文件名非法字符，保留中文文件名。
– 移除 yt-dlp 的 restrict-filenames，避免中文标题被转成英文/数字。

## v10 更新

– 下载时实时显示 yt-dlp 进度百分比。
– 实时显示下载速度、剩余时间 ETA、总大小。
– 下载完成后显示最终保存文件名。

## v12 更新

– 下载任务移到 background 后台执行。
– 关闭 popup / 切换网页 / 重新点击插件图标后，进度仍可恢复显示。
– 下载历史保存到 chrome.storage.local，重启 Chrome 后仍可查看。
– 正在下载列表显示百分比、速度、ETA、总大小、错误信息。
– 支持下载完成/失败的系统通知。
– 支持取消正在下载任务。

## v12 修复
– 修复 YouTube 下载文件名可能固定为 youtube 的问题。
– YouTube 页面不再优先读取 h1，改为优先读取 og:title、twitter:title、document.title。
– 自动去除网页标题末尾的 - YouTube。

## v13 新增
– 下载前显示“文件名”输入框，默认读取网页标题，支持手动修改。
– 页面检测到多个独立视频时显示视频选择列表。
– 过滤 .ts / .m4s 分片，避免把一个视频的切片当成多个视频。
– YouTube/B站等 yt-dlp 原生支持网页继续直接交给 yt-dlp 解析，避免 DASH 音视频轨被误判成多个视频。
– 选中的视频地址单独加入后台下载任务。

v14 修复
– YouTube SPA 优先读取播放器元数据区域的真实视频标题。
– 文件名误读为 youtube 时，Native Host 自动放弃该名称，改用 yt-dlp 解析出的真实 %(title)s。

以下是环境安装

这里是插件和使用方法

插件下载地址