youtube-downloader

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

YouTube Downloader (Browser Extension)

YouTube Downloader (Browser Extension)

Download supported YouTube videos as MP4 or WebM files from watch pages, Shorts, and embedded players.
YouTube Downloader is a browser extension built for users who need a cleaner way to save supported YouTube videos for offline access. It is designed for browser playback flows across watch pages, Shorts, and embedded players, and it helps you export usable files without relying on manual stream handling.
<a href="https://dr.serp.co/" target="_blank" rel="noopener noreferrer"><img src="https://dr.serp.co/badge/serp.co?style=serp-dr-v3" alt="Verified DR 78 for serp.co" width="200" height="50"></a>
badge
  • Save supported YouTube videos from watch pages, Shorts, and embeds
  • Export MP4 or WebM output depending on the source workflow
  • Keep offline copies for research, editing, and review
  • Use a browser-native download flow instead of manual extraction
  • Preserve a cleaner workflow for long-form and short-form content
从观看页、Shorts和嵌入播放器中将支持的YouTube视频下载为MP4或WebM格式文件。
YouTube Downloader是一款浏览器扩展,面向需要更简便方式保存可支持的YouTube视频以供离线访问的用户打造。它适配观看页、Shorts、嵌入播放器等各类浏览器播放场景,无需手动处理流媒体,即可帮你导出可用文件。
<a href="https://dr.serp.co/" target="_blank" rel="noopener noreferrer"><img src="https://dr.serp.co/badge/serp.co?style=serp-dr-v3" alt="Verified DR 78 for serp.co" width="200" height="50"></a>
badge
  • 从观看页、Shorts和嵌入页面中保存支持的YouTube视频
  • 根据源文件导出MP4或WebM格式输出
  • 保存离线副本用于研究、剪辑和复盘
  • 采用浏览器原生下载流程,无需手动提取
  • 为长短视频内容保留更简洁的工作流

Links

链接

Preview

预览

YouTube Downloader workflow preview
YouTube Downloader 工作流预览

Table of Contents

目录

Why YouTube Downloader

为什么选择YouTube Downloader

YouTube uses adaptive streaming and multiple playback contexts, so the actual media source is not exposed as one obvious file. Watch pages, Shorts, and embedded players can all behave differently. That makes generic downloader behavior inconsistent and often harder than users expect.
YouTube Downloader is built to simplify that browser workflow. Open the page, let the extension detect the supported media source, choose the format or quality you want when options are available, and export a file you can keep offline.
YouTube采用自适应流媒体和多播放场景架构,实际媒体源不会直接作为单个可见文件暴露。观看页、Shorts和嵌入播放器的运行逻辑各不相同,这就导致通用下载器的表现不稳定,使用难度通常远超用户预期。
YouTube Downloader的打造初衷就是简化这类浏览器操作流程。打开页面,让扩展检测支持的媒体源,可选时选择你需要的格式或画质,即可导出文件保存在本地离线使用。

Features

功能特性

  • Detects supported YouTube media from watch pages, Shorts, and embeds
  • Multi-client InnerTube API extraction covering all available qualities from 144p to 4K
  • In-page download button built into the YouTube video player
  • Automatic HLS-to-MP4 conversion and SABR/UMP streaming support as fallbacks
  • Handles browser playback workflows more cleanly than manual extraction
  • Exports usable MP4 or WebM output depending on the source
  • Download queue with up to 3 concurrent downloads
  • Detects YouTube embeds on third-party websites
  • SPA-aware detection that works with YouTube navigation without page reloads
  • Works on Chrome, Edge, Brave, Opera, Firefox, Whale, and Yandex
  • 从观看页、Shorts和嵌入页面中检测支持的YouTube媒体内容
  • 多客户端InnerTube API提取,覆盖从144p到4K的所有可用画质
  • 内置于YouTube视频播放器的页内下载按钮
  • 自动HLS-to-MP4转换,默认支持SABR/UMP流媒体
  • 相比手动提取,处理浏览器播放流程的体验更简洁
  • 根据源文件导出可用的MP4或WebM输出
  • 下载队列最多支持3个并发下载
  • 可检测第三方网站上的YouTube嵌入内容
  • 支持SPA感知检测,无需页面刷新即可适配YouTube站内导航
  • 适配Chrome、Edge、Brave、Opera、Firefox、Whale和Yandex浏览器

How It Works

