Skip to content
项目

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

English

运行要求

  • Node.js 24 或更高版本,推荐使用活跃的 LTS 版本。
  • mkvmerge 或 ffmpeg 为可选依赖。如需混流独立音视频轨道,请安装其中一个并将其加入 PATH。
  • 解密 fMP4/CMAF SAMPLE-AES(cbcs)播放列表时,需确保 Bento4 mp4decrypt 位于 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 成员。