Cross-platform · 4K HDR · AI-powered

AI Search · Cloud Drive Manager · 4K PlayerAll in BoxPlayer.

BoxPlayer is a free open-source cloud drive manager, AI search assistant, and 4K HDR media player. The free alternative to Infuse, VidHub, SenPlayer, Kodi, and VLC.

AI Agent searches all your cloud drives and the open web. AI file organizer, reading companion, TTS and translation. Also a 4K HDR player, Plex / Jellyfin / Emby client.

Particle Player

Live particle visuals, spectrum, and word-level lyrics.

BoxPlayer turns scattered files into one usable media system.

Start with the four pillars, then go deeper into video, books, music, AI, and media-server workflows below.

One entry point

Cloud drives, local folders, NAS, WebDAV, and media servers live in one workspace, so you stop jumping between apps.

Three libraries

Video, books, and music become browsable, searchable, resumable libraries instead of plain file lists.

AI workflows

Natural-language search, public resource discovery, reading Q&A, translation, and file organization share one AI Agent.

Every screen

iPhone, iPad, Apple TV, macOS, Windows, and Linux connect to the same sources and playback progress.

Libraries

Video, books, and music become three real libraries.

Each content type gets its own browsing model instead of being trapped in one generic file list.

Video Library

Video media library

Poster wall · TMDB · Cloud streaming

Scan cloud drives, local folders, and WebDAV sources. BoxPlayer recognizes movies, TV, documentaries, and anime, then enriches them with TMDB metadata, ratings, years, and posters.

  • Recently added, continue watching, categories, ratings, years, and playlists
  • Direct playback from Aliyun, Baidu, 115, PikPak, OneDrive, and more
  • Unified search across media servers, local folders, and cloud libraries
BoxPlayer video media library poster wall
BoxPlayer anime media library
Book Library

Book library and AI reader

EPUB · PDF · TTS · Translation

Scan EPUB, PDF, MOBI, AZW3, TXT, and other ebooks. Organize covers, progress, notes, bookmarks, and highlights.

  • Shelf, list, and cover-focused library views
  • AI Q&A, full-book bilingual translation, and selection translation
  • Text-to-speech, reading stats, and bulk annotation export
BoxPlayer book library
BoxPlayer AI reader
Music Player

Music library and particle player

Spectrum · Lyrics · EQ · Desktop lyrics

Scan cloud and local music, then browse by songs, artists, albums, folders, and playlists. The player supports EQ, real-time spectrum, particle visuals, and word-level lyrics.

  • Lyrics and cover fallback from LRCLIB plus NetEase, Kugou, QQ Music, Kuwo, and Migu
  • Mix cloud tracks, local M3U playlists, podcast folders, and local files
  • 12-color theme editor and 15 built-in presets
BoxPlayer music library
Search & Intelligence

Search, AI, and media servers share one desktop entry point.

AI Agent

AI Agent assistant

Natural language · Tool calls · File operations

Search drives, media servers, and public resources in one sentence, then turn storage analysis or file operations into confirmable cards.

  • Natural-language search across local drives, public resources, and media libraries
  • Dedup, storage analysis, categorization, and batch actions with confirmation
  • Non-Pro users can preview the window; Pro or BYOK users can send messages
BoxPlayer AI Agent
Media Server

Media server client

Jellyfin · Emby · Plex

Connect to Jellyfin, Emby, and Plex with native protocols. BoxPlayer reads libraries, posters, summaries, seasons, episodes, and watch progress.

  • Multiple server instances with custom server icons
  • Continue watching, recently added, movies, shows, and collections
  • Playback quality, compatibility mode, audio/video tracks, and subtitles managed in one app
BoxPlayer media server client
BoxPlayer media server library

Connect the places where your files already live.

Cloud drives, media servers, NAS shares, and network protocols stay separate in storage, but feel connected in BoxPlayer.

  • Aliyun Drive logo
    Aliyun Drive
  • Baidu Netdisk logo
    Baidu Netdisk
  • Google Drive logo
    Google Drive
  • Microsoft OneDrive logo
    OneDrive
  • Dropbox logo
    Dropbox
  • Plex media server logo
    Plex
  • Jellyfin media server logo
    Jellyfin
  • Emby media server logo
    Emby
  • SMB network sharing protocol logo
    SMB
  • WebDAV protocol logo
    WebDAV
  • NFS network file system logo
    NFS
  • FTP / SFTP protocol logo
    FTP
Free & open-source

Free and open source forever.

Most cross-platform players either charge, stay closed-source, or skip Linux. BoxPlayer is MIT licensed, has no tracking, no ads, and does not collect viewing data. Your library stays yours, and one codebase can be built, audited, modified, and distributed by anyone.

License
MIT
Platforms
Win · Linux
Cost
$0 forever

Star history

View →
Star History Chart for gaozhangmin/gaozhangmin and gaozhangmin/boxplayer
  • Fully open source

    The Windows and Linux clients are 100% open on GitHub: source code, build scripts, and release binaries are public for auditing, self-hosting, and development.

  • Free forever, no paywall

    No trial limits, no bitrate locks, no reduced audio tracks. HDR, Dolby Vision, UHD discs, and Plex/Jellyfin/Emby connections are all free.

  • MIT-friendly license

    Read it, change it, fork it, and build your own player from it. We want more people to enjoy high-quality playback on every screen.

  • build.sh
    # Linux / Windows
    git clone https://github.com/gaozhangmin/boxplayer.git
    cd boxplayer
    pnpm install
    pnpm run build:linux   # or build:win
Developer · AI Agent · MCP

Let AI drive your cloud drives. Developer tools for power users.

BoxPlayer extracts cloud-drive automation into clouddrive-cli — a command-line tool for developers and a stable API for Claude, Codex, Cursor, or any MCP agent.

  • Unified API for 7 cloud drives

    Aliyun Drive, OneDrive, Dropbox, Box, Baidu Netdisk, 115, and PikPak — one command set, one JSON shape, one permission model.

  • Three-step safety model

    Generate a plan, validate with dry-run, then execute after user confirmation. Every write operation is traceable and undoable with ops undo.

  • AI-native media organization

    Detect movies, TV shows, and anime automatically, then generate Jellyfin / Emby / Plex-friendly names so messy cloud folders become a real media library.

Install the CLI

Install globally from npm in seconds

npm install -g clouddrive-cli

# verify
clouddrive-cli --help
clouddrive-cli auth list --json

Install the Claude Skill

Let Claude / Codex drive the CLI directly

# Method A — npx
npx skills add boxplayer/clouddrive-cli -g

# Method B — copy SKILL.md
cp $(npm root -g)/clouddrive-cli/skill/SKILL.md \
   ~/.claude/skills/clouddrive-cli/SKILL.md
AI Agent in action

Speak naturally. The agent runs commands.

  • You

    Show me which movies are in Aliyun Drive and count them

    Agent runs
    $ auth list --json
    $ files walk --provider aliyun \
    $   --path <Movies> --json > files.json
    $ media scan --input files.json --json
  • You

    Rename the TV shows in Aliyun Drive for Jellyfin

    Agent runs
    $ files walk --provider aliyun \
    $   --path <TV> --json > files.json
    $ media rename-plan --input files.json \
    $   --style jellyfin --output plan.json
    $ files rename-apply plan.json \
    $   --current files.json --dry-run
    $ files rename-apply plan.json \
    $   --current files.json   # confirm
  • You

    Undo the rename operation I just ran

    Agent runs
    $ ops list --json
    $ ops undo <op-id> --dry-run --json
    $ ops undo <op-id>

Native MCP server included

clouddrive-mcp exposes files_walk, media_rename_plan, ops_undo, and 17 tools to any MCP client — Claude Desktop, Cursor, and Codex work with one config block.

Read the docs
Free during preview

Get BoxPlayer on every screen.

Download BoxPlayer for iPhone, iPad, Apple TV, macOS, Windows, and Linux. Android support is coming soon.

App Store requires iOS 16+ / iPadOS 16+ / tvOS 16+ / macOS 13+. Windows 10+ and major Linux distributions are available from GitHub Releases.

FAQ

Frequently asked questions

Answers about BoxPlayer's video player, Plex / Jellyfin / Emby client, cloud-drive streaming, 4K HDR support, and AI Agent media organization.

  • BoxPlayer is free to use. The Apple apps for iOS, iPadOS, Apple TV, and macOS are free on the App Store. The Windows and Linux desktop clients are fully open source on GitHub under the MIT license, with no paywall, bitrate lock, resolution limit, subtitle lock, or audio-track restriction.