m3u8 downloader v26.03.28

2026年3月29日 21:58 35 条评论

基于 ffmpeg 的 m3u8 / 归档页解析下载工具，支持单链接、批量 CSV/文本、自定义输出目录与 ffmpeg 路径。

参数	说明
`-i`	输入：直链 m3u8、含 `archives` 的归档详情页、或带 `cms_player` 的播放页；也支持 `.mp4` / `.avi` / `.mov` / `.mpeg` 直链（走 HTTP 分段下载，非 ffmpeg）
`-o`	输出文件名（自动补 `.mp4`）；对部分模式用于覆盖默认标题名
`-p`	输出目录；可为本机路径或 UNC（如 `\\服务器\共享\目录`）
`-f`	批量输入文件：`.csv` 或纯文本（每行一个链接）
`-m`	指定 ffmpeg 可执行文件路径

注意： 必须提供 -i 或 -f 之一。

单条示例

python m3u8_downloader.py -i "https://example.com/video.m3u8?token=xxx" -o myvideo -p D:\Videos

批量 CSV

编码建议 UTF-8（含 BOM 亦可），表头需包含列 link；可选列 name（用于在部分逻辑里拼接输出名后缀，空单元格按空字符串处理，不会出现 nan 文件名）。
会跳过空的 link 或内容为 link 的占位行。
按行 顺序执行：上一任务结束（含 ffmpeg）后才会处理下一行。

python m3u8_downloader.py -f list.csv -p "\\192.168.1.12\media\Videos"

纯文本列表

每行一个 URL，行为与逐次 -i 类似；可通过 -o 传入统一输出名（视链接类型而定）。

功能说明

链接类型与行为

.m3u8 直链
使用 ffmpeg 拉流并 remux 为 .mp4（-c copy）。
URL 中含 archives（归档站 / bl05 类页面）
请求页面，解析多个 div.dplayer 的 data-config，得到多路 m3u8；按路依次下载，文件名一般为 页面标题 + 序号，并经 safe_mp4_filename 净化。
其它播放页（非 archives）
解析 var cms_player = {...} 的 JSON，取 url 作为 m3u8，再走 ffmpeg。
.mp4 等直链
使用 requests 分段下载（file_download.download_from_url），带 tqdm 进度条，不经过 ffmpeg。

页面编码

抓取 HTML 时依次尝试 UTF-8 → UTF-8-sig → gb18030，减轻标题乱码。

输出文件名

去除 Windows 非法字符，过长截断并可带 crc 后缀兜底。
对「UTF-8 被误当成 latin-1」类乱码标题做启发式纠正（日志中可能出现 [F] 标题疑似 UTF-8/latin-1 乱码，已尝试纠正）。

覆盖策略

若目标 .mp4 已存在（os.path.isfile），跳过该次下载。
调用 ffmpeg 时带 -n：不在终端交互询问覆盖；若因路径编码等导致检测不一致，ffmpeg 侧也会拒绝覆盖而非静默覆盖。

本地 m3u8 文件

-f 指向 .m3u8 / .m3u 时，当前代码分支为占位（pass），尚未实现。

目录说明

路径（相对程序目录）	用途
`bin/ffmpeg.exe`	Windows 打包/放置 ffmpeg 的常见位置
`download/m3u8_files`	内部与 `make_dir` 相关的子目录逻辑
`download/mp4`	未指定 `-p` 时的默认输出目录

下载地址：

https://www.123912.com/s/ucY7Vv-njQAA?pwd=HwGK#

博客： obaby 𝐢‍𝐧⃝ void

地址： https://zhongxiaojie.com/

文章： 《m3u8 downloader v26.03.28》

Previous Post Next Post

obaby

独立 APP 开发者偶尔写点东西希望与过往一刀两断

35 comments

Hary说道：

2026年3月29日 10:11 下午

Microsoft Edge 146.0.0.0 Android 10 中国–安徽省–中国电信–公众宽带
emmm一楼嘛，看不懂干啥的，楼下解释一下