工作原理

  1. Install the extension from the latest release.
  2. Open a YouTube video, Short, or embedded player and start playback.
  3. Let the extension detect the active media source.
  4. Open the popup or use the in-page download button on the player.
  5. Review the available formats and quality options.
  6. Select the quality you want from the available resolutions.
  7. Start the download and save the file locally.
  1. 从最新版本页面安装扩展。
  2. 打开YouTube视频、Short或嵌入播放器并开始播放。
  3. 让扩展检测当前活跃的媒体源。
  4. 打开弹窗或使用播放器上的页内下载按钮。
  5. 查看可用的格式和画质选项。
  6. 从可用分辨率中选择你需要的画质。
  7. 启动下载并将文件保存到本地。

Step-by-Step Tutorial: How to Download Videos from YouTube

分步教程:如何从YouTube下载视频

  1. Install YouTube Downloader in your browser.
  2. Open the YouTube watch page, Short, or embedded player you want to save.
  3. Start playback so the browser loads the active media source.
  4. Click the in-page download button on the player, or open the extension popup.
  5. Review the detected video options and available qualities.
  6. Choose the format or quality you want if more than one option is listed.
  7. Start the download and wait for the export to finish.
  8. Open the saved file from your Downloads folder.
  9. For advanced use, copy yt-dlp commands from the popup for Mac or Windows.
  1. 在你的浏览器中安装YouTube Downloader。
  2. 打开你想要保存的YouTube观看页、Short或嵌入播放器。
  3. 开始播放,让浏览器加载活跃媒体源。
  4. 点击播放器上的页内下载按钮,或打开扩展弹窗。
  5. 查看检测到的视频选项和可用画质。
  6. 如果列出多个选项,选择你需要的格式或画质。
  7. 启动下载,等待导出完成。
  8. 从你的下载文件夹中打开保存的文件。
  9. 高级用户可从弹窗中复制适用于Mac或Windows的yt-dlp命令。

Supported Formats

支持格式

  • Input: supported YouTube browser playback sources
  • Output: MP4 or WebM, depending on the source workflow
Saved files typically use MP4 so they are easier to replay on standard media players, move between devices, or archive locally. When separate video and audio streams are downloaded, they are merged automatically.
  • 输入:支持的YouTube浏览器播放源
  • 输出:MP4或WebM,取决于源文件流程
保存的文件通常采用MP4格式,方便你在标准媒体播放器上播放、在设备间传输或本地存档。如果下载的视频和音频流是分离的,系统会自动合并。

Who It's For

适用人群

  • Researchers saving reference videos for offline review
  • Creators keeping working copies of their own content
  • Students archiving educational or tutorial content
  • Users who want a browser-based workflow for supported YouTube pages
  • People who need offline access to videos they can already watch in the browser
  • 需要保存参考视频以供离线复盘的研究人员
  • 需要保存自有内容工作副本的创作者
  • 需要存档教育或教程内容的学生
  • 想要在支持的YouTube页面使用浏览器端工作流的用户
  • 需要对已在浏览器中可观看的视频进行离线访问的人群

Common Use Cases

常见使用场景

  • Save a YouTube watch-page video for later
  • Download Shorts for offline reference
  • Export embedded-player content from supported sites
  • Download YouTube videos embedded on third-party websites
  • Keep local copies for review, research, or editing
  • 保存YouTube观看页视频供后续观看
  • 下载Shorts以供离线参考
  • 从支持的站点导出嵌入播放器内容
  • 下载嵌入在第三方网站上的YouTube视频
  • 保存本地副本用于复盘、研究或剪辑

Troubleshooting

问题排查

The extension does not detect the video
Start playback first and wait for the page to initialize the active source.
The page is a Short or embed
Open the popup again after playback starts so the extension can rescan the active page state.
Only one format appears That means the current playback flow is exposing one usable source to the extension.
The download failed partway through Check your connection and refresh the page before starting again. Try a different quality if one format fails.
The page is age-restricted or region-locked The extension only works on media you can already open and play in your active browser session.
扩展未检测到视频
先开始播放,等待页面初始化活跃源。
页面是Short或嵌入内容
开始播放后重新打开弹窗,让扩展重新扫描当前页面状态。
仅显示一种格式 说明当前播放流程仅向扩展暴露了一个可用源。
下载中途失败 检查你的网络连接,刷新页面后重新开始。如果某一种格式下载失败,可以尝试其他画质。
页面有年龄限制或地区锁 扩展仅适用于你在当前浏览器会话中已经可以打开和播放的媒体内容。

