{"id":13453964,"url":"https://github.com/nilaoda/N_m3u8DL-RE","last_synced_at":"2025-03-24T05:32:40.995Z","repository":{"id":40627467,"uuid":"496221318","full_name":"nilaoda/N_m3u8DL-RE","owner":"nilaoda","description":"Cross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文. ","archived":false,"fork":false,"pushed_at":"2025-03-11T15:46:59.000Z","size":3607,"stargazers_count":5469,"open_issues_count":308,"forks_count":566,"subscribers_count":56,"default_branch":"main","last_synced_at":"2025-03-18T23:33:42.917Z","etag":null,"topics":["dash","ffmpeg","hls","ism","live","m3u8","m3u8-downloader","mpd","recorder"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nilaoda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://nilaoda.github.io/N_m3u8DL-CLI/source/images/alipay.png","https://www.buymeacoffee.com/nilaoda"]}},"created_at":"2022-05-25T12:28:40.000Z","updated_at":"2025-03-18T18:56:32.000Z","dependencies_parsed_at":"2023-02-09T03:30:43.517Z","dependency_job_id":"2304152b-c19b-4f49-b096-786b7a693147","html_url":"https://github.com/nilaoda/N_m3u8DL-RE","commit_stats":{"total_commits":449,"total_committers":11,"mean_commits":40.81818181818182,"dds":"0.026726057906458767","last_synced_commit":"584d3c892b5875b6bdac9172cc8ac16274d61bf0"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilaoda%2FN_m3u8DL-RE","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilaoda%2FN_m3u8DL-RE/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilaoda%2FN_m3u8DL-RE/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nilaoda%2FN_m3u8DL-RE/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nilaoda","download_url":"https://codeload.github.com/nilaoda/N_m3u8DL-RE/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245217185,"owners_count":20579289,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dash","ffmpeg","hls","ism","live","m3u8","m3u8-downloader","mpd","recorder"],"created_at":"2024-07-31T08:00:49.825Z","updated_at":"2025-03-24T05:32:40.986Z","avatar_url":"https://github.com/nilaoda.png","language":"C#","funding_links":["https://nilaoda.github.io/N_m3u8DL-CLI/source/images/alipay.png","https://www.buymeacoffee.com/nilaoda"],"categories":["C# #","C\\#","others","C#","下载"],"sub_categories":["视频与流媒体下载"],"readme":"# N_m3u8DL-RE\n跨平台的DASH/HLS/MSS下载工具。支持点播、直播(DASH/HLS)。\n\n[![img](https://img.shields.io/github/stars/nilaoda/N_m3u8DL-RE?label=%E7%82%B9%E8%B5%9E)](https://github.com/nilaoda/N_m3u8DL-RE)  [![img](https://img.shields.io/github/last-commit/nilaoda/N_m3u8DL-RE?label=%E6%9C%80%E8%BF%91%E6%8F%90%E4%BA%A4)](https://github.com/nilaoda/N_m3u8DL-RE)  [![img](https://img.shields.io/github/release/nilaoda/N_m3u8DL-RE?label=%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC)](https://github.com/nilaoda/N_m3u8DL-RE/releases)  [![img](https://img.shields.io/github/license/nilaoda/N_m3u8DL-RE?label=%E8%AE%B8%E5%8F%AF%E8%AF%81)](https://github.com/nilaoda/N_m3u8DL-RE)   [![img](https://img.shields.io/github/downloads/nilaoda/N_m3u8DL-RE/total?label=%E4%B8%8B%E8%BD%BD%E9%87%8F)](https://github.com/nilaoda/N_m3u8DL-RE/releases)\n\n\n遇到 BUG 请首先确认软件是否为最新版本（如果是 Release 版本，建议到 [Actions](https://github.com/nilaoda/N_m3u8DL-RE/actions) 页面下载最新自动构建版本后查看问题是否已经被修复），如果确认版本最新且问题依旧存在，可以到 [Issues](https://github.com/nilaoda/N_m3u8DL-RE/issues) 中查找是否有人遇到过相关问题，没有的话再进行询问。\n\n\n---\n\n版本较低的Windows系统自带的终端可能不支持本程序，替代方案：在 [cmder](https://github.com/cmderdev/cmder) 中运行。\n\nArch 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)\n\n```bash\n# Arch Linux 及其衍生版安装 N_m3u8DL-RE 发行版 (该源非本人维护)\nyay -Syu n-m3u8dl-re-bin\n\n# Arch Linux 及其衍生版安装 N_m3u8DL-RE 开发版 (该源非本人维护)\nyay -Syu n-m3u8dl-re-git\n```\n---\n\n# 命令行参数\n```\nDescription:\n  N_m3u8DL-RE (Beta version) 20241201\n\nUsage:\n  N_m3u8DL-RE \u003cinput\u003e [options]\n\nArguments:\n  \u003cinput\u003e  链接或文件\n\nOptions:\n  --tmp-dir \u003ctmp-dir\u003e                                     设置临时文件存储目录\n  --save-dir \u003csave-dir\u003e                                   设置输出目录\n  --save-name \u003csave-name\u003e                                 设置保存文件名\n  --base-url \u003cbase-url\u003e                                   设置BaseURL\n  --thread-count \u003cnumber\u003e                                 设置下载线程数 [default: 本机CPU线程数]\n  --download-retry-count \u003cnumber\u003e                         每个分片下载异常时的重试次数 [default: 3]\n  --http-request-timeout \u003cseconds\u003e                        HTTP请求的超时时间(秒) [default: 100]\n  --force-ansi-console                                    强制认定终端为支持ANSI且可交互的终端\n  --no-ansi-color                                         去除ANSI颜色\n  --auto-select                                           自动选择所有类型的最佳轨道 [default: False]\n  --skip-merge                                            跳过合并分片 [default: False]\n  --skip-download                                         跳过下载 [default: False]\n  --check-segments-count                                  检测实际下载的分片数量和预期数量是否匹配 [default: True]\n  --binary-merge                                          二进制合并 [default: False]\n  --use-ffmpeg-concat-demuxer                             使用 ffmpeg 合并时，使用 concat 分离器而非 concat 协议 [default: False]\n  --del-after-done                                        完成后删除临时文件 [default: True]\n  --no-date-info                                          混流时不写入日期信息 [default: False]\n  --no-log                                                关闭日志文件输出 [default: False]\n  --write-meta-json                                       解析后的信息是否输出json文件 [default: True]\n  --append-url-params                                     将输入Url的Params添加至分片, 对某些网站很有用, 例如 kakao.com [default: False]\n  -mt, --concurrent-download                              并发下载已选择的音频、视频和字幕 [default: False]\n  -H, --header \u003cheader\u003e                                   为HTTP请求设置特定的请求头, 例如:\n                                                          -H \"Cookie: mycookie\" -H \"User-Agent: iOS\"\n  --sub-only                                              只选取字幕轨道 [default: False]\n  --sub-format \u003cSRT|VTT\u003e                                  字幕输出类型 [default: SRT]\n  --auto-subtitle-fix                                     自动修正字幕 [default: True]\n  --ffmpeg-binary-path \u003cPATH\u003e                             ffmpeg可执行程序全路径, 例如 C:\\Tools\\ffmpeg.exe\n  --log-level \u003cDEBUG|ERROR|INFO|OFF|WARN\u003e                 设置日志级别 [default: INFO]\n  --ui-language \u003cen-US|zh-CN|zh-TW\u003e                       设置UI语言\n  --urlprocessor-args \u003curlprocessor-args\u003e                 此字符串将直接传递给URL Processor\n  --key \u003ckey\u003e                                             设置解密密钥, 程序调用mp4decrpyt/shaka-packager/ffmpeg进行解密. 格式:\n                                                          --key KID1:KEY1 --key KID2:KEY2\n                                                          对于KEY相同的情况可以直接输入 --key KEY\n  --key-text-file \u003ckey-text-file\u003e                         设置密钥文件,程序将从文件中按KID搜寻KEY以解密.(不建议使用特大文件)\n  --decryption-engine \u003cFFMPEG|MP4DECRYPT|SHAKA_PACKAGER\u003e  设置解密时使用的第三方程序 [default: MP4DECRYPT]\n  --decryption-binary-path \u003cPATH\u003e                         MP4解密所用工具的全路径, 例如 C:\\Tools\\mp4decrypt.exe\n  --mp4-real-time-decryption                              实时解密MP4分片 [default: False]\n  -R, --max-speed \u003cSPEED\u003e                                 设置限速，单位支持 Mbps 或 Kbps，如：15M 100K\n  -M, --mux-after-done \u003cOPTIONS\u003e                          所有工作完成时尝试混流分离的音视频. 输入 \"--morehelp mux-after-done\" 以查看详细信息\n  --custom-hls-method \u003cMETHOD\u003e                            指定HLS加密方式 (AES_128|AES_128_ECB|CENC|CHACHA20|NONE|SAMPLE_AES|SAMPLE_AES_CTR|UNKNOWN)\n  --custom-hls-key \u003cFILE|HEX|BASE64\u003e                      指定HLS解密KEY. 可以是文件, HEX或Base64\n  --custom-hls-iv \u003cFILE|HEX|BASE64\u003e                       指定HLS解密IV. 可以是文件, HEX或Base64\n  --use-system-proxy                                      使用系统默认代理 [default: True]\n  --custom-proxy \u003cURL\u003e                                    设置请求代理, 如 http://127.0.0.1:8888\n  --custom-range \u003cRANGE\u003e                                  仅下载部分分片. 输入 \"--morehelp custom-range\" 以查看详细信息\n  --task-start-at \u003cyyyyMMddHHmmss\u003e                        在此时间之前不会开始执行任务\n  --live-perform-as-vod                                   以点播方式下载直播流 [default: False]\n  --live-real-time-merge                                  录制直播时实时合并 [default: False]\n  --live-keep-segments                                    录制直播并开启实时合并时依然保留分片 [default: True]\n  --live-pipe-mux                                         录制直播并开启实时合并时通过管道+ffmpeg实时混流到TS文件 [default: False]\n  --live-fix-vtt-by-audio                                 通过读取音频文件的起始时间修正VTT字幕 [default: False]\n  --live-record-limit \u003cHH:mm:ss\u003e                          录制直播时的录制时长限制\n  --live-wait-time \u003cSEC\u003e                                  手动设置直播列表刷新间隔\n  --live-take-count \u003cNUM\u003e                                 手动设置录制直播时首次获取分片的数量 [default: 16]\n  --mux-import \u003cOPTIONS\u003e                                  混流时引入外部媒体文件. 输入 \"--morehelp mux-import\" 以查看详细信息\n  -sv, --select-video \u003cOPTIONS\u003e                           通过正则表达式选择符合要求的视频流. 输入 \"--morehelp select-video\" 以查看详细信息\n  -sa, --select-audio \u003cOPTIONS\u003e                           通过正则表达式选择符合要求的音频流. 输入 \"--morehelp select-audio\" 以查看详细信息\n  -ss, --select-subtitle \u003cOPTIONS\u003e                        通过正则表达式选择符合要求的字幕流. 输入 \"--morehelp select-subtitle\" 以查看详细信息\n  -dv, --drop-video \u003cOPTIONS\u003e                             通过正则表达式去除符合要求的视频流.\n  -da, --drop-audio \u003cOPTIONS\u003e                             通过正则表达式去除符合要求的音频流.\n  -ds, --drop-subtitle \u003cOPTIONS\u003e                          通过正则表达式去除符合要求的字幕流.\n  --ad-keyword \u003cREG\u003e                                      设置广告分片的URL关键字(正则表达式)\n  --disable-update-check                                  禁用版本更新检测 [default: False]\n  --allow-hls-multi-ext-map                               允许HLS中的多个#EXT-X-MAP(实验性) [default: False]\n  --morehelp \u003cOPTION\u003e                                     查看某个选项的详细帮助信息\n  --version                                               Show version information\n  -?, -h, --help                                          Show help and usage information\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e点击查看More Help\u003c/summary\u003e \n\n```\nMore Help:\n\n  --mux-after-done\n\n所有工作完成时尝试混流分离的音视频. 你能够以:分隔形式指定如下参数:\n\n* format=FORMAT: 指定混流容器 mkv, mp4\n* muxer=MUXER: 指定混流程序 ffmpeg, mkvmerge (默认: ffmpeg)\n* bin_path=PATH: 指定程序路径 (默认: 自动寻找)\n* skip_sub=BOOL: 是否忽略字幕文件 (默认: false)\n* keep=BOOL: 混流完成是否保留文件 true, false (默认: false)\n\n例如:\n# 混流为mp4容器\n-M format=mp4\n# 使用mkvmerge, 自动寻找程序\n-M format=mkv:muxer=mkvmerge\n# 使用mkvmerge, 自定义程序路径\n-M format=mkv:muxer=mkvmerge:bin_path=\"C\\:\\Program Files\\MKVToolNix\\mkvmerge.exe\"\n```\n```\nMore Help:\n\n  --mux-import\n\n混流时引入外部媒体文件. 你能够以:分隔形式指定如下参数:\n\n* path=PATH: 指定媒体文件路径\n* lang=CODE: 指定媒体文件语言代码 (非必须)\n* name=NAME: 指定媒体文件描述信息 (非必须)\n\n例如:\n# 引入外部字幕\n--mux-import path=zh-Hans.srt:lang=chi:name=\"中文 (简体)\"\n# 引入外部音轨+字幕\n--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)\"\n```\n```\nMore Help:\n\n  --select-video\n\n通过正则表达式选择符合要求的视频流. 你能够以:分隔形式指定如下参数:\n\nid=REGEX:lang=REGEX:name=REGEX:codecs=REGEX:res=REGEX:frame=REGEX\nsegsMin=number:segsMax=number:ch=REGEX:range=REGEX:url=REGEX\nplistDurMin=hms:plistDurMax=hms:for=FOR\n\n* for=FOR: 选择方式. best[number], worst[number], all (默认: best)\n\n例如:\n# 选择最佳视频\n-sv best\n# 选择4K+HEVC视频\n-sv res=\"3840*\":codecs=hvc1:for=best\n# 选择长度大于1小时20分钟30秒的视频\n-sv plistDurMin=\"1h20m30s\":for=best\n```\n```\nMore Help:\n\n  --select-audio\n\n通过正则表达式选择符合要求的音频流. 参考 --select-video\n\n例如:\n# 选择所有音频\n-sa all\n# 选择最佳英语音轨\n-sa lang=en:for=best\n# 选择最佳的2条英语(或日语)音轨\n-sa lang=\"ja|en\":for=best2\n```\n```\nMore Help:\n\n  --select-subtitle\n\n通过正则表达式选择符合要求的字幕流. 参考 --select-video\n\n例如:\n# 选择所有字幕\n-ss all\n# 选择所有带有\"中文\"的字幕\n-ss name=\"中文\":for=all\n```\n```\nMore Help:\n\n  --custom-range\n\n下载点播内容时, 仅下载部分分片.\n\n例如:\n# 下载[0,10]共11个分片\n--custom-range 0-10\n# 下载从序号10开始的后续分片\n--custom-range 10-\n# 下载前100个分片\n--custom-range -99\n# 下载第5分钟到20分钟的内容\n--custom-range 05:00-20:00\n```\n\n\u003c/details\u003e\n\n\n\n\n# 运行截图\n\n## 点播\n\n![RE1](img/RE.gif)\n\n还可以并行下载+自动混流\n\n\n![RE2](img/RE2.gif)\n\n## 直播\n\n录制TS直播源：\n\n[click to show gif](http://pan.iqiyi.com/file/paopao/W0LfmaMRvuA--uCdOpZ1cldM5JCVhMfIm7KFqr4oKCz80jLn0bBb-9PWmeCFZ-qHpAaQydQ1zk-CHYT_UbRLtw.gif)\n\n录制MPD直播源：\n\n[click to show gif](http://pan.iqiyi.com/file/paopao/nmAV5MOh0yIyHhnxdgM_6th_p2nqrFsM4k-o3cUPwUa8Eh8QOU4uyPkLa_BlBrMa3GBnKWSk8rOaUwbsjKN14g.gif)\n\n录制过程中，借助ffmpeg完成对音视频的实时混流\n```\nffmpeg -readrate 1 -i 2022-09-21_19-54-42_V.mp4 -i 2022-09-21_19-54-42_V.chi.m4a -c copy 2022-09-21_19-54-42_V.ts\n```\n在新版本(\u003e=v0.1.5)中，可以尝试开启 `live-pipe-mux` 来代替以上命令\n\n**特别注意：如果网络环境不够稳定，请不要开启 `live-pipe-mux`。管道内数据读取由 ffmpeg 负责，在某些环境下容易丢失直播数据**\n\n在新版本(\u003e=v0.1.8)中，能够通过设置环境变量 `RE_LIVE_PIPE_OPTIONS` 来改变 `live-pipe-mux` 时 ffmpeg 的某些选项： https://github.com/nilaoda/N_m3u8DL-RE/issues/162#issuecomment-1592462532\n\n## 赞助\n\n\u003ca href=\"https://www.buymeacoffee.com/nilaoda\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/default-orange.png\" alt=\"Buy Me A Coffee\" height=\"41\" width=\"174\"\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnilaoda%2FN_m3u8DL-RE","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnilaoda%2FN_m3u8DL-RE","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnilaoda%2FN_m3u8DL-RE/lists"}