N_m3u8DL-RE nilaoda

dash ffmpeg hls ism live m3u8 m3u8-downloader mpd recorder

Use this command to install N_m3u8DL-RE with WinGet:

winget install --id=nilaoda.N_m3u8DL-RE -e

Cross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.

N_m3u8DL-RE

See English version here

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

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

版本较低的Windows系统自带的终端可能不支持本程序，替代方案：在 cmder 中运行。

Arch Linux 可以从 AUR 获取：n-m3u8dl-re-bin、n-m3u8dl-re-git

# 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 中加载：

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 单独查看或保存脚本。

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

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。

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

# 常用下载选项
-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 超时也视为手动指定，会关闭直播的自动超时调整。

N_m3u8DL-RE "https://example.com/video.m3u8" --thread-count 8
N_m3u8DL-RE "https://example.com/video.m3u8" --config "custom.conf"
N_m3u8DL-RE "https://example.com/video.m3u8" --no-config

--config FILE 只读取指定文件，替代默认配置；文件不存在或内容无效时报错。--no-config 不读取配置文件，不能与 --config 同时使用。配置只允许保存下载选项，不允许保存下载地址、配置加载选项或帮助、版本、补全操作。相对路径按当前工作目录解析，程序目录和当前目录不会被自动搜索。

帮助信息会使用配置中的 UI 语言；生成补全脚本及 Tab 补全请求不读取配置。原有 @args.txt 参数文件仍可使用，其中的参数具有命令行优先级。

Docker 部署建议将配置只读挂载到 /config/config.conf，并传入 --config /config/config.conf，不依赖容器的 HOME 或运行用户。

命令行参数

过长的自动保存名、自定义保存名和模板生成的文件名会自动缩短，并附加短哈希以减少重名。长度按 UTF-8 字节计算，不会截断中文或 emoji；自动名称的时间戳和输出文件的媒体扩展名会预留空间。

Description:
  N_m3u8DL-RE 0.6.0 20260628

Usage:
  N_m3u8DL-RE  [options]

Arguments:
    链接或文件

