使用 Java 开发的 M3U8 视频下载桌面应用,目标是尽可能快速、完整地下载并合并视频。
- 使用虚拟线程并发下载
- 支持 HTTP/2、范围传输、内容压缩和按服务端响应状态重试
- 支持 HTTP 代理
- 支持 AES-128 解密
- 支持暂停、错误重试
- 支持自动合并为 MP4
本软件仅用于下载用户本人拥有、已获权利人授权或依法允许保存的内容。请勿将本软件用于未经许可 规避或破坏 DRM、付费访问限制及其他版权保护技术措施,也不得下载、复制或传播侵权内容。
用户应自行确认内容来源、授权范围和使用方式是否合法,并对自己的下载及后续使用行为负责。
请从 GitHub Releases 下载已发布版本。
- JDK 26
- Maven Wrapper
- IntelliJ IDEA
项目已提交 Maven Wrapper,首次构建无需单独安装 Maven。
Windows:
./mvnw.cmd testLinux 或 macOS:
./mvnw test运行测试:
./mvnw.cmd test生成当前平台便携版:
./mvnw.cmd clean verify -P portable构建完成后主要产物:
target/jpackage/m3u8-downloader/:可直接运行的便携版应用目录,内置精简 Java Runtime。target/m3u8-downloader-0.0.2-<platform>.zip:便携版压缩包,解压后即可运行。
注意:jpackage 只能生成当前操作系统对应的平台应用目录。例如 Windows 上生成 Windows 便携版,macOS 上生成 macOS 便携版。
项目使用 GitHub Actions 自动构建以下便携版产物:
windows-x86_64linux-x86_64linux-arm64macosx-x86_64macosx-arm64
推送 v* tag 时,CI 会自动创建或更新 GitHub Release,并上传各平台 zip 和 sha256 校验文件。
提交 issue 或 pull request 前,请阅读 CONTRIBUTING.md。
安全问题请阅读 SECURITY.md,不要通过公开 issue 披露敏感漏洞。
- 发布流程:docs/release-checklist.md
- 分支保护建议:docs/branch-protection.md
- 版本记录:CHANGELOG.md
Copyright (C) 2024 xuMingHai。
本项目采用 GNU General Public License v3.0 or later 许可证发布,对应 SPDX 标识为
GPL-3.0-or-later。
发布包包含的第三方开源组件及其许可证见 第三方软件声明。

