N_m3u8DL-CLI README

The project's README from github.com/nilaoda/N_m3u8DL-CLI. As one markdown file: README.md.


███╗   ██╗        ███╗   ███╗██████╗ ██╗   ██╗ █████╗ ██████╗ ██╗       ██████╗██╗     ██╗
████╗  ██║        ████╗ ████║╚════██╗██║   ██║██╔══██╗██╔══██╗██║      ██╔════╝██║     ██║
██╔██╗ ██║        ██╔████╔██║ █████╔╝██║   ██║╚█████╔╝██║  ██║██║█████╗██║     ██║     ██║
██║╚██╗██║        ██║╚██╔╝██║ ╚═══██╗██║   ██║██╔══██╗██║  ██║██║╚════╝██║     ██║     ██║
██║ ╚████║███████╗██║ ╚═╝ ██║██████╔╝╚██████╔╝╚█████╔╝██████╔╝███████╗ ╚██████╗███████╗██║
╚═╝  ╚═══╝╚══════╝╚═╝     ╚═╝╚═════╝  ╚═════╝  ╚════╝ ╚═════╝ ╚══════╝  ╚═════╝╚══════╝╚═╝

img img img img img

ENGLISH VERSION

下载使用

关于开源

本项目已于2019年10月9日开源，采用MIT许可证，各取所需。

关于跨平台

N_m3u8DL-CLI

一个简单易用的m3u8下载器，下载地址：https://github.com/nilaoda/N_m3u8DL-CLI/releases

支持下载m3u8链接或文件为mp4或ts格式，并提供丰富的命令行选项。

运行截图

命令行选项

N_m3u8DL-CLI

USAGE:

  N_m3u8DL-CLI <URL|JSON|FILE> [OPTIONS]

OPTIONS:

  --workDir                  设定程序工作目录
  --saveName                 设定存储文件名(不包括后缀)
  --baseUrl                  设定Baseurl
  --headers                  设定请求头，格式 key:value 使用|分割不同的key&value
  --maxThreads               (Default: 32) 设定程序的最大线程数
  --minThreads               (Default: 16) 设定程序的最小线程数
  --retryCount               (Default: 15) 设定程序的重试次数
  --timeOut                  (Default: 10) 设定程序网络请求的超时时间(单位为秒)
  --muxSetJson               使用外部json文件定义混流选项
  --useKeyFile               使用外部16字节文件定义AES-128解密KEY
  --useKeyBase64             使用Base64字符串定义AES-128解密KEY
  --useKeyIV                 使用HEX字符串定义AES-128解密IV
  --downloadRange            仅下载视频的一部分分片或长度
  --liveRecDur               直播录制时，达到此长度自动退出软件(HH:MM:SS)
  --stopSpeed                当速度低于此值时，重试(单位为KB/s)
  --maxSpeed                 设置下载速度上限(单位为KB/s)
  --proxyAddress             设置HTTP/SOCKS5代理, 如 http://127.0.0.1:8080
  --enableDelAfterDone       开启下载后删除临时文件夹的功能
  --enableMuxFastStart       开启混流mp4的FastStart特性
  --enableBinaryMerge        开启二进制合并分片
  --enableParseOnly          开启仅解析模式(程序只进行到meta.json)
  --enableAudioOnly          合并时仅封装音频轨道
  --disableDateInfo          关闭混流中的日期写入
  --disableIntegrityCheck    不检测分片数量是否完整
  --noMerge                  禁用自动合并
  --noProxy                  不自动使用系统代理
  --registerUrlProtocol      注册m3u8dl链接协议
  --unregisterUrlProtocol    取消注册m3u8dl链接协议
  --enableChaCha20           enableChaCha20
  --chaCha20KeyBase64        ChaCha20KeyBase64
  --chaCha20NonceBase64      ChaCha20NonceBase64
  --help                     Display this help screen.
  --version                  Display version information.

关于m3u8dl://协议

新增命令行参数：

