# 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:

  --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

使用变量设置输出文件命名模板. 支持的变量:

* <SaveName>: 用户指定的保存名称 (--save-name)
* : 流的任务ID
* <Codecs>: 编解码器信息 (例如: avc1.64001f, mp4a.40.2)
* <Language>: 语言代码 (例如: en, zh-CN)
* <Resolution>: 视频分辨率 (例如: 1920x1080)
* : 流的带宽/比特率
* <MediaType>: 媒体类型 (VIDEO, AUDIO, SUBTITLES)
* <Channels>: 音频声道配置
* <FrameRate>: 帧率
* <VideoRange>: 视频色域/HDR信息 (SDR, HDR10等)
* <GroupId>: 流组标识符

使用场景:
当下载多个相同类型的流时(例如多个不同分辨率的视频)，使用此选项可以避免文件名冲突。

例如:
# 下载1080p和720p视频，文件名包含分辨率
--save-pattern "<SaveName>_<Resolution>" --save-name "video"
# 输出: video_1920x1080.mp4, video_1280x720.mp4

# 包含带宽信息
--save-pattern "<SaveName>_<Resolution>_kbps"
# 输出: video_1920x1080_5000000kbps.mp4

# 下载多个音频流，包含语言和声道
--save-pattern "<SaveName>_<Language>_<Channels>ch"
# 输出: audio_en_2ch.m4a, audio_es_2ch.m4a, audio_en_6ch.m4a

# 复杂模板
--save-pattern "<MediaType>_<Resolution>_<Codecs>_<Language>"
# 输出: VIDEO_1920x1080_avc1.64001f_en.mp4

注意:
如果不使用 --save-pattern，程序会在文件名冲突时自动使用流的元数据(分辨率、带宽等)
生成唯一的文件名，而不是简单地添加 ".copy" 后缀。