下载最新版本请查看Actions

---

ENGLISH README

XstreamDL-CLI

基于python 3.7.4的，命令行版本的，HLS/DASH流下载器，仅支持HLS标准AES-128-CBC解密

使用

首先将ffmpeg和mp4decrypt的可执行文件放置在binaries文件夹中

可执行文件下载链接点此

安装必要的库

pip install -r requirements.txt

使用样式示例

python -m XstreamDL_CLI.cli [OPTION]... URL/FILE/FOLDER...

简单示例

python -m XstreamDL_CLI.cli --b64key oKi/hwKVuLveo/hISX1PQw== --hexiv b3d5ca56926d49d8e96b70aa5c7b358e --name 第一节总论 https://hls.videocc.net/d06ae002cb/2/d06ae002cb4a0bed78fb912c874fdbb2_2.m3u8

一些概念

README中存在一些对于新人不友好的术语或者我使用的名词，这里写一点说明，希望有帮助

元数据

通常情况下，直接访问m3u8/mpd链接可以看到含有完整或部分分段链接的文本内容，这些内容被称为元数据

通过元数据和m3u8/mpd链接，软件可以转换出全部分段链接，最终用于下载

也就是说软件所需要的链接是存放元数据的链接

分段链接

怎么会有人不知道什么是分段链接？根据我收到的反馈，真的有...

所谓分段链接就是媒体文件的链接，如果你下载某个链接，然后使用文本编辑器打开，例如记事本

发现显示在你眼前的是一些看不懂的乱码，恭喜你，你下载的是分段链接

初始分段链接/init分段

怎么知道一个分段链接是不是初始分段链接？

通常情况下，在加载元数据链接之后紧接着加载的分段链接，就是初始分段链接

当然上面的说法不是百分百正确，另一个判断方法是检查链接中?之前（如果有?的话）的末尾部分，是不是诸如map.xxx以及init.xxx的字符

如果是，那么这就是一个初始分段链接

更加准确的判断方法？

当然有，你下载这个分段链接后，使用mediainfo这一类工具查看其属性，如果有时间、码率等信息，并且这个文件只有几KB大小

那么这就是一个初始分段链接

如何反馈

首先，请在使用软件前仔细阅读此README的详细说明，本软件在使用上存在一定门槛

当你确实遭遇到无法下载的链接，请先检查下面的问题

• 输入链接是不是不被软件支持？
  • 案例一，有用户想下载dash流中的字幕，但传入的链接是init分段的链接。软件需要的是mpd链接而不是分段链接
  • 案例二，用户希望下载m3u8直播流，但下载失败。阅读下面的详细说明的直播录制后你就会知道目前还没有实现m3u8直播下载
• 是不是和浏览器/抓包结果中链接不一样？
  • 链接一样，请阅读访问受限
  • raw.json中的链接是正确链接的一部分，请阅读链接鉴权
  • raw.json中的链接后半部分是正确链接的一部分，请阅读未成功下载任何文件
  • raw.json中的链接前半部分是正确链接的一部分，但后半部分和正确链接八竿子打不着，请提issue
• 是不是没有使用代理？
  • 案例一，用户开启了全局代理，但无法下载视频。注意软件目前仅支持http代理，并且默认不走系统代理

为了方便理解彼此的意图，反馈时请尽可能提供下面的信息

• 目标链接
• 你所使用的完整命令
• 正确的初始分段链接，除初始分段外的任意一个分段链接
• 是否存在ip访问限制，如果存在这种可能性，请务必说明可以访问该链接的的地区
• 是否存在时效性限制，特别是直播流
• 对于存在鉴权、时效性较短的链接，请提供m3u8/mpd(元数据)文件
  • 你可以通过抓包/浏览器F12查看响应得到内容，然后复制保存到本地
• 目标链接对应的在线网页地址

如果不想暴露目标链接/网站，请发送信息到我的邮箱

详细说明

下载默认/指定流

当前软件提供了--select选项用于辅助用户选择需要下载的流

但更多的用户希望可以通过指定分辨率、最佳质量一类选项进行下载

如果希望指定下载最佳质量/特定类型/特定分辨率流，请使用下面的选项

--resolution
--best-quality
--video-only
--audio-only
--all-videos
--all-audios
--all-subtitles

未成功下载任何文件

对于这种情况，请检查浏览器中的分段链接是否与raw.json文件中的一致

不一致，请上报详细信息给我

下载加速

如果要下载的目标文件所在的服务器与下载器直接的连接性较差，比如在你使用代理的时候，你可以选择

• 增大--limit-per-host数值，以提升下载速度
• 开启--disable-force-close选项，提升下载速度

如果连接性较好，则保持默认就好，当然--disable-force-close也是推荐开启的

Q: 为什么--disable-force-close选项不是默认开启

A: 之前在编写软件过程中，出现过bug，某个循环异常，开启该选项后导致在极短时间内网络连接数耗尽，然后网络瘫痪，所以默认强制关闭链接，以确保不会发生这种情况

直播录制

目前仅支持dash流的录制，可以通过--live选项指明这是直播流

通过--live-duration指明要录制的时长，该选项不是特别准确，最终文件时长通常大于期望的时长

如果是回放类型的dash流，可以尝试普通模式下载

代理

目前--proxy选项支持设定socks5和http代理，示例

• socks5://127.0.0.1:10808
• http://127.0.0.1:10809

m3u8解密

下载器会自动尝试下载key，但目前绝大部分网站是不提供可直接用于解密的key的

所以需要手动指定解密所使用的key和iv