Options:
  --config                                          读取指定配置文件，替代用户默认配置；命令行选项优先
  --no-config                                             不读取配置文件，不能与 --config 同时使用
  --tmp-dir                                      设置临时文件存储目录
  --save-dir                                    设置输出目录
  --save-name                                  设置保存文件名
  --save-pattern                            设置保存文件命名模板. 输入 "--morehelp save-pattern" 以查看变量和示例
  --log-file-path                          设置日志文件路径, 例如 C:\Logs\log.txt
  --base-url                                    设置BaseURL
  --thread-count                                  设置下载线程数 [default: 本机CPU线程数]
  --download-retry-count                          每个分片下载异常时的重试次数；分片直播临时网络故障在重试耗尽后仍会等待恢复 [default: 3]
  --http-request-timeout                         HTTP请求超时(秒)；分片直播未指定时自动调整，指定后也用于分片连续无数据超时，不限制总下载时长 [default: 100]
  --force-ansi-console                                    强制认定终端为支持ANSI且可交互的终端
  --no-ansi-color                                         去除ANSI颜色
  --auto-select                                           自动选择所有类型的最佳轨道 [default: False]
  --skip-merge                                            跳过合并分片 [default: False]
  --skip-download                                         跳过下载 [default: False]
  --check-segments-count                                  检测实际下载的分片数量和预期数量是否匹配 [default: True]
  --binary-merge                                          二进制合并 [default: False]
  --use-ffmpeg-concat-demuxer                             使用 ffmpeg 合并时，使用 concat 分离器而非 concat 协议 [default: False]
  --del-after-done                                        完成后删除临时文件 [default: True]
  --no-date-info                                          混流时不写入日期信息 [default: False]
  --no-log                                                关闭日志文件输出 [default: False]
  --write-meta-json                                       解析后的信息是否输出json文件 [default: True]
  --append-url-params                                     将输入URL的查询参数添加至分片；本地清单使用 --base-url 的参数 [default: False]
  -mt, --concurrent-download                              并发下载已选择的音频、视频和字幕 [default: False]
  -H, --header                                    为HTTP请求设置特定的请求头, 例如:
                                                          -H "Cookie: mycookie" -H "User-Agent: iOS"
  --cookies                                         读取 Netscape 格式的 Cookie 文件；手动设置的 Cookie 请求头优先
  --sub-only                                              只选取字幕轨道 [default: False]
  --sub-format                                   字幕输出类型 [default: SRT]
  --auto-subtitle-fix                                     自动修正字幕 [default: True]
  --ffmpeg-binary-path                              ffmpeg可执行程序全路径, 例如 C:\Tools\ffmpeg.exe
  --log-level                  设置日志级别 [default: INFO]
  --ui-language                        设置UI语言
  --urlprocessor-args                  此字符串将直接传递给URL Processor
  --key                                              设置解密密钥, 程序调用mp4decrpyt/shaka-packager/ffmpeg进行解密. 格式:
                                                          --key KID1:KEY1 --key KID2:KEY2
                                                          对于KEY相同的情况可以直接输入 --key KEY
  --key-text-file                          设置密钥文件,程序将从文件中按KID搜寻KEY以解密.(不建议使用特大文件)
  --decryption-engine   设置解密时使用的第三方程序 [default: MP4DECRYPT]
  --decryption-binary-path                          MP4解密所用工具的全路径, 例如 C:\Tools\mp4decrypt.exe
  --mp4-real-time-decryption                              实时解密MP4分片 [default: False]
  -R, --max-speed                                  设置限速，单位支持 Mbps 或 Kbps，如：15M 100K
  -M, --mux-after-done                           所有工作完成时尝试混流分离的音视频. 输入 "--morehelp mux-after-done" 以查看详细信息
  --custom-hls-method                             指定HLS加密方式 (AES_128|AES_128_ECB|CENC|CHACHA20|NONE|SAMPLE_AES|SAMPLE_AES_CTR|UNKNOWN)
  --custom-hls-key                       指定HLS解密KEY. 可以是文件, HEX或Base64
  --custom-hls-iv                        指定HLS解密IV. 可以是文件, HEX或Base64
  --custom-hls-scope                               指定自定义HLS加密方式、KEY和IV的适用范围 (ALL|VIDEO|AUDIO) [default: ALL]
  --use-system-proxy                                      使用系统默认代理 [default: True]
  --custom-proxy                                     设置请求代理, 如 http://127.0.0.1:8888
  --interface                                  指定请求使用的网卡名或本机 IP，如 eth1 或 192.168.1.10
  --custom-range                                   仅下载部分分片. 输入 "--morehelp custom-range" 以查看详细信息
  --task-start-at                         在此时间之前不会开始执行任务
  --live-perform-as-vod                                   以点播方式下载直播流 [default: False]
  --live-real-time-merge                                  录制直播时实时合并 [default: False]
  --live-keep-segments                                    录制直播并开启实时合并时依然保留分片 [default: True]
  --live-pipe-mux                                         录制直播并开启实时合并时通过管道+ffmpeg实时混流到TS文件 [default: False]
  --live-fix-vtt-by-audio                                 通过读取音频文件的起始时间修正VTT字幕 [default: False]
  --live-record-limit                           录制直播时的录制时长限制
  --live-wait-time                                   手动设置直播列表刷新间隔
  --live-idle-timeout                                直播列表连续指定秒数无新分片时停止录制（默认关闭）
  --live-take-count                                  手动设置录制直播时首次获取分片的数量 [default: 16]
  --mux-import                                   混流时引入外部媒体文件. 输入 "--morehelp mux-import" 以查看详细信息
  -sv, --select-video                            通过正则表达式选择符合要求的视频流. 输入 "--morehelp select-video" 以查看详细信息
  -sa, --select-audio                            通过正则表达式选择符合要求的音频流. 输入 "--morehelp select-audio" 以查看详细信息
  -ss, --select-subtitle                         通过正则表达式选择符合要求的字幕流. 输入 "--morehelp select-subtitle" 以查看详细信息
  -dv, --drop-video                              通过正则表达式去除符合要求的视频流. 支持与 --select-video 相同的参数, 输入 "--morehelp select-video" 以查看详细信息
  -da, --drop-audio                              通过正则表达式去除符合要求的音频流. 支持与 --select-video 相同的参数, 输入 "--morehelp select-video" 以查看详细信息
  -ds, --drop-subtitle                           通过正则表达式去除符合要求的字幕流. 支持与 --select-video 相同的参数, 输入 "--morehelp select-video" 以查看详细信息
  --ad-keyword                                       设置广告分片的URL关键字(正则表达式)
  --vod-select-parts                                      控制点播选段交互：不传则自动判断，true 强制显示，false 关闭（空格勾选，回车确认）
  --vod-list-parts                                        按媒体配置归组列出点播段的编号和总时长后退出 [default: False]
  --vod-drop-parts                                   按 --vod-list-parts 的编号删除整个点播段及对应音频/字幕，例如 0,2-4
  --disable-update-check                                  禁用版本更新检测 [default: False]
  --allow-hls-multi-ext-map                               允许直播HLS中的多个#EXT-X-MAP(实验性；点播默认支持) [default: False]
  --morehelp