回复
皮皮社长说道：

2026年3月29日 10:53 下午

Google Chrome 131.0.6778.200 Android 16 中国–湖南省–永州市–道县–中国联通–3GNET网络
二楼也不懂，好像是看小电影的。具体楼下解释下。

回复
1. 崔话记说道：
  
  2026年3月30日 1:49 下午
  
  Google Chrome 146.0.0.0 Windows 10 x64 Edition 中国–广东–深圳电信
  不懂小电影，你解释下，哪里有小电影
  
  回复
  1. obaby说道：
    
    2026年3月30日 1:50 下午
    
    Google Chrome 142.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–李沧区–中国联通–3GNET网络
    路边小广告？
    
    回复
瓦匠说道：

2026年3月30日 6:21 上午

WebView 4.0 Android 16 中国–湖北省–武汉市–洪山区–中国联通–3GNET网络
手机端，代码块内容跑出去了

回复
1. obaby说道：
  
  2026年3月30日 9:08 上午
  
  Google Chrome 142.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–李沧区–中国联通–3GNET网络
  修复了
  
  回复
菲克说道：

2026年3月30日 6:33 上午

Google Chrome 146.0.0.0 Mac OS X 26.4 中国–山东–临沂移动
这不巧了吗，三楼的我也不懂，原来技术文章可以这样回复

回复
花非花说道：

2026年3月30日 6:52 上午

Google Chrome 146.0.0.0 Windows 11 x64 Edition 中国–江苏移动
视频网站的视频都能下载吗？

回复
1. obaby说道：
  
  2026年3月30日 9:08 上午
  
  Google Chrome 142.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–李沧区–中国联通–3GNET网络
  这个不行，就是为了下载有播放地址的视频文件的。
  如果下载视频网站的推荐lux。
  
  回复
  1. 花非花说道：
    
    2026年3月30日 9:14 上午
    
    Google Chrome 146.0.0.0 Windows 11 x64 Edition 中国–江苏移动
    还好还好，有一个应急就行，日常所需的资源大多有专门的工具下载
    
    回复
J.sky说道：

2026年3月30日 7:26 上午

Google Chrome 146.0.0.0 GNU/Linux x64 中国–辽宁–朝阳电信
小电影下载器，我懂了。这是为博友造福呢。

回复
小彦说道：

2026年3月30日 8:07 上午

Firefox 148.0 GNU/Linux x64 中国–广东–中山电信
大家好，好人有好报，推荐一个，你懂的

回复
Vind说道：

2026年3月30日 9:54 上午

Microsoft Edge 147.0.0.0 Android 10 中国–上海市–中国电信–公众宽带
应该是下载某些网页上视频用的，比如爱优腾？
不过我也不看别的，就是👀一个哔哩哔哩，主要是它没什么广告，直接播放。

回复
1. obaby说道：
  
  2026年3月30日 11:02 上午
  
  Google Chrome 142.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–李沧区–中国联通–3GNET网络
  一些小网站的视频下载用的，之前为了下载一个教学视频折腾的。
  
  回复
老刘博客说道：

2026年3月30日 10:07 上午

Google Chrome 146.0.0.0 GNU/Linux x64 中国–河南省–郑州市–中原区–中国联通–公众宽带
以前折腾电视盒子的时候用过这个格式，应该是流媒体之类的？

回复
1. obaby说道：
  
  2026年3月30日 11:01 上午
  
  Google Chrome 142.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–李沧区–中国联通–3GNET网络
  嗯嗯，现在很多视频都是这个流格式。
  包括iptv很多也是这种流媒体格式。
  
  回复
夏末说道：

2026年3月30日 11:14 上午

IBrowse r Android 16 中国–四川省–达州市–渠县–中国联通–3GNET网络
mu38以前看电影经常用

回复
1. obaby说道：
  
  2026年3月30日 1:18 下午
  
  Google Chrome 142.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–李沧区–中国联通–3GNET网络
  这个东西用的还蛮多的
  
  回复
