Repository navigation
Home
We built Blank Box to keep physical media, local files and Plex/Jellyfin sources in one library. Record your copies and their locations, save the details you care about and choose a source when you want to play something.
Your library runs on your computer. You can catalog and organize it offline without a Blank Box online account or subscription. Connected media servers and offline reference databases are optional.
| Guide | What it covers |
|---|---|
| Getting started | Downloading, ZIP or Docker installation, first sign-in and choosing a starting point. |
| Using your library | Physical copies, linked files, connected servers, details, artwork and playback. |
| Wishlist and Preorders | Planning purchases, tracking paid orders, receiving partial deliveries and keeping order history. |
| Connected libraries | Clear Plex/Jellyfin matches, uncertain proposals, retained details and source/edition counts. |
| Organizing collections | Custom groups, physical box sets, rule-based shelves and activity. |
| Offline metapacks | Optional reference databases, reviewed matches and independent updates. |
| Home-network access | This-computer access, server IP addresses, optional friendly names and troubleshooting. |
| Backup and recovery | What backups protect, separate source-drive originals and restoring a library. |
| Docker and Portainer | Installing the official image and managing it with Portainer. |
| Switch to the official Docker image | A short path from a locally built image using your existing library. |
| Updating Blank Box | Updating an existing Linux/Docker installation and keeping rollback material. |
| Accounts and sign-in | Local passwords, recovery keys and optional OIDC for the shared household account. |
| Feedback and issues | Getting help, reporting a problem and sharing an idea or experience. |
Use the README's ZIP installation or Docker quick start. Native Linux uses the full installation ZIP. Docker on Linux Intel/AMD uses a small signed setup ZIP and pulls the public image; there is no local application build. The Docker guide also includes a Compose URL for new libraries and Docker managers. Windows x64 retains its separate older download and remains experimental. The application includes the prebuilt interface; source downloads are for developers.
The guides inside each package describe its exact commands. This wiki explains the workflows around them. Download packages
Our original code is source available for personal, noncommercial use under the license. Third-party components retain their own licenses.
Preorders tracks paid purchases awaiting delivery; Wishlist holds titles you plan to buy. You can receive partial orders and keep their history. Watch and Listen have simpler source choices, and clear Plex/Jellyfin duplicates can merge in existing libraries. Wishlist and Preorders · Connected libraries · Join us on Discord
Use the guides included with your installed version for its exact commands. Windows remains experimental. Report feedback without sharing household data or credentials.