PHPackages kjbstar/recalboy - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. kjbstar/recalboy ActiveProject[Framework](/categories/framework) kjbstar/recalboy ================ The 1-click companion for Recalbox. v0.3.0.1(8y ago)711[3 issues](https://github.com/kjbstar/recalboy/issues)MITPHPPHP >=5.6.4 Since Mar 1Pushed 7y ago4 watchersCompare [ Source](https://github.com/kjbstar/recalboy)[ Packagist](https://packagist.org/packages/kjbstar/recalboy)[ RSS](/packages/kjbstar-recalboy/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (6)Dependencies (9)Versions (8)Used By (0) [![](public/assets/img/recalboy.png)](public/assets/img/recalboy.png) Recalboy is your "1-click" companion for [Recalbox](http://www.recalbox.com) and is powered by the micro-framework [Lumen](http://lumen.laravel.com). I made it for a personal project, to provide a [little second screen](public/assets/img/readme/gba_recalboy.png) for an arcade cabinet, to get access to main features of Retroarch in a breeze. - Save - Load last save state - Take a screenshot & upload it in the cloud - Open/Close Retroarch menu - Reset game - Exit game **New in v0.3** ! You can manage backups of your saves files ! [![](public/assets/img/readme/manager.png)](public/assets/img/readme/manager.png) - Say goodbye to corrupted saves, never lose your progress anymore ! - Recalboy automatically backups your latest saves when you exit a game. - Browse and search your backups by system/game/date/hour, and restore them one by one to your Recalbox. - Coming soon : download your backups in 1 zip file. **New in v0.2** ! There's a perfect tool for your arcade cab': **Demo Mode** [![CLICK HERE TO WATCH THE VIDEO](https://camo.githubusercontent.com/11f8c0c05394f98f0030c29b21df9c252c3e348504cef7a70844acb9b37ec553/68747470733a2f2f696d672e796f75747562652e636f6d2f76692f35337a4e7574464643626b2f302e6a7067)](https://www.youtube.com/watch?v=53zNutFFCbk) - Launch randomly a game from the systems of your choice. - Every X minutes, another game is launched. - You want to play to what you see? No problem: just start to play, Demo mode will turn off. - You don't like what you see? Press Hotkey to skip and launch another game. **Demo Mode** is perfect to discover games from your collection, or just to let your Recalbox powered arcade cabinet turned on, to display demos like a true arcade cabinet! --- How to install ? ================ [](#how-to-install-) Recalboy is very simple to install. 1. By using Vagrant (Very Easy Install) 2. By using our Easy Install Wizard. More details [HERE ON THE WIKI](https://github.com/kjbstar/recalboy/wiki). > Note: Recalboy is **not** something you install on Recalbox. --- Demo & screenshots ====================== [](#demo--screenshots) Watch a demo of v0.2.0 on [on Youtube](https://youtu.be/53zNutFFCbk). You can watch a demo of an early version [here](https://youtu.be/k_k3ho4qGwg). Screenshots of release [0.1.2](https://github.com/kjbstar/recalboy/releases/tag/v0.1.2) with "micro" theme, on my 2.8" piTFT screen: ### Default view, waiting for a game [](#default-view-waiting-for-a-game) [![](public/assets/img/readme/pitft_default.png)](public/assets/img/readme/pitft_default.png) ### Game detected ! [](#game-detected-) [![](public/assets/img/readme/pitft_game.png)](public/assets/img/readme/pitft_game.png) Click on the upper-right arrow to instantly scroll to actions buttons. ### Four of the six actions buttons [](#four-of-the-six-actions-buttons) [![](public/assets/img/readme/pitft_actions.png)](public/assets/img/readme/pitft_actions.png) Reset and Exit buttons are under these buttons, to avoid to press them by mistake :) --- How to use Recalboy ? ===================== [](#how-to-use-recalboy-) Just open it in your browser :) To launch Demo Mode, click on the upper-right `"Play" icon`. To skip a game during Demo Mode, press `Hotkey` button. To quit Demo Mode, press `Hotkey` button or click on Recaloby's `Exit` icon. Demo mode can detect if you start to play a game and stop by itself. Yes. If there's any problem, just refresh your page. > **Note**: It only works with scraped games :) --- Configuration ============= [](#configuration) All is explained [HERE ON THE WIKI](https://github.com/kjbstar/recalboy/wiki/Configuration). --- Known Limitations ================= [](#known-limitations) [See the Wiki](https://github.com/kjbstar/recalboy/wiki/Known-limitations-&-bugs) TODO ==== [](#todo) - Add more informations from running games, to get something less basic. - Re-arrange Classic and Mini themes. - Demo mode: find a better way to handle Emulation Station off/on. - Arcade games : finding, adding, and managing the display of instructions card / move lists, to never forget how to make a Hadoken :) Thanks to --------- [](#thanks-to) - [Recalbox Community](https://forum.recalbox.com/). - [Cute File Browser](https://tutorialzine.com/2014/09/cute-file-browser-jquery-ajax-php): used (customised) for browsing backups. License ------- [](#license) Recalboy is open-sourced software licensed under the MIT license. Feel free to fork it and improve it. Keep in mind I don't consider myself as a developer, so don't be too rough with my code :) ### Health Score 23 — LowBetter than 27% of packages Maintenance11 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community10 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~41 days Recently: every ~51 days Total 6 Last Release 3149d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/bc92f84a72e04fb4b03cc6625276a1b8db485a4a2a55ad12a6f80234b6b48651?d=identicon)[kjbstar](/maintainers/kjbstar) --- Top Contributors [![kjbstar](https://avatars.githubusercontent.com/u/4302939?v=4)](https://github.com/kjbstar "kjbstar (83 commits)") --- Tags phprecalboxretroarchframeworklaravellumen ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/kjbstar-recalboy/health.svg) ``` [![Health](https://phpackages.com/badges/kjbstar-recalboy/health.svg)](https://phpackages.com/packages/kjbstar-recalboy) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.6k509.9M17.0k](/packages/laravel-framework) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)