--registerUrlProtocol          注册m3u8dl链接协议
--unregisterUrlProtocol     取消注册m3u8dl链接协议

URI格式：

m3u8dl://<base64编码的客户端命令行文本>

URI示例：

m3u8dl://Imh0dHBzOi8vZXhhbXBsZS5jb20vYWJjLm0zdTgiIC0td29ya0RpciAiJVVTRVJQUk9GSUxFJVxEb3dubG9hZHNcbTN1OGRsIiAtLXNhdmVOYW1lICJhYmMiIC0tZW5hYmxlRGVsQWZ0ZXJEb25lIC0tZGlzYWJsZURhdGVJbmZvIC0tbm9Qcm94eQ==

URI解码结果：

"https://example.com/abc.m3u8" --workDir "%USERPROFILE%\Downloads\m3u8dl" --saveName "abc" --enableDelAfterDone --disableDateInfo --noProxy

用户文档

https://nilaoda.github.io/N_m3u8DL-CLI/

聊聊

https://discord.gg/SSGwKrjC44

赞赏

Wow

N_m3u8DL-CLI (nilaoda/N_m3u8DL-CLI)

Searching Database…

16.2K ·GitHub
N_m3u8DL-CLI
这是干什么用的?这是一个免费开源的命令行下载工具,用来下载 m3u8/HLS/DASH 视频流,用 C# 基于 .NET Framework 编写。给它一个 m3u8 链接或本地文件,它就能把视频保存成 mp4 或 ts。
它只是命令行工具,还是有图形界面?它是纯命令行工具,但你不用去背参数:SimpleG 是一个小巧的辅助图形界面,可以帮你生成常用的参数;网页也可以通过 m3u8dl:// 协议直接调起它。
怎么把它跑起来?从 GitHub Releases 页面下载一个构建版本(也有自动构建的测试版发布),然后在终端里运行 exe,带上你的 m3u8 链接——所有功能都通过命令行参数来控制。
需要安装 ffmpeg 或其他东西吗?下载本身不需要任何额外的东西。合并分片时可以用简单的二进制拼接,如果你装了 ffmpeg 也可以用它——只有 ffmpeg 合并模式才需要安装 ffmpeg。
有没有它下载不了或解不了密的视频流?有——它明确不支持解密优酷视频和气球云(Balloon Cloud)视频,受这些系统保护的视频流是下载不了的。
在 Mac 或 Linux 上也能用吗?不能——它基于 .NET Framework 构建,只能在 Windows 上运行,而且项目已进入维护模式。对于 Linux 或 macOS,作者推荐使用后继项目 N_m3u8DL-RE,它支持 Win/Linux/Mac。
它能处理加密的视频流吗?能——使用 AES-128-CBC 加密的分片会在下载过程中自动解密,所以你拿到的就是可以直接播放的文件,不需要额外操作。
它能录制直播流吗?可以,直播录制目前是测试版功能。它还支持 Master List(主列表),可以从 m3u8 中只下载选定的时间范围或指定的分片。
下载中断后能续传吗?能——下载支持多线程、断点续传和限速。你还可以设置自定义 HTTP 请求头和指定的 HTTP 代理;默认会自动使用系统代理,除非你把这个功能关掉。
这个项目为什么进入维护模式了?作者推倒重来,开发了 N_m3u8DL-RE,抛弃了老旧的 .NET Framework 底层。那个后继项目可以在 Windows、Linux 和 Mac 上运行,新功能都会加在那里,而这个命令行工具只继续支持 Windows。
What are similar projects?streamfirefly, streambert, res-downloader, livego, cat-catch, yoinks, pytube, you-get
Which topics is it in?resumable, livestream, m3u8, hls, video-downloader, video-streaming, subtitles, downloader, video-processing, dotnet, c#, ffmpeg
Creator
nilaoda
Size
6.2 MB
Stars
16.2K
Updated
CommitJun 03Release3.0.2Jul 11
Age
7y
Commits · 90 Days