N_m3u8DL-RE：三条命令完成 m3u8 下载与直播录制
【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE
你手里有一条 m3u8 或 mpd 链接，却不知道下一步敲什么。N_m3u8DL-RE 是跨 Windows / Linux / macOS 的命令行流媒体下载工具，点播下载、直播录制、HLS / DASH / MSS 三种清单全覆盖，一条命令把流存成本地文件。
从下载到跑通：最短验证路径
Release 里的可执行文件解压即用，装好即可运行，无需另装运行时。先敲N_m3u8DL-RE --version，能打印版本号说明文件和你的系统匹配；Arch 系发行版可以直接yay -Syu n-m3u8dl-re-bin装。确认无误后，拿 TestStreams.md 里收录的公开测试流跑最短命令：
N_m3u8DL-RE "http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8" --save-name demo程序会自动选流、多线程抓分片、合并成片，跑完当前目录多出demo成品，临时分片默认自动删除，不用你手动清。
三个高频场景，各一条可复制命令 📺
挑流、直播、批量台站，三个场景各给一条能直接复制的命令。
如何只挑一条 4K HEVC 流
清单里挂着好几档清晰度和多语言音轨，你只想要其中一条时，就靠正则选流。
N_m3u8DL-RE "https://example.com/course.m3u8" --save-name course \ -sv "res=1920*:codecs=hvc1:for=best" -sa "lang=en:for=best"与裸跑的差异：把自动挑流换成-sv/-sa按分辨率、编码、语言精确过滤，还能加bwMin/bwMax卡码率。注意选流挑的是整条流而不是片段，只要中间一段改用--custom-range 05:00-20:00按分片筛选更合适（保留完整分片，端点会略偏差）。
直播录制只改一个参数
目标是持续更新的直播、想录满固定时长自动停时，用这条。
N_m3u8DL-RE "https://example.com/live.m3u8" --save-name live \ --live-real-time-merge --live-record-limit 02:00:00与裸跑的差异：加--live-real-time-merge后录制与合成同步进行，配--live-record-limit 02:00:00录满即停，不写时长就录到 Ctrl+C 手动停。边界提醒：手动设--live-wait-time刷新间隔过短或过密都会拖垮录制质量，回看历史时段另有--live-catchup。
批量录制 m3u 频道列表里的多个台
输入是一整个 channels.m3u 频道文件、要给多台分别落盘时，直接把文件名当输入。
N_m3u8DL-RE channels.m3u -sv "name=^Sports:for=all" --live-record-limit 00:03:00与裸跑的差异：输入从单条链接换成频道列表，for=all让所有匹配^Sports的频道同时录制、各存一份。边界提醒：频道名按正则匹配，一个台都命不中会直接报错退出，跑之前先确认规则能命中。
最常调的几个开关，一张表说清
| 你写什么 | 不写时它怎么跑 | 什么时候才需要碰 |
|---|---|---|
--save-name | 自动生成保存名 | 想固定成品文件名 |
--save-dir | 存到当前工作目录 | 想换输出位置 |
--thread-count | 用本机 CPU 逻辑核数 | 想压低并发时 |
--cookies | 不带 Cookie | 链接需要登录态时（Netscape 格式文件） |
--tmp-dir | 放系统默认临时目录 | 临时目录所在分区快满时 |
--download-retry-count | 单分片失败重试 7 次 | 网络抖动频繁、想更耐折腾 |
--log-file-path | 日志只打到终端 | 排障需要留证据时 |
--check-segments-count默认开启：下载完会核对实际分片数与清单预期是否一致，少了会报出来。--del-after-done默认开启：合并完成后自动删临时分片，中间文件不会越积越多。--live-real-time-merge默认关闭：直播默认录完再合并，想边录边合成才要显式打开。
数据在程序内部怎么走 🎯
一条链接进来后走四步：清单解析（MPD / M3U8 / ISM 统一识别轨道信息）→ 选流（默认自动挑，-sv/-sa可指定）→ 分片多线程并发下载（失败自动重试）→ 合并与混流。想深挖某个环节，按职责找目录就行：
| 想改哪个环节 | 去哪个源码目录 |
|---|---|
| 下载调度：点播、直播录制、实时合并 | src/N_m3u8DL-RE/DownloadManager/ |
| 清单解析：MPD / M3U8 / ISM 提取与轨道信息 | src/N_m3u8DL-RE.Parser/ |
| 合并、混流、清理、日志等通用工具 | src/N_m3u8DL-RE/Util/ |
卡住时先做这几件事
- 老版本 Windows 终端乱码或跑不起来：换 cmder 等第三方终端再试。
- 分片反复失败：多半是网络抖动超时，用
--download-retry-count把默认 7 次调大。 - 临时文件占满磁盘：
--tmp-dir指到空间更大的分区。 - 同一命令时成时败：先
--log-file-path落盘日志，连同--version输出和完整命令，先去仓库已有 issue 里搜，没有相同问题再提新的。
照这个顺序走，九成问题都能自己排掉；真卡住了，把版本、命令、日志三样贴全，别人才帮得上忙。
【免费下载链接】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），仅供参考
