Skip to content

gaozhangmin/boxplayer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

小白羊网盘 BoxPlayer


中文 | English

小白羊网盘 BoxPlayer - 多网盘统一管理 + 智能媒体库 + 媒体服务器 + 高速下载.

🌐 官网:xbyvideohub.com

支持多种网盘与媒体源

阿里云盘 百度网盘 123网盘 115网盘 PikPak Dropbox OneDrive Box

Jellyfin Emby Plex WebDAV

MIT License TypeScript VUE macOS Windows Linux Star Downloads

clouddrive-cli

clouddrive-cli 是 BoxPlayer 面向终端和 AI Agent 的自动化入口,支持阿里云盘、OneDrive、Dropbox、Box、百度网盘、115网盘、PikPak 等多种网盘。

主要能力:

  • 列出、递归遍历、搜索网盘文件
  • 生成媒体重命名计划(兼容 Jellyfin / Emby / Plex)
  • 先 dry-run 校验,再执行可追踪、可撤销的批量重命名 / 移动 / 整理
  • 上传计划与 dry-run、网盘目录统计分析
  • 通过 clouddrive-mcp 向支持 MCP 的 AI 客户端(Claude Desktop、Cursor 等)暴露同一套能力

安装(跟随 App):打开 BoxPlayer → 账户设置 → 安装命令行工具

独立安装:

npm install -g clouddrive-cli

典型用法

让 AI 整理网盘媒体文件名(Jellyfin/Emby/Plex 兼容)

"帮我把阿里云盘 /Media 目录里的电影和剧集按 Jellyfin 规范重命名,电视剧用 Shameless.S03E02.mkv,电影用 The.Irishman.1080p.x264.mp4。"

clouddrive-cli files walk --provider aliyun --path <folder-id> --json > files.json
clouddrive-cli media rename-plan --input files.json --style jellyfin --output plan.json
clouddrive-cli files rename-apply plan.json --dry-run --json   # 预览差异
clouddrive-cli files rename-apply plan.json --json              # 确认后执行

让 AI 把混乱目录自动分类到 Movies / TV Shows

"我的网盘根目录堆满了文件,帮我整理成 Movies 和 TV Shows 两个分类目录。"

clouddrive-cli media organize-plan --input files.json --root <root-id> --provider aliyun --json
# AI 按计划依次执行 mkdir → rename → move,所有步骤均先 dry-run 确认

搜索文件

clouddrive-cli files search --name "Inception.mkv" --provider aliyun --json
clouddrive-cli files search --name "report" --provider onedrive --json

查看目录大小与文件分类统计

clouddrive-cli files stats --provider aliyun --path root --json
clouddrive-cli files tree --provider aliyun --path root --depth 3

撤销上一次操作

clouddrive-cli ops list --json
clouddrive-cli ops undo <operation-id> --dry-run --json   # 预览撤销计划
clouddrive-cli ops undo <operation-id> --json             # 执行撤销

详细文档:clouddrive-cli/README.md

AI Agent 集成

Claude Code Skill(让 Claude 知道如何安全调用 CLI):

npx skills add boxplayer/clouddrive-cli -g

MCP Server(供 Claude Desktop、Cursor、Windsurf 等 MCP 客户端使用):

clouddrive-mcp

在 MCP 客户端配置文件中添加:

{
  "mcpServers": {
    "clouddrive": {
      "command": "clouddrive-mcp"
    }
  }
}

功能

🖥️ 媒体服务器

  1. 多服务器支持:支持连接 Emby、Jellyfin、Plex 等主流媒体服务器
  2. 自定义服务器图标:可为每个媒体服务器设置自定义图标,轻松区分多个服务器实例
  3. 首页聚合:继续观看、最近添加、电影、剧集、动漫等内容一览无余
  4. 全库浏览:支持按媒体类型(电影、电视剧、动漫、纪录片等)分类浏览,海报墙与列表视图自由切换
  5. 媒体服务器搜索:支持在媒体服务器内搜索,以及跨服务器聚合搜索
  6. 剧集详情:显示剧集封面、评分、简介、分集列表,支持继续播放进度记录

🌟 多网盘支持

  1. 多平台网盘接入:支持阿里云盘、百度网盘、123网盘、115网盘、PikPak、Dropbox、OneDrive、Box 等主流网盘服务
  2. WebDAV 连接:支持通过 WebDAV 协议连接夸克网盘、天翼云等更多网盘服务
  3. 本地文件夹导入:支持导入本地文件夹并识别刮削 TMDB 元数据
  4. 多账号管理:支持同时登录和管理多个网盘账号

🎬 智能媒体库

  1. TMDB 元数据刮削:自动扫描网盘和本地文件,从 TMDB 获取电影、电视剧等媒体元数据
  2. 媒体库整理:智能分类整理媒体文件,构建完整的个人媒体库
  3. 聚合搜索:跨网盘与本地库的统一搜索,快速定位媒体内容

🎥 强大播放功能

  1. 在线高清播放:支持网盘中各种格式的高清原画视频播放
  2. 多音轨切换:播放器内置多音轨支持,自由选择语言音轨
  3. 外挂字幕:支持加载外挂字幕文件,多字幕轨道切换
  4. 视频流与清晰度切换:支持多视频流切换,可根据网络状况选择不同清晰度
  5. 播放速度调整:支持自定义播放速度
  6. 播放列表管理:支持创建和管理播放列表
  7. 第三方播放器:支持 MPV、IINA 等专业播放器

⚡ 高速下载

  1. Aria2c 下载:集成高速 Aria2c 下载引擎,支持多线程下载
  2. 远程下载:可通过远程 Aria2 功能将文件直接下载到远程 VPS/NAS