我是军爸说道：

2026年3月30日 12:06 下午

Microsoft Edge 145.0.0.0 Windows 10 x64 Edition 中国–浙江–台州联通
很厉害的样子

回复
ymz316说道：

2026年3月30日 2:12 下午

Firefox 140.0 GNU/Linux x64 中国–湖南–娄底电信
我用 github 上这个 GUI 版本的，HeiSir2014/M3U8-Downloader,也很不错。

回复
1. acevs说道：
  
  2026年3月30日 2:34 下午
  
  Google Chrome 146.0.0.0 Windows 11 x64 Edition 中国–山东–青岛联通
  不错~试试看。
  
  回复
2. obaby说道：
  
  2026年3月30日 2:42 下午
  
  Google Chrome 142.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–李沧区–中国联通–3GNET网络
  看意思自己实现的aes解密合并~~
  
  回复
全局变量说道：

2026年3月31日 9:15 上午

Google Chrome 132.0.0.0 Windows 10 x64 Edition 中国–湖南–岳阳电信
等我两分钟。

回复
全局变量说道：

2026年3月31日 9:27 上午

Google Chrome 132.0.0.0 Windows 10 x64 Edition 中国–湖南–岳阳电信
付费下载？

回复
1. obaby说道：
  
  2026年3月31日 10:07 上午
  
  Google Chrome 142.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–李沧区–中国联通–3GNET网络
  ?免费啊,免登陆需要我花钱，所以需要登录下载。
  
  回复
hehe说道：

2026年3月31日 3:54 下午

Google Chrome 146.0.0.0 Windows 11 x64 Edition 中国–陕西省–西安市–莲湖区–中国电信–公众宽带
收藏备用

回复
1. obaby说道：
  
  2026年3月31日 4:20 下午
  
  Google Chrome 144.0.0.0 Android 10 中国–山东省–青岛市–李沧区–中国联通–3GNET网络
  😁
  
  回复
爱看说道：

2026年4月1日 9:43 下午

Google Chrome 109.0.0.0 Windows 10 x64 Edition 中国–上海–上海腾讯云
这个是小红帽还是圣诞主题

回复
1. obaby说道：
  
  2026年4月2日 8:54 上午
  
  Google Chrome 142.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–崂山区–中国联通–3GNET网络
  不是圣诞~~
  
  回复
似水流年说道：

2026年4月3日 4:27 上午

Microsoft Edge 146.0.0.0 Windows 11 x64 Edition 中国–河南–漯河联通
这个升级了啊，第一版我下了。

回复
Ksable说道：

2026年4月6日 10:03 上午

Microsoft Edge 143.0.0.0 Windows 11 x64 Edition 中国–山西移动/全省通用
如果我有解密密钥，能让脚本解密 m3u8 吗

回复
1. obaby说道：
  
  2026年4月6日 6:07 下午
  
  Google Chrome 146.0.0.0 Windows 10 x64 Edition 中国–山东–青岛联通
  可以的，多数加密都是aes，本身ffmpeg可以带密钥处理，如果不是标准流就得自己解密了。
  
  回复
weapon说道：

2026年4月16日 3:38 下午

Google Chrome 137.0.0.0 Windows 10 x64 Edition 中国–浙江–绍兴电信
都用python了,搞个图形界面用起来更舒服,输命令还是太难为小白们了

回复
1. obaby说道：
  
  2026年4月17日 9:03 上午
  
  Google Chrome 146.0.0.0 Mac OS X 10.15.7 中国–山东省–青岛市–胶州市–中国联通–3GNET网络
  额，界面不方便批量操作，命令行更自由
  
  回复
  1. weapon说道：
    
    2026年4月17日 11:29 上午
    
    Google Chrome 137.0.0.0 Windows 10 x64 Edition 中国–浙江–绍兴电信
    你的意思是图形化界面不方便用批处理脚本吗?那就在图形化界面里把批量的逻辑写进去好了呀
    
    回复