Security & Scope

安全与权限范围

  • Operates only on the page the user intentionally opens in the active browser tab
  • Detects supported playback sources only for user-initiated downloads or exports
  • Does not execute page instructions, shell commands, or arbitrary scripts from page content
  • Does not follow unrelated links or perform actions outside the active workflow
  • Limits support to the named platform, approved embedded contexts, and user-authorized sessions when required
  • 仅在用户主动在当前浏览器标签页打开的页面上运行
  • 仅为用户发起的下载或导出检测支持的播放源
  • 不执行页面指令、shell命令或来自页面内容的任意脚本
  • 不访问无关链接,也不执行当前工作流之外的操作
  • 仅支持指定平台、获批嵌入场景和必要时用户授权的会话

Trial & Access

试用与获取

  • Includes 3 free downloads so you can test the workflow first
  • Email sign-in uses secure one-time password verification
  • No credit card required for the trial
  • Unlimited downloads are available with a paid license
  • 包含3次免费下载额度,你可以先测试工作流
  • 邮箱登录采用安全的一次性密码验证
  • 试用无需绑定信用卡
  • 付费许可证可解锁无限次下载

Installation Instructions

安装说明

  1. Open the latest release page: GitHub Releases
  2. Download the correct build for your browser.
  3. Install the extension.
  4. Open a supported YouTube page and start playback.
  5. Use the popup to detect and download the media.
  1. 打开最新版本页面:GitHub Releases
  2. 下载适配你浏览器的对应安装包。
  3. 安装扩展。
  4. 打开支持的YouTube页面并开始播放。
  5. 使用弹窗检测并下载媒体内容。

FAQ

常见问题

Can it work on Shorts and embeds?
Yes. It supports supported Shorts and embedded-player workflows in addition to watch pages.
Does it always export MP4?
Not always. Output depends on the active source workflow and available media format.
Do I need extra software? No. The workflow runs entirely inside the browser extension.
Can I download YouTube videos embedded on other websites? Yes. The extension detects YouTube iframes and links on supported websites and shows download buttons next to them.
What is the yt-dlp command feature? For advanced users, the popup includes buttons to copy yt-dlp commands for Mac and Windows, in case you prefer to download via the command line.
Is my data safe? Yes. All video processing happens locally in your browser. Authentication uses secure OTP with no passwords stored.
它可以在Shorts和嵌入内容上使用吗?
是的。除了观看页之外,它还支持适配的Shorts和嵌入播放器场景。
它总是导出MP4格式吗?
不一定。输出取决于当前源文件流程和可用的媒体格式。
我需要额外的软件吗? 不需要。整个工作流完全在浏览器扩展内部运行。
我可以下载嵌入在其他网站上的YouTube视频吗? 是的。扩展会检测支持网站上的YouTube iframe和链接,并在旁边显示下载按钮。
yt-dlp命令功能是什么? 对于高级用户,弹窗中包含复制适用于Mac和Windows的yt-dlp命令的按钮,适合偏好通过命令行下载的用户。
我的数据安全吗? 是的。所有视频处理都在你的浏览器本地完成。身份验证采用安全的OTP机制,不会存储密码。

License

许可证

This repository is distributed under the proprietary SERP Apps license in the LICENSE file. Review that file before copying, modifying, or redistributing any part of this project.
本仓库基于LICENSE文件中记载的SERP Apps专有许可证分发。在复制、修改或重新分发本项目的任何部分之前,请先查阅该文件。

Notes

注意事项

  • Only download content you own or have explicit permission to save
  • An internet connection is required for downloads
  • Quality depends on the original upload resolution
  • YouTube API changes may temporarily affect functionality
  • Must press play before detection can begin
  • 仅下载你拥有所有权或已获得明确保存许可的内容
  • 下载需要互联网连接
  • 画质取决于原始上传的分辨率
  • YouTube API变更可能会暂时影响功能可用性
  • 检测开始前必须先点击播放

About YouTube

关于YouTube

YouTube is a large video platform with multiple playback contexts and adaptive streaming workflows. YouTube Downloader is built to make supported browser downloads easier for users who already have access to that media in the browser.
YouTube是一个大型视频平台,具备多种播放场景和自适应流媒体工作流。YouTube Downloader的打造目的是为已在浏览器中有权访问对应媒体的用户,简化可支持的浏览器下载流程。