# N_m3u8DL-RE [See English version here](README.en.md) 跨平台的DASH/HLS/MSS下载工具。支持点播、直播(DASH/HLS)。 [](https://github.com/nilaoda/N_m3u8DL-RE) [](https://github.com/nilaoda/N_m3u8DL-RE) [](https://github.com/nilaoda/N_m3u8DL-RE/releases) [](https://github.com/nilaoda/N_m3u8DL-RE) [](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 ``` --- ## 命令行参数 ``` /* Detailed source-code truncated for AI context efficiency. */ ``` 点击查看More Help ``` More Help: --mux-after-done 所有工作完成时尝试混流分离的音视频. 你能够以:分隔形式指定如下参数: * format=FORMAT: 指定混流容器 mkv, mp4 * muxer=MUXER: 指定混流程序 ffmpeg, mkvmerge (默认: ffmpeg) * bin_path=PATH: 指定程序路径 (默认: 自动寻找) * skip_sub=BOOL: 是否忽略字幕文件 (默认: false) * keep=BOOL: 混流完成是否保留文件 true, false (默认: false) 例如: # 混流为mp4容器 -M format=mp4 # 使用mkvmerge, 自动寻找程序 -M format=mkv:muxer=mkvmerge # 使用mkvmerge, 自定义程序路径 -M format=mkv:muxer=mkvmerge:bin_path="C\:\Program Files\MKVToolNix\mkvmerge.exe" ``` ``` More Help: --mux-import 混流时引入外部媒体文件. 你能够以:分隔形式指定如下参数: * path=PATH: 指定媒体文件路径 * lang=CODE: 指定媒体文件语言代码 (非必须) * name=NAME: 指定媒体文件描述信息 (非必须) 例如: # 引入外部字幕 --mux-import path=zh-Hans.srt:lang=chi:name="中文 (简体)" # 引入外部音轨+字幕 --mux-import path="D\:\media\atmos.m4a":lang=eng:name="English Description Audio" --mux-import path="D\:\media\eng.vtt":lang=eng:name="English (Description)" ``` ``` More Help: --select-video 通过正则表达式选择符合要求的视频流. 你能够以:分隔形式指定如下参数: id=REGEX:lang=REGEX:name=REGEX:codecs=REGEX:res=REGEX:frame=REGEX segsMin=number:segsMax=number:ch=REGEX:range=REGEX:url=REGEX plistDurMin=hms:plistDurMax=hms:for=FOR * for=FOR: 选择方式. best[number], worst[number], all (默认: best) 例如: # 选择最佳视频 -sv best # 选择4K+HEVC视频 -sv res="3840*":codecs=hvc1:for=best # 选择长度大于1小时20分钟30秒的视频 -sv plistDurMin="1h20m30s":for=best ``` ``` More Help: --select-audio 通过正则表达式选择符合要求的音频流. 参考 --select-video 例如: # 选择所有音频 -sa all # 选择最佳英语音轨 -sa lang=en:for=best # 选择最佳的2条英语(或日语)音轨 -sa lang="ja|en":for=best2 ``` ``` More Help: --select-subtitle 通过正则表达式选择符合要求的字幕流. 参考 --select-video 例如: # 选择所有字幕 -ss all # 选择所有带有"中文"的字幕 -ss name="中文":for=all ``` ``` More Help: --custom-range 下载点播内容时, 仅下载部分分片. 例如: # 下载[0,10]共11个分片 --custom-range 0-10 # 下载从序号10开始的后续分片 --custom-range 10- # 下载前100个分片 --custom-range -99 # 下载第5分钟到20分钟的内容 --custom-range 05:00-20:00 ``` ``` More Help: --save-pattern 使用变量设置输出文件命名模板. 支持的变量: * : 用户指定的保存名称 (--save-name) * : 流的任务ID * : 编解码器信息 (例如: avc1.64001f, mp4a.40.2) * : 语言代码 (例如: en, zh-CN) * : 视频分辨率 (例如: 1920x1080) * : 流的带宽/比特率 * : 媒体类型 (VIDEO, AUDIO, SUBTITLES) * : 音频声道配置 * : 帧率 * : 视频色域/HDR信息 (SDR, HDR10等) * : 流组标识符 使用场景: 当下载多个相同类型的流时(例如多个不同分辨率的视频)，使用此选项可以避免文件名冲突。 例如: # 下载1080p和720p视频，文件名包含分辨率 --save-pattern "_" --save-name "video" # 输出: video_1920x1080.mp4, video_1280x720.mp4 # 包含带宽信息 --save-pattern "__kbps" # 输出: video_1920x1080_5000000kbps.mp4 # 下载多个音频流，包含语言和声道 --save-pattern "__ch" # 输出: audio_en_2ch.m4a, audio_es_2ch.m4a, audio_en_6ch.m4a # 复杂模板 --save-pattern "___" # 输出: VIDEO_1920x1080_avc1.64001f_en.mp4 注意: 如果不使用 --save-pattern，程序会在文件名冲突时自动使用流的元数据(分辨率、带宽等) 生成唯一的文件名，而不是简单地添加 ".copy" 后缀。 ``` ## 其他 从 v0.1.5 开始，可以尝试开启 `live-pipe-mux` 来代替以上命令 > [!NOTE] > 如果网络环境不够稳定，请不要开启 `live-pipe-mux`。管道内数据读取由 ffmpeg 负责，在某些环境下容易丢失直播数据。 从 v0.1.8 开始，能够通过设置环境变量 `RE_LIVE_PIPE_OPTIONS` 来改变 `live-pipe-mux` 时 ffmpeg 的某些选项： --- **免责声明** 本软件基于 [MIT License](LICENSE) 开源，按"原样"提供，不附带任何明示或暗示的保证（包括但不限于对适销性、特定用途适用性的保证）。在任何情况下，作者均不对因使用本软件而产生的任何直接或间接损失承担责任。 **合法使用** 本软件仅用于学习和技术研究目的。使用者应遵守所在国家或地区的法律法规，仅下载和获取拥有合法权限的流媒体内容。任何非法或侵权使用行为均与原作者无关，使用者需自行承担全部法律责任。 --- ## 赞助 [](https://www.buymeacoffee.com/nilaoda)