Gamingemulationgame launcheropen sourceretro gamingsteam deck
Boxshelf Puts Your Emulator Library on a 3D Shelf, Then Lets You Open the Case, Take the Disc Out and Read the Manual
It's a free, GPL-licensed beta for Windows and Android with no games inside it. Artwork and manuals download only if you opt in, and it comes with no warranty, an unsigned Windows exe and a Steam Deck build its maker calls experimental.
A folder of ROMs has never had a lid to lift. Boxshelf, a public beta published on GitHub, is built to fix that. Its README calls it “a TV-style launcher for your emulators, Steam games and media apps,” and the pitch for the interesting part is a single line: “you can flip a case, open it, take the disc out, read the manual.”
That feature is called Inspect. On a keyboard it’s the V key, and on a controller you click the right stick. The shelf itself is the home screen: your games sit on a 3D shelf with box art, and a Museum view, entered by holding View or Back on a controller, lets you walk the whole collection. Navigation is the D-pad or left stick, A plays, B goes back, and Y shows details. Hold L3 and R3 together to quit a running game, and Settings can change that combo.
What Boxshelf does not do is supply the games. The README is plain about it: “Boxshelf doesn’t include or download any games, BIOS files or keys: you need the emulators and games you already own.” Setup finds the emulators you’ve installed and asks where your game folders live. It lists consoles from GameCube and Switch to PlayStation, NES and Dreamcast, with each system pointed at the emulator you pick. PC games from Steam and Epic share a PC shelf, and a Custom shelf handles everything else. In other words, it’s a very nice bookshelf for books you have to bring yourself.
The artwork is opt-in too. “Box art and manuals download only if you say yes,” the README says, and it names the places the pictures come from: libretro thumbnails, LaunchBox, GameTDB and the Internet Archive. Say no and the shelf stays plainer.
It runs on Windows 10 and 11 (64-bit) as a portable zip, unzipped into its own folder. It also ships for Android 7 or newer, including the dual-screen AYN Thor. Linux and Steam Deck are labeled “an experimental first build,” and the README lists Steam Deck Gaming Mode as untested, along with features like the Home menu during games that aren’t there yet on Linux. The Windows build isn’t code-signed, so SmartScreen may complain the first time you run it. A free beta doesn’t come with a signing certificate.
The companion source repo fills in how it’s made. The Windows app is Electron, run with Node.js, and the Android app uses Capacitor. The code is under the GNU GPL v3, and the README says that covers the code, not the name or logo, so forks are asked to use a different name and logo. The repo is “a snapshot of each beta,” starting at 1.82.0-beta.4, and it says plainly that “it comes with no warranty.”
A few edges are spelled out. Some features reach outside Boxshelf’s own folder, including emulator settings, and the originals are backed up with a .boxshelf-bak ending. RetroAchievements and SteamGridDB need your own accounts or keys. Wii U disc images need your own keys.txt, and Cemu has no save states. The 3D PC model that the Museum view can show isn’t included.
Putting a manual back in the case is a small thing, and it’s the part of owning a game that digital libraries quietly dropped. The README closes by asking people to try the beta and “please tell us what breaks.”
Case closed, for now.