BoxPlayer
跨手机、平板、电视与电脑的全平台播放器：把网盘、媒体服务器、音乐、阅读与 AI 放进同一个入口。
中文 · English · 官网及全平台下载 · 桌面版 Releases · CLI / MCP
BoxPlayer 是面向个人媒体资产的全平台播放器，支持 Apple 全家桶（iPhone、iPad、Mac、Apple TV）、Windows、Linux、Android 手机与平板，以及 Android TV。它把多个云盘、本地文件和 Jellyfin / Emby / Plex 内容放在统一入口中，支持文件管理、媒体刮削与播放、音乐库、电子书阅读及 AI 辅助操作。本仓库主要维护 Electron 桌面版；各平台客户端的界面、功能与发布节奏可能不同。
第一次使用？前往 安装，添加云盘或媒体服务器，然后在媒体库扫描内容。版本变更与已知限制见 v5.0.36 更新说明。
界面预览
统一媒体库
主屏幕汇集继续观看、收藏夹和媒体分类；详情页展示背景图、季集、演职员与播放进度。
音乐库与粒子播放器
按歌曲、歌手、专辑和自建歌单浏览；从音乐库播放后可进入粒子播放器，也能返回列表继续管理曲目。
文件、搜索与 AI
云盘文件管理与跨来源搜索共用一个工作区。AI 功能可辅助寻找媒体、整理文件和阅读文档。
能做什么
| 场景 | 主要能力 |
|---|---|
| 文件管理 | 多账号云盘浏览、搜索、上传下载、复制移动、分享与回收站；第三方云盘按其 API 能力展示操作。 |
| 影视媒体库 | 扫描云盘和本地目录，补全海报与元数据；统一浏览电影、剧集、季集、演员和分类。 |
| 媒体服务器 | 连接 Jellyfin、Emby、Plex，浏览媒体库、继续观看、搜索并播放。 |
| 视频播放 | 内置播放器与 MPV / IINA 外部播放；支持音轨、字幕、ASS/SSA、倍速、连续播放和进度恢复。 |
| 音乐 | 歌曲、歌手、专辑、自建歌单与播放队列；粒子播放器、歌词、音效和桌面歌词。 |
| 阅读 | EPUB、PDF、TXT 等电子书；书签、笔记、高亮与 AI 阅读辅助。 |
| AI 工作台 | 搜索与分析内容、规划文件整理、文档问答；执行写入操作前提供确认。 |
| 自动化 | clouddrive-cli 和 MCP Server，适合终端及 AI Agent 调用云盘能力。 |
云盘与内容来源
- 云盘：阿里云盘 / Alipan、百度网盘、123 网盘、115、夸克、PikPak、OneDrive、Dropbox、Box、中国移动云盘 139、天翼云盘 189、光鸭云盘。
- 媒体与目录：Jellyfin、Emby、Plex、WebDAV、AList、本地文件夹。
- 不同服务的官方能力、账号权限和限速可能不同。App 会尽量只展示当前来源支持的操作。
AI 与 Pro
核心的文件管理、媒体播放、音乐、阅读和 CLI 功能可直接使用。Pro 主要覆盖需要持续服务端成本的内置 AI、资源搜索额度与优先支持。也可以配置自己的 OpenAI 兼容服务或本地模型；第三方 API 费用由对应服务商收取。
命令行与 MCP
clouddrive-cli 提供文件遍历、搜索、媒体整理计划、dry-run 预览、操作记录等能力，并能作为 MCP Server 供 AI 客户端使用。详见 独立文档。
安装
官网：xbyvideohub.com，在「全部下载」中选择设备对应的版本：
| 设备 | 下载入口 |
|---|---|
| iPhone、iPad、Mac、Apple TV | BoxPlayer App Store |
| Android 手机、平板、Android TV | 官网 Android APK 下载 |
| macOS、Windows、Linux 桌面版 | 官网下载安装包 · GitHub Releases |
请以下载页面实际列出的文件和架构为准；GitHub 草稿 Release 尚不能作为公开下载版本。Apple 平台 App Store 版与本仓库的 Electron 桌面版是不同客户端。
macOS 如遇系统安全提示，请先确认下载来源，再通过系统设置允许打开；不要对来源不明的安装包解除隔离。
开发
要求 Node.js >= 22.12.0，使用 pnpm 管理依赖。
pnpm install pnpm dev
检查与构建：
CI=true pnpm exec vue-tsc --noEmit pnpm run test pnpm run test:clouddrive-cli pnpm run build
pnpm run build 会先通过 version.mjs 自动递增 patch 版本，再进行类型检查和打包；只需检查类型时请运行上面的 vue-tsc 命令。平台打包命令见 package.json。
私有 client ID、secret 和 API key 放在忽略提交的 .env.local 中，运行 pnpm run secrets:generate 生成 src/secrets.generated.ts。不要提交真实凭据。
electron/ 主进程、窗口与系统集成
src/ Vue 界面、云盘与媒体功能
shared/ 主进程与渲染端共享代码
clouddrive-cli/ CLI 与 MCP Server
scripts/ 构建、密钥与发布脚本
screenshot/ README 使用的当前界面截图
社区与声明
- 问题与建议：GitHub Issues
- 官网：xbyvideohub.com
- Telegram：BoxPlayer 社区
- 本项目基于 liupan1890/aliyunpan 继续开发，感谢原作者及贡献者。
请遵守所在地区法律法规、各云盘及媒体服务的条款，并确认自己有权访问和使用相关内容。第三方服务产生的额度消耗、费用与账号风险由使用者自行承担。