BoxPlayer: A unified desktop console for cloud storage, media libraries, and document AI

Aggregating cloud storage into one interface

BoxPlayer starts with file management across multiple cloud storage providers. The README lists support for Aliyun Cloud Drive, Baidu Cloud, 123 Pan, 115, Quark, PikPak, OneDrive, Dropbox, Box, China Mobile Cloud (139), and China Telecom Cloud (189). Each provider has a different set of supported operations, tracked in a compatibility matrix in the README showing which services support browse, search, download/playback, upload, file operations, and sharing.

The core file management features are uniform across providers: folder navigation with tree view, recycle bin, favorites, albums, global search, quick drag-and-drop, and batch selection. You can upload, download, create files and folders, rename, copy, move, delete, and share files. The README notes that operations are adapted to each provider's capabilities; unsupported operations do not fall back to another service. This means Baidu Cloud users cannot use certain features that Aliyun users can, based on what Baidu's API exposes. For example, the compatibility table shows that PikPak, OneDrive, Dropbox, Box, and others have only partial support for uploading and file operations.

The sidebar shows all logged-in accounts with multi-account login, and file operations like drag-and-drop and batch selection work across the unified view. Sorting options include name, date, size, and quantity, supporting large directories and massive file collections. The README emphasizes that the app respects each provider's ability boundaries, preventing silent errors or fallback to unintended services.

Building media libraries from cloud and local sources

BoxPlayer scans cloud storage folders, local directories, and third-party media sources (Jellyfin, Emby, Plex, WebDAV, AList) to build a searchable media library. It fetches metadata from TMDB and Douban to populate posters, release years, ratings, descriptions, and episode information.

The media library includes movies, TV series, anime, and documentaries. You can organize content by following standard naming conventions, move files between folders, split directories, and fill missing episodes. The README states that subtitle loading, playlist creation, and multi-cloud media scanning all use the corresponding cloud API, not a unified abstraction.

Media server support includes Emby, Jellyfin, and Plex. You can continue watching from where you left off, view the next episode, see recently added items, and browse media server collections. Custom server icons, multi-connection switching, and playback quality policies are configurable.

Video, music, and e-book playback

BoxPlayer includes a built-in web-based video player supporting HLS, DASH, and direct links. You can also embed MPV or use external players like IINA on macOS. Features include multi-track audio selection, external and dual subtitles, ASS/SSA subtitle formats with style support, subtitle offset adjustment, simplified-to-traditional Chinese conversion, online subtitle search from multiple sources, and auto-skip opening and closing credits. You can press and hold to change playback speed, auto-play next episodes, and jump to specific timestamps in your watch history.

The music library scans cloud storage for audio files and organizes them by track, artist, album, folder, and collection. The player includes a particle stage visualization, real-time spectrum analyzer, cover art dominant color extraction for theming, and 10-band EQ. Desktop floating lyrics windows are supported with per-line and per-character highlighting. Reverb, stereo imaging, and tempo adjustment without pitch change are available. Locally cached music, podcast auto-detect, and theme and visual preset import/export support different listening preferences.

The e-book reader scans cloud and local storage for EPUB, PDF, TXT, MOBI, AZW3, DOCX, and Markdown files. You can arrange books by collection, recent reads, and reading status. The reader supports single-page, double-page, and scroll modes with highlighted text, notes, bookmarks, and image previews. You can export notes, highlights, and bookmarks. An AI reading assistant can summarize, answer questions, and translate the current document by referencing the extracted content, with answers showing citation snippets you can click to navigate back to the PDF.

AI document analysis and search

BoxPlayer includes an AI workbench for natural language search across cloud files, media servers, and public resources. The README mentions support for duplicate detection, space analysis, file classification, move-and-organize operations, and media organization. Write-type operations (delete, move, organize, import) show a confirmation before executing; they do not run silently.

Document AI lets you ask questions about individual PDF, EPUB, TXT, Markdown, or DOCX files while viewing them. You can select multiple documents in the file list and ask cross-document questions like summaries, comparisons, and analyses in a single conversation, up to ten documents at once. The app parses documents locally, chunks and indexes them, and sends only the relevant passages to answer your questions. Image-based PDFs are not OCRed and the app will indicate when text extraction is not possible.

CLI tool and MCP server for automation

BoxPlayer includes clouddrive-cli, a command-line tool for cloud file operations. You can install it from the BoxPlayer settings or independently with npm install -g clouddrive-cli. The README provides these examples:

clouddrive-cli files search --provider aliyun --name "Inception" --json
clouddrive-cli files tree --provider aliyun --file-id root --depth 3
clouddrive-cli organize analyze --provider aliyun --file-id root --summary --json
clouddrive-mcp

The tool can traverse, search, and count files; generate media renaming and organization plans; do dry-run previews; and track operations with undo support. It also serves as an MCP (Model Context Protocol) server for use with Claude Desktop, Cursor, and Windsurf, allowing AI clients to safely call cloud operations with access controls. All write-type operations show a confirmation dialog before executing; operations are not silently applied. This safety design prevents accidental bulk deletes or moves. The CLI includes operation history and undo support, so you can roll back changes if something goes wrong.

Cross-platform desktop and mobile support

BoxPlayer builds for macOS (Apple Silicon and Intel), Windows (with separate ARM64 support), Debian/Ubuntu, generic Linux via AppImage, Arch/Manjaro, and iOS/tvOS through the App Store at https://apps.apple.com/us/app/boxplayer/id6739804060. Desktop builds are available at the GitHub Releases page.

The project is built on Vue 3, Electron, Vite, and TypeScript. Development requires Node.js 22.12.0 or later and pnpm. Local development runs via pnpm dev; tests run with pnpm test. The build process uses pnpm run build and electron-builder.

Pro features and open-source core

BoxPlayer keeps the core client open-source and free. Multi-cloud file management, playback, downloads, e-book reading, music, media server clients, and the CLI remain available without payment. Pro features cover services that incur server costs: built-in AI models, AI search with semantic indexing, media agent operations, high-quota public resource search, AI reading assistance, and document analysis.

You can also bring your own API key (BYOK) to BoxPlayer, configuring OpenAI, DeepSeek, OpenRouter, Ollama, or Vercel AI Gateway to use your own account and quota instead. The app supports long-term preference memory but does not store passwords, tokens, or secrets.

English documentation and interface gaps

The README is written primarily in Chinese. BoxPlayer supports English and Chinese interfaces and defaults to English if the system language is not Chinese, but the project is clearly designed primarily for Chinese users. The extensive support for Chinese cloud storage services (Aliyun, Baidu, 123, 115, Quark, China Mobile Cloud, China Telecom Cloud) outweighs support for Western services like OneDrive and Dropbox, which have partial support for some operations.

The complexity of managing multiple clouds with different APIs, combined with the Chinese-first documentation, means English speakers will need to navigate the UI and ask the community for clarification on less obvious features.

Editorial conclusion

Adopt BoxPlayer if you manage files across multiple cloud storage providers and want a unified playback and organization interface. It's built primarily for Chinese cloud storage services; Western users may find OneDrive, Dropbox, and Box support less complete. Avoid it if you need a lightweight single-cloud file manager or expect full feature parity across all cloud providers. Before deploying, verify that your cloud storage accounts are supported in the compatibility matrix and test media server connectivity.

Frequently asked questions

Official sources

1. gaozhangmin/boxplayer on GitHub
2. License: GPL-3.0
3. Project website
4. README
5. Releases