📁 文件管理

  1. 文件夹树视图:提供特有的文件夹树,方便快速操作
  2. 智能排序:显示文件夹体积,支持文件夹和文件的混合排序(文件名/体积/时间)
  3. 批量操作:支持批量重命名大量文件和多层嵌套的文件夹
  4. 快速预览:可以快速复制文件,预览视频的雪碧图,并直接删除文件
  5. 海量文件处理:能够管理数万文件夹和数万文件,一次性列出文件夹中的全部文件
  6. 批量传输:支持一次性上传/下载百万级的文件/文件夹

🖥️ 跨平台支持

  1. 全平台兼容:支持 Windows 7-11、macOS、Linux 等操作系统
#

界面

🖥️ 媒体服务器管理

媒体服务器列表 & 服务器卡片视图(支持自定义图标)

🏠 媒体服务器主页

继续观看 & 分类媒体库(图库视图)

🎬 剧集与媒体详情

剧集详情页 & 剧集列表

📺 动漫与分类浏览

动漫库 & 媒体服务器搜索

🔍 媒体库与聚合搜索

聚合搜索 & 本地媒体库列表视图

📂 文件管理界面

文件管理主界面 & 文件夹树视图

👤 多账号登录

多网盘账号管理 & 二维码登录

#

安装

Apple 全家桶

iOS / tvOS / macOS 用户可通过 App Store 安装:

https://apps.apple.com/us/app/boxplayer/id6739804060

安装包说明(release 文件夹)

release 文件夹中包含各平台、各架构的安装包,按文件名中的关键词区分:

Windows

文件名 适用平台 说明
...-win.exe Windows(通用) 自动检测系统架构,推荐大多数用户使用
...-win-x64.exe Windows 64位 x86 适用于 Intel / AMD 64位处理器
...-win-ia32.exe Windows 32位 适用于 32位系统或老旧处理器
...-win-arm64.exe Windows ARM64 适用于 ARM64 处理器(如高通骁龙 X Elite)
...-win-x64.zip Windows 64位 免安装 解压即用,无需安装
...-win-ia32.zip Windows 32位 免安装 解压即用,无需安装
...-win-arm64.zip Windows ARM64 免安装 解压即用,无需安装

安装方式: 双击 .exe 安装包,按提示完成安装。便携版解压 .zip 后直接运行 xbyboxplayer.exe

macOS

文件名 适用平台 说明
...-mac-x64.dmg macOS Intel 适用于搭载 Intel 芯片的 Mac
...-mac-arm64.dmg macOS Apple Silicon 适用于搭载 M1 / M2 / M3 / M4 芯片的 Mac

安装方式: 双击 .dmg 文件,将应用拖拽至 Applications 文件夹即可。Apple Silicon 用户若安装后提示文件损坏,请在终端执行:

sudo xattr -d com.apple.quarantine /Applications/xbyboxplayer.app

Linux

文件名 适用平台 说明
...-linux-amd64.deb Debian / Ubuntu x64 适用于 Debian、Ubuntu 等发行版,64位 Intel/AMD
...-linux-arm64.deb Debian / Ubuntu ARM64 适用于 ARM64 架构的 Debian / Ubuntu
...-linux-armv7l.deb Debian / Ubuntu ARMv7 适用于 32位 ARM 架构的 Debian / Ubuntu
...-linux-x86_64.AppImage Linux 通用 x64 免安装,适用于绝大多数 64位 Linux 发行版
...-linux-arm64.AppImage Linux 通用 ARM64 免安装,适用于 ARM64 架构 Linux 发行版
...-linux-armv7l.AppImage Linux 通用 ARMv7 免安装,适用于 32位 ARM Linux 发行版
...-linux-x64.pacman Arch Linux / Manjaro x64 适用于 Arch Linux 及衍生发行版,64位
...-linux-aarch64.pacman Arch Linux ARM64 适用于 Arch Linux ARM64
...-linux-armv7l.pacman Arch Linux ARMv7 适用于 Arch Linux ARMv7
...-linux-x64.zip / arm64.zip / armv7l.zip Linux 各架构 免安装 解压后直接运行可执行文件

安装方式:

  • .debsudo dpkg -i <文件名>.deb
  • .AppImagechmod +x <文件名>.AppImage && ./<文件名>.AppImage
  • .pacmansudo pacman -U <文件名>.pacman
  • .zip:解压后直接运行目录内的可执行文件

手动升级

下载新版 app.asar 文件后,在应用内进入 设置 - 手动导入,选择并导入 app.asar 文件即可完成升级。


小白羊公众号

#

赞助 APP

如果这个项目对你有帮助,欢迎赞助支持持续维护。

微信赞赏码 支付宝赞赏码

加密货币 USDT/USDC:

0xb0a3f7254e97a8bd398b1ab7f70eb48b0dc68eaf
#

交流社区

Telegram

Telegram-group

鸣谢

本项目基于 https://github.com/liupan1890/aliyunpan 仓库继续开发。

感谢作者 liupan1890 #

免责声明

1.本程序为免费开源项目,旨在分享网盘文件,方便下载以及学习electron,使用时请遵守相关法律法规,请勿滥用;

2.本程序通过调用官方sdk/接口实现,无破坏官方接口行为;

3.本程序仅做302重定向/流量转发,不拦截、存储、篡改任何用户数据;

4.在使用本程序之前,你应了解并承担相应的风险,包括但不限于账号被ban,下载限速等,与本程序无关;

5.如有侵权,请通过邮件与我联系,会及时处理。 #

About

小白羊网盘 - Powered by 阿里云盘。

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors