Recalbox theme
Pour les non anglophone la documentation en français est disponible ici!
La documentación en español está disponible aquí!
Eine Dokumentation in deutscher Sprache finden Sie hier!
La documentazione in italiano è disponibile qui!
A documentação em português está disponível aqui!
A documentação em brasileira está disponível aqui!
This theme is designed to display a full screen image for every system that matches a game box illustration or artwork at the time game was released. All systems will randomly display a different game theme each time Recalbox is started (at least 2 game themes are available for each system). It is based on recabox-next theme so you'll get all advantages of it (region settings, game list layout settings, etc..) + several options so you can get a visual that suits you.
Theme is configured by default to use a custom mix to scrap your game images, please read carefully documentation below to get more info even if you don't want to use it as you'll have to adjust theme GAMELISTVIEW option to get it work properly with others mixes.
Theme is compatible with Recalbox 8.1+ and with 16:9, 4:3 and small 4:3 screens like GPi CASE.
Here are some screenshots of some available game themes :
Watch all game theme pictures from Next Pixel website.
To install theme drag and drop es-theme-next-pixel-xxx folder into your recalbox/themes folder. Then choose es-theme-next-pixel-xxx theme from Recalbox options (UI SETTINGS > THEME > THEME SET).
Next Pixel theme includes its own custom mix to make your game screenshots and video snaps integration even better. If you never heard of mixes, they're just these images you may download along with game info/description using Recalbox internal scraper or using an external scraper like Skraper. Better than a long description here are 2 captures using standard mix and using Next Pixel mix.
Standard mix
Next Pixel mix
To get more info on how to use Next Pixel mix, check documentation.
If you do not want to use Next Pixel mix select any "others mixes" option from theme GAMELISTVIEW settings or you will get some weird graphical assets overlaying your scraped images. Press Start > UI SETTINGS > THEME > THEME CONFIGURATION > THEME GAMELISTVIEW > choose any layout with "others mixes".
Next Pixel theme use random game theme lists for each systems. This game theme lists can be customized by editing each systems/[system name]/games.sh files. For example you may want to customize favorites and auto-lastplayed system game themes with your own favorites and last played games as by default Next Pixel theme comes up with my personal favorites and last played games.
Note by default game themes are all set up correctly with the right system (but favorites and auto-lastplayed systems of course). I made lots of researches to find out which game were available and most popular at the time system was running. All game themes match an official game box for that system, so you may notice for example that earthworm jim game theme is available for super nintendo and megadrive/genesis but not from sega cd though it was a pretty popular version. This is intented beacause sega cd version box used a different art than super nintendo and megadrive/genesis. Note as well that games chosen for a system may not always be the most popular due to the fact it may be very difficult to find a source image with the right quality for this theme. If you notice any mistake or think a game theme should be available from another system though, tell me i'll check it.
Enough talking let's edit game theme list from favorites system as an axample. Open games.sh with a text editor from systems/favorites folder and edit game themes you want by removing everything between # Edit game list below and # Do not edit below this line and adding your own game themes. You can see all game theme available from games folder, just copy game folder names you want in games.sh file.
Please do not modify anything outside of # Edit game list below and # Do not edit below this line if you don't know what you're doing this may break next step.
Note editing file is not enough to make those changes available when you run Recalbox, when you're done editing games.sh file close it and execute it to apply your personnal list, then restart Recalbox.
You may repeat the same steps to edit auto-lastplayed game themes or any other system.
Imageviewer system uses a game theme that hightlights 3 games.
All contributors and donators may ask for a custom version with game themes of their choice (choice is limited to actual available game themes, complete list is available from games folder).
Contact me to get it!
Project is hosted on Github.
I need help! If you're interested to get involve in this theme please contact me using Recalbox forum or by email contact[at]samystudio.net.
If you don't know how to contribute maybe you can offer me a drink ;)
Thank you for contributing:
Several packages are available depending on your screen ratio and resolution. Actually theme fully supports 16:9 and 4:3 screens.
3 packages are available with 1080p images (full hd screens, 4K, 8K), 720p images (hd screens) or 480p images (intended for Raspberry users).
If you are a Raspberry Pi user please read carefully next lines (PC/Odroid users can skip to download links and grab package that match best their screen resolution). Raspberry Pi may lead to memory issues when using a lot of images. 720p package is the right way to go even if you're on a big screen tv 1080p/4K/8K. I highly recommend to force Recalbox to run at 720p if your screen is running higher resolution, as it will improve performances and images quality. To do so you'll have to edit config.txt using PuTTy or WinSCP.
Don't forget to allow write access before modify your file.
From this file search for hdmi_group and hdmi_mode and set both as following :
Don't forget to remove '#' char on those lines if present.
If you still have issues with 720p (mainly images replaced with white rectangle) and you already have forced Recalbox to run at 720p you may try to allocate more gpu memory. Edit the same config.txt file, this time search for gpu_mem_1024=448 and set it to gpu_mem_1024=512 and once again Don't forget to allow write access before modify your file.
Warning : PSP emulator may not work anymore, so if you're not using PSP system this shouldn't be a problem.
If you don't want to change memory settings or you're using PSP system then you should switch to 480p package, images quality will be less sharp but you should be able to use lots of systems without issues.
1080p DOWNLOAD es-next-pixel-v2-16x9-1080p for Recalbox 8.1+
720p DOWNLOAD es-next-pixel-v2-16x9-720p for Recalbox 8.1+
480p DOWNLOAD es-next-pixel-v2-16x9-480p for Recalbox 8.1+
Download previous packages for Recalbox 8.0 or lower.
2 packages are available with 1024x768 images and 320x240 images, if you're using a screen with higher resolution than 320x240 pick crt package, if you're using 320x240 or lower screen (like GPi CASE) pick crt-small package. If you're using 1024x768 package with a screen with higher resolution than 1024x768, I highly recommend to force Recalbox to run at the same resolution as it will improve performances and images quality. To do so you'll have to edit config.txt using PuTTy or WinSCP.
Don't forget to allow write access before modify your file.
From this file search for hdmi_group and hdmi_mode and set both as following :
Don't forget to remove '#' char on those lines if present.
1024x768 DOWNLOAD es-next-pixel-v2-4x3-768p for Recalbox 8.1+
320x240 (GPi CASE) DOWNLOAD es-next-pixel-v2-4x3-240p for Recalbox 8.1+
Download previous packages for Recalbox 8.0 or lower.
I'm all ears to any suggestions or to add alternative game image/music, don't be shy.
MIT License
Copyright (c) 2018 mYSt
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.