项目的 README,来自 github.com/sassiestrhihno/boxshelf-beta。合并为一个 markdown 文件:README.md。
⬇ Download the latest release · Source code (GPL-3.0) · Source zip of the latest version
Boxshelf is a TV-style launcher for your emulators, Steam games and media apps. Your games sit on a 3D shelf with real box art: you can flip a case, open it, take the disc out, read the manual, and walk the whole collection in the Museum. One controller runs everything.
This is a public beta for Windows, Android (made for the AYN Thor and its two screens) and, as an experimental first build, Linux / Steam Deck. Thank you for trying it: please tell us what breaks.
Source code: Boxshelf is open source (GPL-3.0). The full source is at github.com/sassiestrhihno/boxshelf-source.
Every build is on the Releases page. Each release lists what changed and what's known to be broken.
| Your device | File |
|---|---|
| Windows 10 / 11 PC | Boxshelf-<version>-windows.zip |
| Android, including the dual-screen AYN Thor (both screens) | Boxshelf-<version>-android-thor.apk |
| Linux / Steam Deck (experimental) | Boxshelf-<version>-linux.AppImage |
Boxshelf doesn't include or download any games, BIOS files or keys: you need the emulators and games you already own.
Want to read or build the code? It's in boxshelf-source.
Documents\Boxshelf. It's portable: it doesn't install
anything, and deleting the folder removes it.You need: Windows 10 or 11 (64-bit).
On the Thor the bottom screen shows the game you're on with its buttons (Settings → Display → Bottom screen turns it off). You need: Android 7 or newer.
~/Applications and make it executable (right-click → Properties →
Permissions, or chmod +x).~/Boxshelf.~/Emulation/roms, ~/retrodeck/roms or on your SD card.Not there yet on Linux: the Home menu and quit combo during a game (quit from the emulator's own menu), the power
menu, and Steam Deck Gaming Mode (untested). On Ubuntu 24.04 you may need to start it with --no-sandbox.
GameCube, Wii, Wii U, Switch, Switch 2, PSP, PS2, PS3, PS4, PS5, Xbox 360 and 3DS; PlayStation, NES, SNES, N64, Game Boy, Game Boy Color, Game Boy Advance, DS, Mega Drive / Genesis, Master System, Game Gear and Dreamcast (through RetroArch or their best standalone emulators); plus Steam and the Stremio and Nuvio media apps. Each system uses the emulator you choose for it in setup (setup and Settings have a button to each emulator's official download page). Which consoles and emulators are available depends on the platform.
PC games: your Steam and Epic Games libraries share the PC shelf. Recomps, PC ports and any other program go on a Custom shelf: add them in Settings → Custom games, and everything installed with Quiver Launcher shows up there by itself.
The easiest layout keeps everything beside Boxshelf (the wizard finds it on its own):
Boxshelf\
Boxshelf.exe
Dolphin\ Cemu\ Eden\ PPSSPP\ PCSX2\ RPCS3\ shadPS4\ Xenia\ Azahar\ (your emulators)
ROMS\Gamecube ROMS\Wii ROMS\Switch ROMS\PS2 ... (your games)
Emulators and games anywhere else work too: choose their folders in setup or Settings.
| Action | Keyboard | Controller |
|---|---|---|
| Browse | ← → | D-pad / left stick |
| Change shelf | ↑ ↓ | LT / RT |
| Play / Open | Enter | A |
| Back | Esc | B |
| Flip the box | F | Y |
| Details | I | X |
| Inspect (open the case, read the manual) | V | Click the right stick |
| Quick menu (theme, sounds, sort, power) | the ☰ button | Start / Menu (☰) |
| Settings | S | View / Back (hold it for the Museum) |
| Quit a game | Hold L3 + R3 (changeable in Settings) |
~.Screenshots or a short video help a lot.
data\ beside
Boxshelf.exe (on Linux in ~/Boxshelf/data). Boxshelf has
no accounts, ads or tracking; it only goes online for art, manuals, achievements and the update check.See KNOWN-ISSUES.md for what's already known, and THIRD-PARTY-NOTICES.md for the open-source parts Boxshelf uses.
Boxshelf is free software under the GNU GPL v3.0. The source code is at boxshelf-source.