M3U8 视频下载器

支持并行分段下载和自动解密的HLS/m3u8视频下载工具。

前置依赖

• - aria2c（安装：brew install aria2）
• ffmpeg（安装：brew install ffmpeg）

完整工作流程（从网页到MP4）

步骤1：从网页提取m3u8地址

如果提供的是网页URL（而非直接m3u8链接），使用浏览器自动化查找流地址：

javascript
// 在浏览器控制台或通过浏览器工具执行
(() => {
// 检查HLS.js播放器实例
if (window.hls && window.hls.url) return window.hls.url;
if (window.player && window.player.hls && window.player.hls.url) return window.player.hls.url;

// 在window对象中搜索m3u8地址
const allVars = Object.keys(window).filter(k => {
try {
return window[k] && typeof window[k] === object &&
window[k].url && window[k].url.includes(m3u8);
} catch(e) { return false; }
});
return allVars.length > 0 ? allVars.map(k => window[k].url) : 未找到;
})()

使用 profile=openclaw（隔离浏览器）以避免浏览器历史记录。

步骤2：处理主播放列表（多码率）

主播放列表列出的是不同质量的变体，而非分段：

bash
curl -s https://example.com/playlist.m3u8

输出示例：

#EXT-X-STREAM-INF:BANDWIDTH=8247061,RESOLUTION=1920x1080

1080p/video.m3u8

#EXT-X-STREAM-INF:BANDWIDTH=4738061,RESOLUTION=1280x720

720p/video.m3u8

选择最高质量（例如1080p）并获取对应的子播放列表：

bash
BASE_URL=https://example.com
curl -s ${BASE_URL}/1080p/video.m3u8

步骤3：提取分段地址

分段可能使用非标准扩展名（例如 .jpeg 而非 .ts）：

bash
mkdir -p /tmp/videodownload && cd /tmp/videodownload

BASE_URL=https://example.com/1080p
curl -s ${BASE_URL}/video.m3u8 | grep -E ^[^#] | while read seg; do
echo ${BASE_URL}/${seg}
done > urls.txt

统计分段数量

wc -l urls.txt

步骤4：使用aria2c并行下载

bash
aria2c -i urls.txt -j 16 -x 16 -s 16 --file-allocation=none -c true \
--console-log-level=warn --summary-interval=30

• - -j 16：16个并发下载
• -x 16：每个文件16个连接
• -c true：继续部分下载

步骤5：使用ffmpeg合并

bash

获取分段数量

NUM_SEGMENTS=$(wc -l < urls.txt)

生成文件列表（根据需要调整文件名模式）

for i in $(seq 0 $((NUM_SEGMENTS-1))); do echo file video${i}.jpeg # 或 video${i}.ts done > filelist.txt

合并（复制流，不重新编码）

ffmpeg -y -f concat -safe 0 -i filelist.txt -c copy ~/Downloads/output.mp4

步骤6：清理

bash
rm -rf /tmp/video_download

快速脚本使用

bash
~/clawd/skills/m3u8-downloader/scripts/download.sh https://example.com/video.m3u8 输出文件名

注意：该脚本可能无法处理所有边界情况（主播放列表、非标准扩展名）。对于复杂流，请使用上述手动流程。

处理加密流（AES-128）

在播放列表中查找 #EXT-X-KEY:METHOD=AES-128,URI=enc.key：

bash
curl -s https://example.com/path/enc.key -o enc.key
ffmpeg -allowedextensions ALL -i localplaylist.m3u8 -c copy output.mp4

输出

最终视频保存为 ~/Downloads/<输出文件名>.mp4