# 读读窝

## 依赖
* mkvmerge (可选，mkv 格式输出需要)

! Minyami 要求使用处于 活跃/维护LTS 或 当前版 状态的 最新版 Node.js。推荐选用 活跃LTS。详见[这里](https://nodejs.org/zh-cn/about/releases/)。

需安装并确保系统变量`PATH`中添加可执行程序所在的路径。

## 安装

`npm -g i minyami` 或 `yarn global add minyami`

此外，请安装插件配合 Minyami 使用。

1. 安装 Chrome 插件（推荐）：https://chrome.google.com/webstore/detail/minyami/cgejkofhdaffiifhcohjdbbheldkiaed （同样[开源](https://github.com/Last-Order/Minyami-chrome-extension)）。


## 用法
```
Help:
     命令                      描述                   别名

     --help <command>              显示帮助       -h
         <command>                 显示某命令的帮助
     --version                     显示版本号
     --download <input_path>       下载视频             -d
         <input_path>              m3u8 文件路径
         --threads <limit>         并发数量限制
             <limit>               (可选) 并发数量的限制，默认为5
         --retries <limit>         重试次数
             <limit>               (可选) 重试次数的限制
         --output, o <path>        输出限制
             <path>                (可选) 输出文件路径，默认为 ./output.mkv
         --key <key>               手动设置 Key
             <key>                 (可选) 视频解密 Key.
         --cookies <cookies>       (可选) 视频下载 Cookies
             <cookies>
         --headers, H <headers>    手动设定 HTTP Header
             <headers>             自定义 HTTP Header，例如："User-Agent: X-UA"
         --live                    直播下载模式
         --format <format_name>    (可选) 输出格式，默认为 ts
             <format_name>         格式名称，ts 或 mkv
         --proxy <proxy-server>    为 Minyami 设置代理
             <proxy-server>        代理地址，格式为 [protocol://<host>:<port>] 例如 --proxy "http://127.0.0.1:1080"
         --slice <range>           下载部分内容
             <range>               设置时间范围，格式为 [<hh:mm:ss>-<hh:mm:ss> format] 例如 --slice "45:00-53:00"
         --nomerge, keep           不合并视频分块。
     --resume <input_path>         恢复下载 (不适用于直播)  -r
         <input_path>              m3u8 文件路径
     --clean                       清除缓存文件和任务信息

选项:

     选项名                       描述
     --verbose, debug             调试输出
```

## 常见问题

Q: 下载时需要保持视频窗口打开吗？

A: 不需要。

Q: 如何设置代理？

A: 可以使用`--proxy`参数设置代理，详见上方用法。目前支持`HTTP/HTTPS/SOCKS5`代理。您也可以使用环境变量设置代理，默认读取`HTTP_PROXY`/`HTTPS_PROXY`/`ALL_PROXY`。

Q: 如何设置临时文件目录？

A: 通过环境变量可以设置临时文件目录。详见 [Issue #80](https://github.com/Last-Order/Minyami/issues/80#issuecomment-869132412)。

Q: 如何设置多个 HTTP Header？

A: 通过设置多个`-H`或`--headers`，例如`minyami -d xxxx -H "Cookie: xxxx" --headers "User-Agent: yyy"`。