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 и медиаприложений. Игры стоят на трёхмерной полке с настоящими обложками, а всем управляет один контроллер.
Это сам эмулятор или только фронтенд?Только фронтенд. Он запускает эмуляторы и игры, которые у вас уже есть, и не включает и не скачивает никакие игры, файлы BIOS или ключи.
Как его запустить?В Windows распакуйте скачанный архив в отдельную папку и запустите Boxshelf.exe. На Android откройте APK и разрешите установку. В Linux сделайте AppImage исполняемым и запустите его. Затем мастер настройки найдёт ваши эмуляторы и игры.
Что нужно заранее?Windows 10 или 11 (64-бит) либо Android 7 или новее, а также эмуляторы и игры, которые у вас уже есть. В Linux настройка может найти эмуляторы, установленные как программы, Flatpak или AppImage.
Есть ли подводные камни, о которых стоит знать?Бета-версия не имеет цифровой подписи кода, поэтому Windows выдаёт предупреждение при первом запуске: нужно нажать «Подробнее», а затем «Всё равно выполнить». В Linux нет меню Home, комбинации клавиш для выхода во время игры и меню питания, а режим Gaming Mode на Steam Deck не проверялся.
На каких платформах он работает?Windows 10 и 11 в виде портативного zip-архива, Android в виде APK (сделан для AYN Thor) и Linux / Steam Deck в виде экспериментального AppImage.
Отправляет ли он мои данные куда-нибудь?Ваши настройки и история игр остаются на вашем устройстве. Здесь нет аккаунтов, рекламы и отслеживания, а выход в интернет нужен только для обложек, мануалов, достижений и проверки обновлений.
Это бесплатно?Да. Это свободное ПО по лицензии GNU GPL v3.0, а исходный код есть на GitHub.
Что именно трёхмерная полка позволяет делать с игрой?Можно перевернуть коробку, открыть её, достать диск, прочитать мануал и пройтись по всей коллекции в Museum.
Может ли он показывать игры из Steam, Epic и других лаунчеров?Да. Библиотеки Steam и Epic выводятся на общей полке ПК, а всё, что установлено через Quiver Launcher, автоматически появляется на полке Custom.
Есть ли польза от нижнего экрана AYN Thor?На нём показывается текущая игра и её кнопки. Чтобы отключить это, откройте Settings → Display → Bottom screen.
Откуда берутся обложки игр?Только если вы сами это включите, обложки и мануалы загружаются с libretro thumbnails, LaunchBox, GameTDB, Super Mario Wiki, Internet Archive и других сайтов.
Какие есть похожие проекты?pokemon-fulldex, SuperMarioAllStars, Playnite, lutris, omakade, exodium, LostOdysseyRecomp, LanternEngine
Автор
sassiestrhihno
Размер
<0.1 MB
Звёзды
955
Обновлён
КоммитNov 14
Возраст
13 д
Коммиты · 90 дней