N_m3u8DL-RE 实战教程：MPD/m3u8/ISM 视频流完整下载与合并

N_m3u8DL-RE 实战教程MPD/m3u8/ISM 视频流完整下载与合并【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-REN_m3u8DL-RE 是一个跨平台流媒体下载器把 MPDDASH、m3u8HLS、ISMMSS在线视频存成本地可播放的完整文件点播和直播都支持。本文带你从安装验证开始跑通六个常用下载命令最后教你排掉高频故障。能力边界先确认再做支持三种协议DASHMPD、HLSm3u8、MSSISM协议之外的搞不定点播、直播都能处理直播支持限时录制、回看、边录边合并加密流可以解AES-128、ChaCha20、CENC 等调用 mp4decrypt、ffmpeg、shaka-packager 完成解密视频、音频、字幕轨可按分辨率、编码、语言、声道等条件正则筛选也可自动选最佳Windows、Linux、macOS 都能跑MIT 协议开源你传进去的是清单或流地址它不解析网页链接也不支持 RTMP 等其它协议N_m3u8DL-RE 安装与验证Windows到项目 Releases 页下载发布包解压后直接运行里面的N_m3u8DL-RE.exe无需安装。注意老版本 Windows 自带终端可能不支持本程序无响应或乱码时换 cmder 运行。Arch Linux 及其衍生版AUR 包yay -Syu n-m3u8dl-re-bin源码构建任意平台需先装 .NET SDK本项目目标框架 net10.0克隆后构建git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet build装完必做验证N_m3u8DL-RE --version能打印出形如N_m3u8DL-RE 0.6.0 20261012的版本号就算装好了。另有两条随时可用N_m3u8DL-RE --help打印全部参数当字典查N_m3u8DL-RE doctor检查 ffmpeg 等工具环境是否就绪。首跑跑通一条公开测试流仓库 TestStreams.md 列了一批公开测试流首跑用一条带视频、音频、字幕的 HLS 流N_m3u8DL-RE https://storage.googleapis.com/shaka-demo-assets/angel-one-hls/hls.m3u8 --save-name first运行时会看到先打印解析出的视频轨、音轨、字幕轨清单然后并发拉分片并显示进度下载完自动用 ffmpeg 合并。怎么算成功当前目录出现first开头的完整视频文件程序默认还会写出一份解析信息的 JSON--write-meta-json默认开启文件能用播放器打开且音画正常解析到合并的链路就通了。六个常用下载场景只下字幕不碰视频需求只要字幕文件给本地片子挂上视频音频一律不要。命令一条带多字幕的公开 DASH 测试流N_m3u8DL-RE https://livesim.dashif.org/dash/vod/testpic_2s/multi_subs.mpd --sub-only --sub-format SRT参数说明--sub-only只挑字幕轨其余轨道全部忽略--sub-format SRT输出 SRT也可以写VTT字幕时间轴修正默认开启。验收到输出目录找到.srt文件打开抽查几行应为序号 / 起止时间 / 文本三行一组再载入播放器确认同步。挑出指定分辨率和音轨需求多码率流里轨道很多只下你想要的那一条。命令BBC 公开 DASH 测试流多语言多 RoleN_m3u8DL-RE https://rdmedia.bbc.co.uk/testcard/vod/manifests/avc-full.mpd -sv rolemain:forbest -sa langja|en:forbest2参数说明-sv按正则筛视频轨rolemain只留主内容轨forbest表示命中的只留最匹配的一条-sa langja|en:forbest2挑日语或英语音轨、留最好的两条|表示或。验收看解析输出选中的视频应是主内容轨音轨至多两条且为 ja、en与预期不符就打开输出文件核对轨道列表。直播录制定时长录满自动停需求直播播了一整天你只想要其中 15 分钟不想守着。命令cmafref 是仓库清单里的公开直播流N_m3u8DL-RE https://cmafref.akamaized.net/cmaf/live-ull/2006350/akambr/out.mpd --live-record-limit 00:15:00 --live-real-time-merge --save-name live_demo参数说明--live-record-limit格式 HH:mm:ss录满即停--live-real-time-merge录制中实时合并文件边录边能播--save-name指定输出名。想录成完整点播文件改用--live-perform-as-vod网络不稳时别开--live-pipe-muxREADME 明确提示管道容易丢数据。验收程序在 15 分钟后自行退出检查产出文件时长是否接近 15 分钟。带密钥解密加密流需求流标着加密你手里有密钥想存成正常能播的视频。命令密钥就在 TestStreams.md 清单里N_m3u8DL-RE https://azclwds01.akamaized.net/4e8f6858-5d05-4e28-83ab-48c7a2b259e1/XVuosg_tab_hd.ism/Manifest --key e5114f87b3e54b9faca331e6e6d646a6:55c5d9f1cedfd018b75623f2565a1d29参数说明--key格式是KID:KEY冒号前的 KID 标识密钥、冒号后是密钥本体多组密钥按顺序再传多个--key密钥相同时也可直接写 KEY。解密默认调 mp4decrypt系统没有就--decryption-engine FFMPEG或SHAKA_PACKAGER换引擎。验收播放器打开文件音画都正常出现绿屏、花屏或音画对不上多半是密钥不对。只下载指定时间段需求完整片子太长只要中间一小段省流量也省时间。命令N_m3u8DL-RE http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8 --custom-range 00:10-00:30参数说明--custom-range只下载范围内的分片支持四种写法时间段MM:SS 或 HH:MM:SS如05:00-20:00、分片序号0-10、-99取前 100 个分片、10-从第 10 个到结尾边界按完整分片保留不做精确裁切。拿不准就N_m3u8DL-RE --morehelp custom-range看官方说明。验收用 ffprobe 或播放器看产出文件时长应约 20 秒而不是完整时长。录 IPTV 频道列表里的频道需求手里有一份 m3u 频道列表想定时录其中某个台。命令N_m3u8DL-RE channels.m3u -sv name^Channel A$:forbest --live-record-limit 00:03:00参数说明直接传频道列表文件-sv name...按频道名正则筛选forall可把多个命中频道一起录、分别保存--live-record-limit 00:03:00限制每个频道录 3 分钟。验收输出目录里出现匹配频道对应的独立录像文件。关键参数分组轨道选择-sv/-sa/-ss选轨-dv/-da/-ds去轨条件都是正则。常用键res分辨率、codecs编码、lang语言、channel声道、bwMin/bwMax码率forFOR决定留几条best默认留一条、best2 留两条、all 全留。懒得筛就--auto-select自动选最佳。解密与合并解密引擎--decryption-engine三选一MP4DECRYPT默认最快、FFMPEG兼容好、SHAKA_PACKAGER最全都是调外部工具工具不在 PATH 时用--decryption-binary-path指全路径。合并默认走 ffmpeg--binary-merge是纯字节拼接、不依赖 ffmpeg适合 fMP4/CMAF--skip-merge完全不合并只留分片-M formatmp4还能把分离的音视频再混流进指定容器。输出控制--save-name定文件名--save-dir定输出目录默认当前目录--sub-format定字幕格式-M formatmkv:muxermkvmerge可换混流工具。容错与网络--thread-count线程数默认 10、--download-retry-count单分片重试次数默认 7、--http-request-timeout请求超时秒数默认 100、-R 15M限速。网络不稳优先动后三个。常见故障速查症状分片反复下载失败任务卡住。最可能原因网络不稳或默认 100 秒超时对慢速分片太短。处理办法重试、超时一起调大再跑N_m3u8DL-RE 你的地址 --download-retry-count 5 --http-request-timeout 300症状合并阶段提示找不到 ffmpeg。最可能原因ffmpeg 没装或不在 PATH。处理办法--ffmpeg-binary-path C:\Tools\ffmpeg.exe指到全路径不想装 ffmpeg 就用--binary-merge或--skip-merge绕开合并。症状解密失败或文件下完打不开。最可能原因密钥只填了 KEY 没带 KID按错密钥解或引擎与内容不匹配。处理办法改成完整KID:KEY并换引擎重试N_m3u8DL-RE 你的地址 --key KID:KEY --decryption-engine FFMPEG症状老版本 Windows 终端无响应或乱码。最可能原因旧系统自带终端不支持本程序。处理办法cmder 里跑同一条命令环境整体体检用N_m3u8DL-RE doctor参数看不懂用N_m3u8DL-RE --morehelp 参数名。批量下载脚本化把前文命令串成流水线存成batch.sh即可直接运行#!/bin/bash URLS( https://storage.googleapis.com/shaka-demo-assets/angel-one-hls/hls.m3u8 https://livesim.dashif.org/dash/vod/testpic_2s/multi_subs.mpd http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8 ) mkdir -p ./videos for url in ${URLS[]}; do N_m3u8DL-RE $url --auto-select --thread-count 8 --save-dir ./videos done每个地址自动选最佳轨道、8 线程下载产出统一落到./videos。换成自己的任务只需替换URLS数组里的条目其余不动。固定常用的选项还可以写进配置文件位置与写法见 README.md 的配置文件一节Linux 下是~/.config/N_m3u8DL-RE/config.conf程序启动时自动读取脚本更干净。交付前检查装完先--version确认不是旧版不少坑新版已修轨道挑不准就先--auto-select跑通再对照--morehelp select-video精调网络差时调小--thread-count、调大--http-request-timeout比反复重跑有效临时分片默认任务结束后自动清理--del-after-done默认开启想留分片做备份就加--skip-merge只下载自己拥有合法权限访问的内容这是 README 写明的使用底线现在打开终端把首跑命令复制过去执行你的第一个流媒体下载任务就开始了。【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考