Last-Order/Minyami
Last-Order/Minyami has 646 GitHub stars and 41 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-19 04:43 UTC. Last push 2026-11-11.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
A lovely video downloader for HLS videos
创作与媒体readme.zh-cn.md
原文Minyami
运行要求
- Node.js 24 或更高版本,推荐使用活跃的 LTS 版本。
mkvmerge或ffmpeg为可选依赖。如需混流独立音视频轨道,请安装其中一个并将其加入PATH。- 解密 fMP4/CMAF
SAMPLE-AES(cbcs)播放列表时,需确保 Bento4mp4decrypt位于PATH中。
安装
npm install --global minyami
也可以使用 Yarn:
yarn global add minyami
如需在 Chrome 中方便地检测播放列表,请安装 Minyami Chrome 扩展。扩展源码位于独立仓库。
命令行用法
下载播放列表:
minyami "https://example.com/video.m3u8" --output "./video.ts"
常用示例:
# 使用 8 个并发下载任务
minyami -d "https://example.com/video.m3u8" --threads 8
# 添加多个请求头
minyami -d "https://example.com/video.m3u8" -H "Cookie: session=..." -H "User-Agent: ..."
# 下载指定时间范围
minyami -d "https://example.com/video.m3u8" --slice "45:00-53:00"
# 持续下载直播,直至手动停止命令
minyami -d "https://example.com/live.m3u8" --live
# 使用 HTTP、HTTPS 或 SOCKS5 代理
minyami -d "https://example.com/video.m3u8" --proxy "http://127.0.0.1:1080"
参数
下载命令必须提供 URL 或本地播放列表路径;缺少输入时会显示错误和帮助。
--output 和 --slice 必须提供字符串值。无效值会被报告并忽略,其他有效参数仍然生效。
| 参数 | 说明 |
|---|---|
--help、-h |
显示帮助;传入命令名可查看对应命令的帮助。 |
--version |
显示当前版本。 |
--download <input>、-d <input> |
下载 m3u8 地址或文件。 |
--threads <数量> |
设置并发数量,默认为 5。 |
--retries <次数> |
同时设置来源请求和下载任务的最大尝试次数,默认为 5。 |
--output <路径>、-o <路径> |
设置输出文件基名,默认为 ./output。 |
--temp-dir <路径> |
设置临时文件所在的父目录。 |
--key <key|kid:key> |
手动指定 HLS 解密密钥。一个密钥应用于所有 AES-128 key URI;重复传入时在每个 Media Playlist 内按各 URI 首次出现的顺序依次对应。fMP4 SAMPLE-AES 的多个密钥必须使用 kid:key。 |
--cookies <内容> |
为下载请求添加 Cookie。 |
--headers <请求头>、-H <请求头> |
添加 HTTP 请求头;可重复使用以添加多个请求头。 |
--live |
持续下载直播播放列表。 |
--proxy <地址> |
使用 HTTP、HTTPS 或 SOCKS5 代理。 |
--no-proxy |
忽略代理环境变量和系统代理设置。 |
--slice <开始-结束> |
下载指定时间范围,例如 45:00-53:00。 |
--no-merge |
不合并已下载的分块。 |
--keep、-k |
保留临时文件。 |
--keep-encrypted-chunks |
解密后保留加密分块,需与 --keep 一起使用。 |
--verbose、--debug |
输出调试信息。 |
配置文件
可以在 ~/.minyami/.minyamirc、~/.minyami/.minyamirc.json 或 ~/.minyami/minyami.config.json 中放置 JSON
对象。按上述顺序使用第一个可读取且能解析为 JSON 对象的文件作为默认配置。字段使用 CLI 参数的驼峰名称,例如 noProxy、tempDir 和
keepEncryptedChunks:
{
"threads": 8,
"noProxy": true,
"verbose": true
}
作为库使用
Minyami 以 ESM 格式发布,请使用 import 加载,不支持 CommonJS require()。
下载点播播放列表:
import { createArchiveDownloader } from "minyami";
const downloader = createArchiveDownloader("https://example.com/archive.m3u8", {
output: "./archive.ts",
threads: 8,
});
downloader.on("chunk-downloaded", (chunk) => {
console.log(chunk);
});
await downloader.download();
通过库调用时,需将解析后的显式密钥作为 HLSExplicitKey 对象传入,例如 explicitKeys: [{ key }] 或
explicitKeys: [{ kid, key }];CLI 则接受等价的紧凑格式 key 和 kid:key。对于 AES-128,一个显式密钥会
应用于所有 key URI;多个密钥则在每个 Media Playlist 内按不同 key URI 的首次出现顺序依次绑定,并在直播
刷新时保留绑定。fMP4 SAMPLE-AES 的多个密钥则通过 KID 选择。
下载直播时使用 createLiveDownloader,需要结束下载时调用 stop():
import { createLiveDownloader } from "minyami";
const downloader = createLiveDownloader("https://example.com/live.m3u8", {
output: "./live.ts",
});
setTimeout(() => downloader.stop(), 60_000);
await downloader.download();
可以使用 streamSelector 从 master playlist 中选择轨道。返回某个选项中的轨道,或返回 undefined 取消下载:
const downloader = createArchiveDownloader("https://example.com/master.m3u8", {
streamSelector: (catalog) =>
catalog.options.find((option) =>
option.tracks.some((track) => track.type === "video" && track.height === 720)
)?.tracks,
});
await downloader.download();
未设置 streamSelector 时,库会选择最高带宽选项中的全部轨道。
常见问题
下载时需要保持浏览器窗口打开吗?
不需要。
如何设置代理?
使用 --proxy,或设置 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 环境变量。在 Windows 上,Minyami 也可以读取系统代理设置。使用 --no-proxy 可忽略这些代理配置。
如何修改临时文件目录?
使用 --temp-dir <路径>。默认情况下,Minyami 会在当前工作目录中创建 minyami_<时间戳>_<随机值> 目录。
如何添加多个 HTTP 请求头?
重复使用 -H 或 --headers:
minyami -d "https://example.com/video.m3u8" -H "Cookie: ..." --headers "User-Agent: ..."
许可证
GPLv3。© 2018-2025 Eridanus Sora,MeowSound Idols 成员。