# NewM3u8Puller **Repository Path**: fkdexq/NewM3u8Puller ## Basic Information - **Project Name**: NewM3u8Puller - **Description**: No description available - **Primary Language**: C# - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-04 - **Last Updated**: 2026-08-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # NewM3u8Puller 一个重新实现的 Windows HLS(M3U8)点播下载器,参考旧版 M3u8Puller 的交互方式,但下载核心已重写。 ## 已修复的问题 - 使用 `HttpClient`,保留系统 HTTPS 证书校验,不再全局信任任意证书。 - 每个任务和每台服务器都有明确并发上限,不创建无限长期线程。 - 支持取消、暂停后继续、失败重试和指数退避。 - 分片独立原子落盘;已有非空分片会被复用,程序重启后可继续。 - 正确按原始字节读取 AES-128 Key,只解密一次;支持显式 IV、媒体序列号默认 IV 和 Key 轮换。 - 使用标准 `Uri` 解析相对、绝对、跨 CDN 和带查询参数的地址。 - 支持主播放列表(默认选最高带宽)、`EXT-X-BYTERANGE` 和 `EXT-X-MAP`。 - 任务数据写到 `%LOCALAPPDATA%\NewM3u8Puller`,并使用临时文件原子替换。 - 找到 FFmpeg 时用流复制封装为目标格式;找不到时输出真实的 `.ts` 文件,不伪装成 MP4。 - 不吞掉下载错误,界面会显示明确失败原因。 ## 构建与运行 需要 Windows、.NET Framework 4.7.2 Developer Pack,以及可用的 Visual Studio/MSBuild 或 .NET SDK: ```powershell dotnet build .\NewM3u8Puller.sln dotnet run --project .\src\NewM3u8Puller.WinForms ``` 运行离线测试: ```powershell dotnet run --project .\tests\NewM3u8Puller.Tests ``` 建议把 `ffmpeg.exe` 加入 `PATH`,这样程序能把下载内容无损封装为 MP4。 主窗口的“设置”可配置默认保存目录、分片并发数和 FFmpeg 路径;设置保存在 `%LOCALAPPDATA%\NewM3u8Puller\settings.json`。 三个窗口均采用标准 WinForms `Form.cs + Form.Designer.cs` 结构。在 Visual Studio 解决方案资源管理器中右键窗体并选择“查看设计器”,即可拖放控件调整布局。 ## 当前边界 - 只处理带 `EXT-X-ENDLIST` 的点播列表;直播需要持续刷新和窗口淘汰策略,当前会明确拒绝。 - 支持 HLS AES-128,不支持 SAMPLE-AES/DRM。 - 默认选择主播放列表中带宽最高的清晰度,界面暂未提供手动清晰度选择。