Skip to content

0xddy/rplay-downloader

Repository files navigation

RPlay Video Downloader

一个用于下载 rplay.live VOD/回放视频的 Chrome、Edge 浏览器扩展。

无需安装 Node.js、pnpm 或 FFmpeg。下载项目 ZIP、解压,然后在浏览器中选择插件目录即可使用。

RPlay Video Downloader 界面预览

功能

  • 自动检测 RPlay 页面中的视频。
  • 显示可用分辨率和码率,按需选择画质。
  • 下载过程显示进度、速度和预计大小。
  • 支持下载任务排队;刷新或关闭视频页面不会中断正在进行的任务。
  • 优先保存为 MP4;遇到部分兼容性问题时自动尝试保存为 TS。
  • 自动使用视频标题生成文件名,并替换 Windows 不支持的字符。
  • 所有运行代码都随扩展提供,不加载远程 JavaScript。

安装

1. 下载并解压

点击 GitHub 页面右上角的 Code → Download ZIP,下载后将 ZIP 完整解压到一个固定目录。

不要直接在压缩包内打开或加载扩展;以后也不要随意删除这个解压目录。

2. 加载扩展

  1. 打开浏览器扩展管理页:
    • Chrome:chrome://extensions/
    • Edge:edge://extensions/
  2. 开启右上角的“开发者模式”。
  3. 点击“加载已解压的扩展程序”。
  4. 选择刚刚解压的项目根目录,也就是包含 manifest.json 的目录。

应选择项目根目录,不要单独选择 dist 目录。

使用方法

  1. 打开一个 RPlay 视频页面并开始播放。
  2. 等待页面提示扩展已检测到视频。
  3. 点击浏览器工具栏中的扩展图标。
  4. 选择需要的清晰度,然后点击下载。
  5. 下载完成后,浏览器会询问或自动保存文件,具体取决于浏览器的下载设置。

如果扩展图标没有显示,可以在浏览器的扩展菜单中将它固定到工具栏。

更新

  1. 重新下载最新的项目 ZIP。
  2. 解压并替换原来的插件目录。
  3. 打开扩展管理页。
  4. 点击本扩展卡片上的“重新加载”按钮。

支持的浏览器与视频

  • Chrome 116 或更高版本。
  • Edge 116 或更高版本。
  • Chromium 内核的其他浏览器可能可用,但未保证完全兼容。
  • 主要支持 RPlay 的 VOD/回放 HLS 视频。
  • MP4 主要支持 H.264 + AAC 视频。
  • 传统 MPEG-TS 视频可在符合条件时自动回退保存为 .ts

以下内容目前不支持:

  • 无限直播录制。
  • DRM/CDM、SAMPLE-AES 等受保护内容。
  • fMP4/CMAF 或使用 EXT-X-BYTERANGE 的 TS 回退。
  • 需要独立合并音频与视频播放列表的 TS 回退。

常见问题

扩展无法加载

确认选择的是包含 manifest.jsonpopup.htmldist 文件夹的项目根目录。如果缺少 dist 文件夹,请重新下载最新版本并完整解压。

页面没有检测到视频

先开始播放视频,再刷新页面重试。扩展只会在受支持的 RPlay 页面和视频请求中工作。

为什么最终保存为 TS

当视频无法安全地换封装为 MP4,并且播放列表符合 TS 回退条件时,扩展会自动保存为 .ts。可使用 PotPlayer、VLC 等支持 TS 的播放器打开。

关闭页面会中断下载吗

不会。任务开始后由扩展后台继续执行,但关闭浏览器或停用扩展会中断任务。

下载大文件会占满内存吗

扩展会将输出持续写入浏览器的临时文件存储,不会把整个视频一次性保存在 JavaScript 内存中。极长视频或异常巨大的单个分片仍可能需要更多系统资源。

如何卸载

在浏览器扩展管理页点击“移除”。确认不再需要后,可以删除之前解压的插件目录。

隐私

  • 扩展不会加载远程脚本、远程模块或远程字体。
  • 联网请求仅用于获取 RPlay 的视频清单、媒体分片和必要的 AES-128 密钥。
  • 视频地址和密钥信息不会发送到第三方统计或分析服务。
  • 下载文件由浏览器保存到用户选择的本地位置。

开发者说明

普通用户不需要执行本节命令。只有修改源码时才需要 Node.js 20+ 和 pnpm 11+。

pnpm install
pnpm check

pnpm check 会依次执行静态检查、单元测试和生产构建。修改源码后必须重新执行 pnpm build,因为浏览器实际运行的是已经提交到 dist/ 的四个 bundle。

免责声明

本扩展仅供学习交流使用。下载内容前请确保你拥有相应权利,并遵守服务条款及当地法律。

About

Video downloader for rplay.live with automatic stream detection and quality selection

Topics

Resources

Stars

22 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages