Back to Details

m3u8-downloader

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

M3U8 Downloader (Browser Extension)

M3U8下载器（浏览器扩展）

Detect and download HLS/M3U8 streams from supported websites and save them as MP4 files.
M3U8 Downloader is a browser extension built for users who need a site-agnostic HLS workflow instead of a single-site downloader. It monitors supported media requests in your browser, detects M3U8/HLS streams and related video sources, and helps you export them into standard MP4 files without relying on command-line tools.
  • Detect HLS/M3U8 streams from supported sites
  • Save compatible streams as MP4 files
  • Review multiple available stream variants and qualities
  • Download media from browser-visible streaming sessions
  • Use a browser workflow instead of FFmpeg or manual playlist extraction
检测并从支持的网站下载HLS/M3U8流媒体，将其保存为MP4文件。
M3U8下载器是一款浏览器扩展，为需要通用HLS工作流而非单一站点下载器的用户打造。它会监控浏览器中支持的媒体请求，检测M3U8/HLS流媒体和相关视频源，无需依赖命令行工具即可帮你将其导出为标准MP4文件。
  • 从支持的站点检测HLS/M3U8流媒体
  • 将兼容的流媒体保存为MP4文件
  • 查看多个可用的流媒体变体和画质
  • 从浏览器可见的流媒体会话中下载媒体
  • 采用浏览器工作流，无需使用FFmpeg或手动提取播放列表

Links

链接

Preview

预览

M3U8 Downloader workflow preview
M3U8下载器工作流预览

Table of Contents

目录

Why M3U8 Downloader

为什么选择M3U8下载器

HLS streams are not ordinary downloadable files. They are delivered through playlist manifests and media segments, which means right-click saving does not work and generic downloader tools often miss the real stream behind the page player. For many users, the alternatives are either fragile websites or technical command-line workflows.
M3U8 Downloader is built for that protocol-level use case. It watches browser-visible media requests, detects compatible stream sources, and gives you a cleaner way to export supported HLS media into a single local file.
HLS流媒体不是普通的可下载文件，它们通过播放列表清单和媒体分片传输，这意味着右键保存无法生效，通用下载工具通常也无法获取页面播放器背后的真实流。对很多用户来说，替代方案要么是不稳定的第三方网站，要么是有技术门槛的命令行工作流。
M3U8下载器正是为这种协议级使用场景打造的，它会监控浏览器可见的媒体请求，检测兼容的流资源，为你提供更简洁的方式将支持的HLS媒体导出为单个本地文件。

Features

功能特性

  • Automatic detection of compatible M3U8/HLS streams from browser activity
  • Support for related direct video formats where exposed by the page
  • MP4 export for compatible HLS workflows
  • Quality and stream-variant selection where multiple options exist
  • Download progress tracking for active exports
  • Browser-based workflow without requiring FFmpeg commands
  • Support for login-gated browser sessions when the stream is already available in the page context
  • Cross-browser support for Chrome, Edge, Brave, Opera, Firefox, Whale, and Yandex
  • 从浏览器活动中自动检测兼容的M3U8/HLS流媒体
  • 支持页面暴露的相关直连视频格式
  • 兼容的HLS工作流可导出为MP4
  • 存在多个选项时可选择画质和流媒体变体
  • 活跃导出任务的下载进度追踪
  • 基于浏览器的工作流，无需使用FFmpeg命令
  • 当流在页面上下文中可用时，支持登录限制的浏览器会话
  • 跨浏览器支持Chrome、Edge、Brave、Opera、Firefox、Whale和Yandex

How It Works

工作原理

  1. Install the extension from the latest release.
  2. Open a supported website with an HLS or compatible media player.
  3. Start playback so the browser loads the stream requests.
  4. Open the extension popup to review detected streams.
  5. Choose the stream or quality you want.
  6. Download the media and save the final MP4 file locally.
  1. 从最新版本安装扩展。
  2. 打开带有HLS或兼容媒体播放器的支持网站。
  3. 开始播放，让浏览器加载流媒体请求。
  4. 打开扩展弹窗查看检测到的流媒体。
  5. 选择你需要的流媒体或画质。
  6. 下载媒体并将最终的MP4文件保存到本地。

Step-by-Step Tutorial: How to Download HLS Streams

分步教程：如何下载HLS流媒体

  1. Install M3U8 Downloader from the latest GitHub release.
  2. Navigate to a supported page that uses an HLS or related streaming player.
  3. Press play so the stream manifest and segments start loading.
  4. Click the extension button in your browser toolbar.
  5. Review the detected media sources and available quality variants.
  6. Select the stream you want to keep.
  7. Start the download and wait for the MP4 export to complete.
  8. Open the saved file from your Downloads folder.
  1. 从最新的GitHub版本安装M3U8下载器。
  2. 访问使用HLS或相关流媒体播放器的支持页面。
  3. 点击播放，让流媒体清单和分片开始加载。
  4. 点击浏览器工具栏中的扩展按钮。
  5. 查看检测到的媒体源和可用的画质变体。
  6. 选择你想要保存的流媒体。
  7. 开始下载，等待MP4导出完成。
  8. 从你的下载文件夹打开保存的文件。

Supported Formats

支持格式

  • Input: M3U8 / HLS streams
  • Input: Related compatible media sources where exposed by the page
  • Output: MP4
