boxshelf-beta README

项目的 README,来自 github.com/sassiestrhihno/boxshelf-beta。合并为一个 markdown 文件:README.md。

Boxshelf beta

⬇ 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.

Download

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.

Install on Windows

  1. Unzip the download into a folder of its own, for example Documents\Boxshelf. It's portable: it doesn't install anything, and deleting the folder removes it.
  2. Run Boxshelf.exe.
  3. Windows may show "Windows protected your PC": the beta isn't code-signed yet. Click More info, then Run anyway.
  4. The setup wizard opens. Click Find my emulators and games (or I'll pick them myself), tick the consoles you play, then Open Boxshelf.

You need: Windows 10 or 11 (64-bit).

Install on Android (AYN Thor)

  1. Open the .apk on your device. The first time, Android asks to allow installs from your browser or file manager.
  2. Open Boxshelf. Setup finds the emulator apps you have installed and asks for your games folders.
  3. Box art downloads in the background into a Boxshelf Art folder next to your games.

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.

Install on Linux / Steam Deck (experimental)

  1. Put the .AppImage somewhere like ~/Applications and make it executable (right-click → Properties → Permissions, or chmod +x).
  2. Run it (on a Steam Deck, in Desktop Mode). Settings are kept in ~/Boxshelf.
  3. It finds emulators installed as programs, Flatpaks or AppImages (EmuDeck and RetroDECK included) and your games in ~/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.

Supported systems

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.

Controls

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)

Report a problem

  1. In Boxshelf, open Settings → System → Report a problem → Create. It saves a zip on your Desktop with the log, your settings and your PC's graphics details. Passwords, API keys and your RetroAchievements name are removed, and your user folder is replaced with ~.
  2. Open a new issue here, say what happened and what you expected, and attach the zip.

Screenshots or a short video help a lot.

Good to know

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.

boxshelf-beta (sassiestrhihno/boxshelf-beta)

正在搜索数据库…

这是什么?Boxshelf 是一款电视风格的启动器,用来启动你的模拟器、Steam 游戏和媒体应用。游戏摆放在带有真实盒装封面的 3D 书架上,一个手柄即可操作全部内容。
它是模拟器还是只是前端?只是前端。它会启动你已有的模拟器和游戏,但不附带也不下载任何游戏、BIOS 文件或密钥。
我该怎么让它运行起来?在 Windows 上,将下载的压缩包解压到单独的文件夹,然后运行 Boxshelf.exe。在 Android 上,打开 APK 并允许安装。在 Linux 上,为 AppImage 赋予可执行权限后运行它。之后,设置向导会自动找到你的模拟器和游戏。
我事先需要准备什么?Windows 10 或 11(64 位),或 Android 7 及更高版本,另外还需要你已拥有的模拟器和游戏。在 Linux 上,设置向导可以找到以程序、Flatpak 或 AppImage 形式安装的模拟器。
有什么需要注意的地方吗?测试版没有代码签名,所以 Windows 首次运行时会发出警告,你需要点击“更多信息”,然后点击“仍要运行”。在 Linux 上,缺少 Home 菜单、游戏中的退出组合键和电源菜单,Steam Deck Gaming Mode 尚未测试。
它能在哪些平台上运行?Windows 10 和 11(便携版 zip 压缩包)、Android(APK,为 AYN Thor 制作),以及 Linux / Steam Deck(实验性 AppImage)。
它会把我的数据发送到别处吗?你的设置和游玩记录只保存在你的设备上。它没有账户、广告或追踪功能,仅在获取封面图、手册、成就以及检查更新时才会联网。
我可以免费使用吗?可以。它是基于 GNU GPL v3.0 的免费软件,源代码在 GitHub 上。
在 3D 书架上,我能对游戏做什么?你可以翻转游戏盒、打开盒子、取出光盘、阅读说明书,还能在博物馆中浏览整个收藏。
它能显示 Steam、Epic 和其他启动器里的游戏吗?可以。Steam 和 Epic 的游戏库会共用 PC 书架,使用 Quiver Launcher 安装的游戏会自动显示在自定义书架上。
AYN Thor 的底部屏幕有什么实际用处吗?它会显示你正在玩的游戏及其按键。如果不需要,可以在 设置 → 显示 → 底部屏幕 中将其关闭。
游戏封面图从哪里来?只有在你选择开启时,盒装封面和手册才会从 libretro thumbnails、LaunchBox、GameTDB、Super Mario Wiki 和 Internet Archive 等来源下载。
大小
<0.1 MB
星标
955
更新
提交Nov 14
时长
13天
提交 · 90 天