N_m3u8DL-RE

# N_m3u8DL-RE

[See English version here](README.en.md)

跨平台的DASH/HLS/MSS下载工具。支持点播、直播(DASH/HLS)。

[![img](https://img.shields.io/github/stars/nilaoda/N_m3u8DL-RE?label=%E7%82%B9%E8%B5%9E)](https://github.com/nilaoda/N_m3u8DL-RE)  [![img](https://img.shields.io/github/last-commit/nilaoda/N_m3u8DL-RE?label=%E6%9C%80%E8%BF%91%E6%8F%90%E4%BA%A4)](https://github.com/nilaoda/N_m3u8DL-RE)  [![img](https://img.shields.io/github/release/nilaoda/N_m3u8DL-RE?label=%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC)](https://github.com/nilaoda/N_m3u8DL-RE/releases)  [![img](https://img.shields.io/github/license/nilaoda/N_m3u8DL-RE?label=%E8%AE%B8%E5%8F%AF%E8%AF%81)](https://github.com/nilaoda/N_m3u8DL-RE)   [![img](https://img.shields.io/github/downloads/nilaoda/N_m3u8DL-RE/total?label=%E4%B8%8B%E8%BD%BD%E9%87%8F)](https://github.com/nilaoda/N_m3u8DL-RE/releases)

遇到 BUG 请首先确认软件是否为最新版本（如果是 Release 版本，建议到 [Actions](https://github.com/nilaoda/N_m3u8DL-RE/actions) 页面下载最新自动构建版本后查看问题是否已经被修复），如果确认版本最新且问题依旧存在，可以到 [Issues](https://github.com/nilaoda/N_m3u8DL-RE/issues) 中查找是否有人遇到过相关问题，没有的话再进行询问。

---

版本较低的Windows系统自带的终端可能不支持本程序，替代方案：在 [cmder](https://github.com/cmderdev/cmder) 中运行。

Arch Linux 可以从 AUR 获取：[n-m3u8dl-re-bin](https://aur.archlinux.org/packages/n-m3u8dl-re-bin)、[n-m3u8dl-re-git](https://aur.archlinux.org/packages/n-m3u8dl-re-git)

```bash
# Arch Linux 及其衍生版安装 N_m3u8DL-RE 发行版 (该源非本人维护)
yay -Syu n-m3u8dl-re-bin

# Arch Linux 及其衍生版安装 N_m3u8DL-RE 开发版 (该源非本人维护)
yay -Syu n-m3u8dl-re-git
```

---

## PowerShell 补全

支持 Windows PowerShell 5.1 和 PowerShell 7。补全脚本内嵌在可执行文件中。将 `N_m3u8DL-RE` 加入 `PATH`，然后在 PowerShell 中加载：

```powershell
N_m3u8DL-RE --generate-completion powershell | Out-String | Invoke-Expression
```

输入 `N_m3u8DL-RE --sub-` 后按 Tab 可补全参数名；`--sub-format`、`--log-level`、`--ui-language` 等参数可补全可选值，文件和目录使用 PowerShell 的默认路径补全。以 `./N_m3u8DL-RE` 或完整路径调用程序时也可以使用。

加载仅对当前会话有效。如需每次启动时启用，可将上面的命令写入 `$PROFILE`。也可用 `--generate-completion powershell` 单独查看或保存脚本。

## Cookie 文件

使用 `--cookies cookies.txt` 读取浏览器导出的 Netscape 格式 Cookie 文件：

```text
N_m3u8DL-RE "https://example.com/video.m3u8" --cookies "cookies.txt"
```

Cookie 会按请求的域名、路径、HTTPS 条件及有效期匹配，适用于清单、密钥、初始化文件和分片，支持点播及直播。若同时设置 `-H "Cookie: ..."`，则以手动请求头为准。服务器更新的 Cookie 仅保存在内存中，不回写文件。

## 配置文件

常用选项可以保存到 UTF-8 文本配置文件中，程序启动时自动读取：

- Linux / macOS：`~/.config/N_m3u8DL-RE/config.conf`；若设置了绝对路径的 `XDG_CONFIG_HOME`，则使用 `$XDG_CONFIG_HOME/N_m3u8DL-RE/config.conf`。
- Windows：`%APPDATA%\N_m3u8DL-RE\config.conf`。

程序不会自动创建配置文件，默认文件不存在时使用内置默认值。配置沿用命令行参数语法，支持以 `#` 开头的注释行；包含空格的参数值使用双引号：

```text
# 常用下载选项
-mt
--no-log
--auto-select
--thread-count 16
--save-dir "Downloads/My Videos"
```

优先级为 **命令行 > 配置文件 > 内置默认值**。同一选项按短名和长名识别，单值选项由命令行替换配置值，被替换的值不再进行下载参数转换或文件读取。`--key`、`--ad-keyword`、`--mux-import` 等可重复选项按配置在前、命令行在后的顺序合并。`-H` / `--header` 按请求头名称合并，名称不区分大小写；不同名称保留，同名以命令行为准。布尔选项可用 `false` 关闭，例如 `--no-log false`。配置中的 HTTP 超时也视为手动指定，会关闭直播的自动超时调整。

```text
N_m3u8DL-RE "https://example.com/video.m3u8" --thread-count 8
N_m3u8DL-RE "https://example.com/vi