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

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

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

• 编码建议 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 传入统一输出名（视链接类型而定）。

1. .m3u8 直链
   使用 ffmpeg 拉流并 remux 为 .mp4（-c copy）。
2. URL 中含 archives（归档站 / bl05 类页面）
   请求页面，解析多个 div.dplayer 的 data-config，得到多路 m3u8；按路依次下载，文件名一般为 页面标题 + 序号，并经 safe_mp4_filename 净化。
3. 其它播放页（非 archives）
   解析 var cms_player = {...} 的 JSON，取 url 作为 m3u8，再走 ffmpeg。
4. .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 侧也会拒绝覆盖而非静默覆盖。

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

下载地址：

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