Repository navigation
Home
Blank Box brings your physical collection, files on your drives and optional Plex/Jellyfin catalogs into one private library. Keep track of what you own, where it lives, the details you care about and the sources you can use to enjoy it.
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. |
| 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 our 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.
Use the guides included with your installed version for its exact commands. Windows remains experimental. Report feedback without sharing household data or credentials.