• --b64key base64编码的解密key字符串
• --hexiv 16进制形式的解密iv字符串，如果不设置则默认是二进制0

dash流解密

下载器调用mp4decrypt解密，请通过--key设置解密key，不设置则会强制二进制合并

访问受限

某些网站需要携带cookies、referer或者特定的请求头才能访问分段文件，这种情况可以通过设置--headers实现正常下载

链接鉴权

某些网站会在常规的链接后面增加一系列参数，用于检查用户是否有权限访问，通常情况下和流本身无关，往往是相同的内容，常见于dash类型流

遇到这种情况，可以使用--url-patch设置这部分内容，例如mpd域名是nammaflix-streams.streamready.in

仅解析

--parse-only表明仅仅解析流，而不会进行任何下载，使用该选项，只会产生raw.json文件

重复流

如果经常使用本下载器下载dash流，可能会发现有的网站两条流名字完全一样，实际上查看mpd内容，确实如此

--index-to-name正是为了处理这一问题而设置的

此外可以与--show-init搭配使用，将会显示对应的初始分段链接，辅助选择需要下载的流

日志

目前下载器添加了详细的日志记录，用于辅助程序异常定位，输出日志在logs文件夹中

--log-level选项用于指定要显示输出的日志级别，无论如何设置，完整的日志总是会记录到logs文件夹

GUI支持

已有基于PySide6的GUI计划

C#版写起来非常不顺手，搁置了

混流支持

已在计划中，将使用mp4box进行混流

下载重试

下载器重试次数为5

如果遇到图中这样的情况，即进度没有达到100%，说明下载并没有完成，请按之前的步骤重复操作，下载器会自动下载未完成的分段

最终成功的进度示意

HELP INFO

version 1.4.3, A downloader that download the HLS/DASH stream.
usage: XstreamDL-CLI [OPTION]... URL/FILE/FOLDER...

A downloader that download the HLS/DASH stream

positional arguments:
  URI                   URL/FILE/FOLDER string

optional arguments:
  -v, --version         print version and exit
  -h, --help            print help message and exit
  --speed-up            speed up at end
  --speed-up-left SPEED_UP_LEFT
                        speed up when left count less than this value
  --live                live mode
  --compare-with-url    use full url to compare with last segments to get new
                        segments
  --dont-split-discontinuity
                        dont take #EXT-X-DISCONTINUITY tag as a new stream
  --name-from-url       get name from segment url
  --live-duration LIVE_DURATION
                        live record time, format HH:MM:SS, example 00:00:30
                        will record about 30s
  --live-utc-offset LIVE_UTC_OFFSET
                        the value is used to correct utc time
  --live-refresh-interval LIVE_REFRESH_INTERVAL
                        live refresh interval
  --name NAME           specific stream base name
  --base-url BASE_URL   set base url for Stream
  --ad-keyword AD_KEYWORD
                        skip #EXT-X-DISCONTINUITY which segment url has this
                        keyword
  --resolution {,270,360,480,540,576,720,1080,2160}
                        auto choose target quality
  --best-quality        auto choose best quality for dash streams
  --video-only          only choose video stream when use --best-quality
  --audio-only          only choose audio stream when use --best-quality
  --all-videos          choose all video stream to download
  --all-audios          choose all audio stream to download
  --all-subtitles       choose all subtitle stream to download
  --service SERVICE     set serviceLocation for BaseURL choose
  --save-dir SAVE_DIR   set save dir for Stream
  --select              show stream to select and download, default is to
                        download all
  --multi-s             use this option when S tag number > 0
  --disable-force-close
                        default make all connections closed securely, but it
                        will make DL speed slower
  --limit-per-host LIMIT_PER_HOST
                        increase the value if your connection to the stream
                        host is poor, suggest >100 for DASH stream
  --headers HEADERS     read headers from headers.json, you can also use
                        custom config
  --url-patch URL_PATCH
                        add some custom strings for all segments link
  --overwrite           overwrite output files
  --raw-concat          concat content as raw
  --disable-auto-concat
                        disable auto-concat
  --enable-auto-delete  enable auto-delete files after concat success
  --disable-auto-decrypt
                        disable auto-decrypt segments before dump to disk
  --key KEY             <id>:<k>, <id> is either a track ID in decimal or a
                        128-bit KID in hex, <k> is a 128-bit key in hex
  --b64key B64KEY       base64 format aes key, only for HLS standard
                        AES-128-CBC encryption
  --hexiv HEXIV         hex format aes iv
  --proxy PROXY         use socks/http proxy, e.g. socks5://127.0.0.1:10808 or
                        http://127.0.0.1:10809
  --disable-auto-exit   disable auto exit after download end, GUI will use
                        this option
  --parse-only          parse only, not to download
  --show-init           show initialization to help you identify same name
                        stream
  --index-to-name       some dash live have the same name for different
                        stream, use this option to avoid
  --log-level {DEBUG,INFO,WARNING,ERROR}
                        set log level, default is INFO
  --redl-code REDL_CODE
                        re-download set of response status codes , e.g.
                        408,500,502,503,504
  --hide-load-metadata  hide `Load #EXT-X-MEDIA metadata` balabala

pyinstaller打包

pyinstaller -i logo.ico -n XstreamDL-CLI_v1.4.3 -F XstreamDL_CLI\__main__.py

已添加自动构建，可前往Actions页面下载最新dev版本程序

特性

• 基于aiohttp

其他

• 逐步完善中

反馈 & FeedBack

• https://discord.gg/u385PRAUTG

Pay For Feature

...