The final export is designed to turn stream-based playback into a single easier-to-use local video file.
  • 输入：M3U8 / HLS流媒体
  • 输入：页面暴露的相关兼容媒体源
  • 输出：MP4
最终导出功能旨在将流式播放转换为更易用的单个本地视频文件。

Who It's For

适用人群

  • Users downloading HLS streams from supported sites
  • Testers and QA users capturing browser-visible stream outputs
  • Creators archiving their own streamed media
  • Students or researchers preserving permitted streaming content for offline access
  • Anyone who wants a browser-based HLS workflow instead of terminal tools
  • 从支持站点下载HLS流媒体的用户
  • 捕获浏览器可见流输出的测试人员和QA用户
  • 归档自己的流媒体内容的创作者
  • 保存允许的流媒体内容供离线访问的学生或研究人员
  • 想要基于浏览器的HLS工作流而非终端工具的所有用户

Common Use Cases

常见使用场景

  • Save a compatible HLS stream from a supported site
  • Export browser-visible M3U8 playback into a local MP4
  • Review multiple quality variants before downloading
  • Keep a local copy of content you are permitted to access
  • Capture a stream that other generic downloaders fail to detect
  • 从支持站点保存兼容的HLS流媒体
  • 将浏览器可见的M3U8播放内容导出为本地MP4
  • 下载前查看多个画质变体
  • 保存你有权访问的内容的本地副本
  • 捕获其他通用下载器无法检测到的流媒体

Troubleshooting

故障排查

The extension is not detecting the stream
Press play first and wait a few seconds so the manifest and segments start loading.
No quality options are listed
Some players expose only one active stream variant.
The site requires login
The extension only works on media you can already access in your current browser session.
The stream still does not appear
Refresh the page, replay the media, and try again once the player is fully loaded.
The page uses DRM
DRM-protected content is outside the supported scope of normal HLS capture workflows.
扩展未检测到流媒体
先点击播放，等待几秒钟让清单和分片开始加载。
没有列出画质选项
部分播放器仅暴露一个活跃的流媒体变体。
站点需要登录
扩展仅适用于你在当前浏览器会话中已经可以访问的媒体。
流媒体仍然没有出现
刷新页面，重新播放媒体，等播放器完全加载后再尝试。
页面使用DRM
DRM保护的内容不在常规HLS捕获工作流的支持范围内。

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
Start here: https://serp.ly/m3u8-downloader
  • 包含3次免费下载额度，你可以先测试工作流
  • 邮箱登录使用安全的一次性密码验证
  • 试用无需信用卡
  • 付费许可证可享受无限次下载
从此处开始：https://serp.ly/m3u8-downloader

Installation Instructions

安装指南

  1. Open the latest release page: https://github.com/serpapps/m3u8-downloader/releases/latest
  2. Download the extension build for your browser.
  3. Install the extension.
  4. Open a supported page with streaming media.
  5. Use the extension popup to detect and download the stream.
  1. 打开最新版本页面： https://github.com/serpapps/m3u8-downloader/releases/latest
  2. 下载对应浏览器的扩展安装包。
  3. 安装扩展。
  4. 打开带有流媒体内容的支持页面。
  5. 使用扩展弹窗检测并下载流媒体。

FAQ

常见问题

What does this extension download?
Compatible HLS/M3U8 streams and related media sources that are visible to the browser on supported pages.
Does it save videos as MP4?
Yes. Compatible stream workflows are exported as MP4 files.
Do I need FFmpeg or terminal commands?
No. Everything runs through the browser extension workflow.
Why do I have to press play first?
Because the stream usually is not exposed until the player actually starts loading media.
Does it work on every streaming site?
No. It depends on the actual browser-visible media workflow and whether the stream is compatible with this extension's detection path.
这个扩展下载什么内容？
支持页面上浏览器可见的兼容HLS/M3U8流媒体和相关媒体源。
它会将视频保存为MP4吗？
是的，兼容的流媒体工作流会导出为MP4文件。
我需要FFmpeg或终端命令吗？
不需要，所有功能都通过浏览器扩展工作流运行。
为什么我必须先点击播放？
因为通常在播放器实际开始加载媒体之前，流媒体不会暴露。
它适用于所有流媒体站点吗？
不是，这取决于实际的浏览器可见媒体工作流，以及流媒体是否与本扩展的检测路径兼容。

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
  • The extension only works when the stream is already accessible in your browser session
  • DRM-protected media is outside the normal supported workflow
  • Quality depends on what the player exposes for that stream
  • 仅下载你拥有或获得明确保存许可的内容
  • 仅当流媒体在你的浏览器会话中已经可访问时，扩展才能正常工作
  • DRM保护的媒体不在常规支持工作流范围内
  • 画质取决于播放器为该流媒体暴露的选项

About M3U8 / HLS

关于M3U8 / HLS

M3U8 and HLS are stream delivery formats used by many modern video players. They are excellent for adaptive playback, but awkward for ordinary users who want a local file because the media is split into playlists and segments rather than exposed as a single downloadable video. M3U8 Downloader simplifies that workflow in a browser-first way.
M3U8和HLS是很多现代视频播放器使用的流传输格式，它们非常适合自适应播放，但对于想要本地文件的普通用户来说很不方便，因为媒体被拆分为播放列表和分片，而非暴露为单个可下载的视频。M3U8下载器以浏览器优先的方式简化了这一工作流。