N_m3u8DL-RE

See English version here

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

版本较低的Windows系统自带的终端可能不支持本程序，替代方案：在 cmder 中运行。

Arch Linux 可以从 AUR 获取：n-m3u8dl-re-bin、n-m3u8dl-re-git

# 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 中加载：

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

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

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

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

配置文件

常用选项可以保存到 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。

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

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

N_m3u8DL-RE "https://example.com/video.m3u8" --thread-count 8
N_m3u8DL-RE "https://example.com/video.m3u8" --config "custom.conf"
N_m3u8DL-RE "https://example.com/video.m3u8" --no-config

帮助信息会使用配置中的 UI 语言；生成补全脚本及 Tab 补全请求不读取配置。原有 @args.txt 参数文件仍可使用，其中的参数具有命令行优先级。

Docker 部署建议将配置只读挂载到 /config/config.conf，并传入 --config /config/config.conf，不依赖容器的 HOME 或运行用户。

命令行参数

Description:
  N_m3u8DL-RE 0.6.0 20260628

Usage:
  N_m3u8DL-RE  [options]

Arguments:
    链接或文件

Options:
  --config                                          读取指定配置文件，替代用户默认配置；命令行选项优先
  --no-config                                             不读取配置文件，不能与 --config 同时使用
  --tmp-dir                                      设置临时文件存储目录
  --save-dir                                    设置输出目录
  --save-name                                  设置保存文件名
  --save-pattern                            设置保存文件命名模板. 输入 "--morehelp save-pattern" 以查看变量和示例
  --log-file-path                          设置日志文件路径, 例如 C:\Logs\log.txt
  --base-url                                    设置BaseURL
  --thread-count                                  设置下载线程数 [default: 本机CPU线程数]
  --download-retry-count                          每个分片下载异常时的重试次数；分片直播临时网络故障在重试耗尽后仍会等待恢复 [default: 3]
  --http-request-timeout                         HTTP请求超时(秒)；分片直播未指定时自动调整，指定后也用于分片连续无数据超时，不限制总下载时长 [default: 100]
  --force-ansi-console                                    强制认定终端为支持ANSI且可交互的终端
  --no-ansi-color                                         去除ANSI颜色
  --auto-select                                           自动选择所有类型的最佳轨道 [default: False]
  --skip-merge                                            跳过合并分片 [default: False]
  --skip-download                                         跳过下载 [default: False]
  --check-segments-count                                  检测实际下载的分片数量和预期数量是否匹配 [default: True]
  --binary-merge                                          二进制合并 [default: False]
  --use-ffmpeg-concat-demuxer                             使用 ffmpeg 合并时，使用 concat 分离器而非 concat 协议 [default: False]
  --del-after-done                                        完成后删除临时文件 [default: True]
  --no-date-info                                          混流时不写入日期信息 [default: False]
  --no-log                                                关闭日志文件输出 [default: False]
  --write-meta-json                                       解析后的信息是否输出json文件 [default: True]
  --append-url-params                                     将输入URL的查询参数添加至分片；本地清单使用 --base-url 的参数 [default: False]
  -mt, --concurrent-download                              并发下载已选择的音频、视频和字幕 [default: False]
  -H, --header                                    为HTTP请求设置特定的请求头, 例如:
                                                          -H "Cookie: mycookie" -H "User-Agent: iOS"
  --cookies                                         读取 Netscape 格式的 Cookie 文件；手动设置的 Cookie 请求头优先
  --sub-only                                              只选取字幕轨道 [default: False]
  --sub-format                                   字幕输出类型 [default: SRT]
  --auto-subtitle-fix                                     自动修正字幕 [default: True]
  --ffmpeg-binary-path                              ffmpeg可执行程序全路径, 例如 C:\Tools\ffmpeg.exe
  --log-level                  设置日志级别 [default: INFO]
  --ui-language                        设置UI语言
  --urlprocessor-args                  此字符串将直接传递给URL Processor
  --key                                              设置解密密钥, 程序调用mp4decrpyt/shaka-packager/ffmpeg进行解密. 格式:
                                                          --key KID1:KEY1 --key KID2:KEY2
                                                          对于KEY相同的情况可以直接输入 --key KEY
  --key-text-file                          设置密钥文件,程序将从文件中按KID搜寻KEY以解密.(不建议使用特大文件)
  --decryption-engine   设置解密时使用的第三方程序 [default: MP4DECRYPT]
  --decryption-binary-path                          MP4解密所用工具的全路径, 例如 C:\Tools\mp4decrypt.exe
  --mp4-real-time-decryption                              实时解密MP4分片 [default: False]
  -R, --max-speed                                  设置限速，单位支持 Mbps 或 Kbps，如：15M 100K
  -M, --mux-after-done                           所有工作完成时尝试混流分离的音视频. 输入 "--morehelp mux-after-done" 以查看详细信息
  --custom-hls-method                             指定HLS加密方式 (AES_128|AES_128_ECB|CENC|CHACHA20|NONE|SAMPLE_AES|SAMPLE_AES_CTR|UNKNOWN)
  --custom-hls-key                       指定HLS解密KEY. 可以是文件, HEX或Base64
  --custom-hls-iv                        指定HLS解密IV. 可以是文件, HEX或Base64
  --custom-hls-scope                               指定自定义HLS加密方式、KEY和IV的适用范围 (ALL|VIDEO|AUDIO) [default: ALL]
  --use-system-proxy                                      使用系统默认代理 [default: True]
  --custom-proxy                                     设置请求代理, 如 http://127.0.0.1:8888
  --interface                                  指定请求使用的网卡名或本机 IP，如 eth1 或 192.168.1.10
  --custom-range                                   仅下载部分分片. 输入 "--morehelp custom-range" 以查看详细信息
  --task-start-at                         在此时间之前不会开始执行任务
  --live-perform-as-vod                                   以点播方式下载直播流 [default: False]
  --live-real-time-merge                                  录制直播时实时合并 [default: False]
  --live-keep-segments                                    录制直播并开启实时合并时依然保留分片 [default: True]
  --live-pipe-mux                                         录制直播并开启实时合并时通过管道+ffmpeg实时混流到TS文件 [default: False]
  --live-fix-vtt-by-audio                                 通过读取音频文件的起始时间修正VTT字幕 [default: False]
  --live-record-limit                           录制直播时的录制时长限制
  --live-wait-time                                   手动设置直播列表刷新间隔
  --live-idle-timeout                                直播列表连续指定秒数无新分片时停止录制（默认关闭）
  --live-take-count                                  手动设置录制直播时首次获取分片的数量 [default: 16]
  --mux-import                                   混流时引入外部媒体文件. 输入 "--morehelp mux-import" 以查看详细信息
  -sv, --select-video                            通过正则表达式选择符合要求的视频流. 输入 "--morehelp select-video" 以查看详细信息
  -sa, --select-audio                            通过正则表达式选择符合要求的音频流. 输入 "--morehelp select-audio" 以查看详细信息
  -ss, --select-subtitle                         通过正则表达式选择符合要求的字幕流. 输入 "--morehelp select-subtitle" 以查看详细信息
  -dv, --drop-video                              通过正则表达式去除符合要求的视频流. 支持与 --select-video 相同的参数, 输入 "--morehelp select-video" 以查看详细信息
  -da, --drop-audio                              通过正则表达式去除符合要求的音频流. 支持与 --select-video 相同的参数, 输入 "--morehelp select-video" 以查看详细信息
  -ds, --drop-subtitle                           通过正则表达式去除符合要求的字幕流. 支持与 --select-video 相同的参数, 输入 "--morehelp select-video" 以查看详细信息
  --ad-keyword                                       设置广告分片的URL关键字(正则表达式)
  --vod-select-parts                                      控制点播选段交互：不传则自动判断，true 强制显示，false 关闭（空格勾选，回车确认）
  --vod-list-parts                                        按媒体配置归组列出点播段的编号和总时长后退出 [default: False]
  --vod-drop-parts                                   按 --vod-list-parts 的编号删除整个点播段及对应音频/字幕，例如 0,2-4
  --disable-update-check                                  禁用版本更新检测 [default: False]
  --allow-hls-multi-ext-map                               允许直播HLS中的多个#EXT-X-MAP(实验性；点播默认支持) [default: False]
  --morehelp

N_m3u8DL-RE nilaoda

README

N_m3u8DL-RE

PowerShell 补全

配置文件

命令行参数

N_m3u8DL-RE nilaoda

README

N_m3u8DL-RE

PowerShell 补全

配置文件

命令行参数