Recalbox: Custom system console

Overleaf Community Edition Server: Latex editor | Luciano's tech see the web in desktop mode to better experience | 468 OS | 303 OS Pi 4B | 72 OS Pi5

Luciano's tech

Agregar Sistemas personalizados a Recalbox

Add your own custom systems to Recalbox

Jan 23, 2025

AGREGAR SISTEMAS PERSONALIZADOS DE JUEGOS EN RECALBOX

Add your own custom systems to Recalbox

Capcom, SNK, Lucha, Naves, Fútbol, Sega Raspberry Pi Buenos Aires, como quieras que se llame, vos tenés el poder.

Old Recalbox versions

Recalbox

Get Recalbox OS

Tutorial Crea tu propio joystick Arcade bluetooth LE

Para realizar esto en Recalbox debemos entrar por Putty, Termius o openssh en linux:

For make this on Recalbox we have to use Putty, Termius or openssh on linux

En Recalbox 7 en adelante podemos entrar a la Terminal pulsando ALT+F4 y luego Alt+F2

Since Recalbox 7 we can enter to the Terminal with ALT+F4 then Alt+F2

login: root
password: recalboxroot

Putty:

Colocar la IP de nuestro Recalbox, dale a conectar o aceptar, responde que si, pone las credenciales:

Put your Recalbox_IP click on Connect, Acept, answer Yes and login:

login: root
password: recalboxroot

OpenSSH:

ssh root@IPdeRecalbox
login: root
password: recalboxroot

Termius:

Elegi Continue without Account, Agrega el host con +, New Host

En Alias lo que se te ocurra.
En Hostname la IP de Recalbox
En Port 22
En Username: root
En Password: recalboxroot
En Key toca el icono de la llave, luego +, luego Generate Key, en Name lo que quieras, acepta tocando verificar, toca la clave creada. dale a verificar. Toca el Host creado, Connect. Listo, manos a la obra:

Paso 1:

En Recalbox debemos montar el sistema como escritura con--On Recalbox we have to mount the system for write:

mount -o remount,rw /

Paso 2:

Movernos a la carpeta de emulationstation--Move to emulationstation folder:

cd /etc/emulationstation

Recalbox 8.1.1 & 9.0 & 9.1 & 9.2:

Movernos a la carpeta de emulationstation--Move to emulationstation folder:

cd /recalbox/share_init/system/.emulationstation/

Paso 3:

Hacer un backup--Make a backup:

cp es_systems.cfg es_systems.old

Recalbox 8.1.1 & 9.0 & 9.1 & 9.2:

Copiar a--Copy to:

cp systemlist.xml /recalbox/share/system/.emulationstation/

Paso 4:

Agregar nuestro sistema personalizado, basado en uno existente.--Add or custom system based on one existing. Ej: Megadrive

nano es_systems.cfg

Nuestro emulador base--Our base system:

<system>
<fullname>Sega Megadrive</fullname
<name>megadrive</name>
<path>/recalbox/share/roms/megadrive</path>
<extension>.md .MD .bin .BIN .zip .ZIP .gen .GEN .smd .SMD .7z .7Z</extension>
<command>python /usr/lib/python2.7/site-packages/configgen/emulatorlauncher.pyc %CONTROLLERSCONFIG% -system %SYSTEM% -rom %ROM% -emulator %EMULATOR% -core %CORE% -ratio %RATIO% %NETPLAY%</command>
<platform>megadrive</platform>
<theme>megadrive</theme>
<emulators>
<emulator name="libretro">
<cores>
<core>genesisplusgx</core>
<core>picodrive</core>
</cores>
</emulator>
</emulators>
</system>

Replicamos y cambiamos las etiquetas--Copy and change the next <tags> <etiqueta> name, fullname, platform, theme, path:

<system>
<fullname>Sega Raspberry Pi Buenos Aires</fullname>
<name>rpibuenosaires</name>
<path>/recalbox/share/roms/rpibuenosaires</path>
<extension>.md .MD .bin .BIN .zip .ZIP .gen .GEN .smd .SMD .7z .7Z</extension>
<command>python /usr/lib/python2.7/site-packages/configgen/emulatorlauncher.pyc %CONTROLLERSCONFIG% -system %SYSTEM% -rom %ROM% -emulator %EMULATOR% -core %CORE% -ratio %RATIO% %NETPLAY%</command>
<platform>rpibuenosaires</platform>
<theme>rpibuenosaires</theme>
<emulators>
<emulator name="libretro">
<cores>
<core>genesisplusgx</core>
<core>picodrive</core>
</cores>
</emulator>
</emulators>
</system>

Recalbox 8.1.1 & 9.0 & 9.1 & 9.2:

Agregar nuestro sistema personalizado, basado en uno existente.--Add or cuustom system based on one existing. Ej: Snes

nano /recalbox/share/system/.emulationstation/systemlist.xml

Recalbox 8.1.1:

Nuestro emulador base--Our base system:

<system uuid="3df92492-d69a-48f8-8e14-9a62bd9805a6" name="snes" fullname="Super Nintendo Entertainment System">
<descriptor path="%ROOT%/snes" theme="snes" extensions=".sfc .dx2 .gd7 .zip .gd3 .bs .smc .7z .st .bsx .swc .fig" icon="$F25e"/>
<scraper screenscraper="4"/>
<properties type="console" pad="mandatory" keyboard="no" mouse="optional" lightgun="optional" releasedate="1990-11" manufacturer="Nintendo" retroachievements="1" crt.multiresolution="0" crt.multiregion="1" ignoredfiles=""/>
<emulatorList>
<emulator name="libretro">
<core name="snes9x" priority="2" extensions=".smc .sfc .swc .fig .bs .st .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="snes9x2010" priority="4" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="0"/>
<core name="snes9x2005" priority="5" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="0"/>
<core name="snes9x2002" priority="6" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="0"/>
</emulator>
</emulatorList>
</system>

Necesitamos cambiar el--We need to change the system uuid, podemos obtener uno cualquiera--Get a new one from the next hyperlink aquí en Online GUID Generator Tool:

Replicamos y cambiamos las etiquetas--Copy and change the next <tags> <etiqueta> fullname, theme, descriptor path, system uuid:

<system uuid="88c6da1d-f3d3-4562-8d60-9a545b3305c5" name="snes" fullname="Super Raspberry Pi buenos Aires">
<descriptor path="%ROOT%/snespibsas" theme="snespibsas" extensions=".sfc .dx2 .gd7 .zip .gd3 .bs .smc .7z .st .bsx .swc .fig" icon="$F25e"/>
<scraper screenscraper="4"/>
<properties type="console" pad="mandatory" keyboard="no" mouse="optional" lightgun="optional" releasedate="1990-11" manufacturer="Nintendo" retroachievements="1" crt.multiresolution="0" crt.multiregion="1" ignoredfiles=""/>
<emulatorList>
<emulator name="libretro">
<core name="snes9x" priority="2" extensions=".smc .sfc .swc .fig .bs .st .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="snes9x2010" priority="4" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="0"/>
<core name="snes9x2005" priority="5" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="0"/>
<core name="snes9x2002" priority="6" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="0"/>
</emulator>
</emulatorList>
</system>

Recalbox 9.0 & 9.1:

Nuestro emulador base--Our base system:

<system uuid="3df92492-d69a-48f8-8e14-9a62bd9805a6" name="snes" fullname="Super Nintendo Entertainment System">
<descriptor path="%ROOT%/snes" theme="snes" extensions=".fig .sfc .st .7z .zip .bs .smc .swc .gd7 .bsx .dx2 .gd3" icon="$F25e"/>
<scraper screenscraper="4"/>
<properties type="console" pad="mandatory" keyboard="no" mouse="optional" lightgun="optional" releasedate="1990-11" manufacturer="Nintendo" retroachievements="1" crt.multiresolution="0" crt.multiregion="1" ignoredfiles=""/>
<emulatorList>
<emulator name="libretro">
<core name="snes9x" priority="2" extensions=".smc .sfc .swc .fig .bs .st .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="mesen_s" priority="3" extensions=".smc .sfc .swc .fig .bs .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="low" crt.available="0"/>
<core name="snes9x2010" priority="4" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="snes9x2005" priority="5" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="snes9x2002" priority="6" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="bsnes" priority="7" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="bsneshd" priority="8" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="0"/>
</emulator>
</emulatorList>
</system>

Necesitamos cambiar el--We need to change the system uuid, podemos obtener uno cualquiera--Get a new one from the next hyperlink aquí en Online GUID Generator Tool:

Replicamos y cambiamos las etiquetas--Copy and change the next <tags> <etiqueta> fullname, theme, descriptor path, system uuid:

<system uuid="8c8c14f5-0c3d-4da5-8e6c-b0b72cd07246" name="snes" fullname="Super Raspberry Pi buenos Aires">
<descriptor path="%ROOT%/snespibsas" theme="snespibsas" extensions=".fig .sfc .st .7z .zip .bs .smc .swc .gd7 .bsx .dx2 .gd3" icon="$F25e"/>
<scraper screenscraper="4"/>
<properties type="console" pad="mandatory" keyboard="no" mouse="optional" lightgun="optional" releasedate="1990-11" manufacturer="Nintendo" retroachievements="1" crt.multiresolution="0" crt.multiregion="1" ignoredfiles=""/>
<emulatorList>
<emulator name="libretro">
<core name="snes9x" priority="2" extensions=".smc .sfc .swc .fig .bs .st .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="mesen_s" priority="3" extensions=".smc .sfc .swc .fig .bs .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="low" crt.available="0"/>
<core name="snes9x2010" priority="4" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="snes9x2005" priority="5" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="snes9x2002" priority="6" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="bsnes" priority="7" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="1"/>
<core name="bsneshd" priority="8" extensions=".smc .sfc .swc .fig .gd3 .gd7 .dx2 .bsx .7z .zip" netplay="1" softpatching="1" compatibility="high" speed="high" crt.available="0"/>
</emulator>
</emulatorList>
</system>

Paso 5:

Guardar y cerrar el archivo--Close and save:

Ctrl+ o (vocal o) , enter, Ctrl+x

Paso 6:

Nos movemos a nuestro--Go to the default theme por defecto:

cd /etc/emulationstation/themes/recalbox-next/

En el crearemos la carpeta de nuestro--We make our theme directory for our custom system theme del sistema:

mkdir pibsas

Copiaremos en él, el contenido del theme del que nos copiamos--Copy all the content of our base console to our theme directory:

cp -r megadrive/* rpibuenosaires

Recalbox 8.1.1 & 9.0 & 9.1 & 9.2:

Nos movemos a nuestro--Go to the default theme por defecto:

cd /recalbox/share_init/system/.emulationstation/themes/recalbox-next

En el crearemos la carpeta de nuestro--We make our theme directory for our custom system theme del sistema:

mkdir snespibsas

Copiaremos en él, el contenido del theme del que nos copiamos--Copy all the content of our base console to our theme directory:

cp -r snes/* snespibsas

Paso 7:

Creamos el directorio rom de nuestro sistema personalizado--We make our rom directory for our custom system:

cd /recalbox/share/roms/
mkdir rpibuenosaires

Recalbox 8.1.1 & 9.0 & 9.1 & 9.2:

Creamos el directorio de nuestro sistema personalizado--We make our rom directory for our custom system:

cd /recalbox/share/roms/
mkdir snespibsas

Paso 8:

Debemos conseguir una foto para que sea nuestro logo, debe tener extensión .svg, colocarla en la carpeta creada para facilitar su copia a la carpeta correcta del theme:

We need a logo for our custom system, need have an .svg extension, momentarily we put in our rom folder for copy later to our theme folder:

/recalbox/share/roms/rpibuenosaires/logo.svg

Y nombrarla--named logo.extension donde extensión debe ser--where extension need to be .svg

Esto lo podemos hacer por--We can copy using ftp como hacemos con las--like we do with roms y--and bios.

Recalbox 8.1.1 & 9.0 & 9.1 & 9.2:

Debemos conseguir una foto para que sea nuestro logo, debe tener extensión .svg, colocarla en la carpeta creada para facilitar su copia a la carpeta correcta del theme:

We need a logo for our custom system, need have an .svg extension, momentarily we put in our rom folder for copy later to our theme folder:

/recalbox/share/roms/snespibsas/logo.svg

Y nombrarla--named logo.extension donde extensión debe ser--where extension need to be .svg

Esto lo podemos hacer por--We can copy using ftp como hacemos con las--like we do with roms y--and bios.

Paso 9:

Moveremos esa foto a la carpeta correspondiente de nuestro--Move the logo to the theme folder:

cp(copy) this to there
cp /recalbox/share/roms/rpibuenosaires/logo.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/eu/
cp /recalbox/share/roms/rpibuenosaires/logo.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/us/
cp /recalbox/share/roms/rpibuenosaires/logo.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/jp/

Para perfeccionar esto podemos reemplazar las otras fotos--To make more perfect our theme system, get more logos for:

console.svg
consolegame.svg
controller.svg
game.svg

Estas las reemplazamos así--And we can replace them with:

cp(copy) this to there

cp /recalbox/share/roms/rpibuenosaires/console.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/eu/
cp /recalbox/share/roms/rpibuenosaires/console.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/us/
cp /recalbox/share/roms/rpibuenosaires/console.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/jp/
cp /recalbox/share/roms/rpibuenosaires/consolegame.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/eu/
cp /recalbox/share/roms/rpibuenosaires/consolegame.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/us/
cp /recalbox/share/roms/rpibuenosaires/consolegame.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/jp/
cp /recalbox/share/roms/rpibuenosaires/controller.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/eu/
cp /recalbox/share/roms/rpibuenosaires/controller.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/us/
cp /recalbox/share/roms/rpibuenosaires/controller.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/jp/
cp /recalbox/share/roms/rpibuenosaires/game.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/eu/
cp /recalbox/share/roms/rpibuenosaires/game.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/us/
cp /recalbox/share/roms/rpibuenosaires/game.svg /etc/emulationstation/themes/recalbox-next/rpibuenosaires/data/jp/

Recalbox 8.1.1 & 9.0 & 9.1 & 9.2:

Moveremos esa foto a la carpeta correspondiente de nuestro--Move the logo to the theme folder:

cp(copy) this to there

cp /recalbox/share/roms/snespibsas/logo.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/eu/
cp /recalbox/share/roms/snespibsas/logo.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/us/
cp /recalbox/share/roms/snespibsas/logo.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/jp/

Para perfeccionar esto podemos reemplazar las otras fotos--To make more perfect our theme system, get more logos for:

console.svg
consolegame.svg
controller.svg
game.svg

Estas las reemplazamos así--And we can replace them with:

cp(copy) this to there

cp /recalbox/share/roms/snespibsas/console.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/eu/
cp /recalbox/share/roms/snespibsas/console.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/us/
cp /recalbox/share/roms/snespibsas/console.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/jp/
cp /recalbox/share/roms/snespibsas/consolegame.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/eu/
cp /recalbox/share/roms/snespibsas/consolegame.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/us/
cp /recalbox/share/roms/snespibsas/consolegame.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/jp/
cp /recalbox/share/roms/snespibsas/controller.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/eu/
cp /recalbox/share/roms/snespibsas/controller.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/us/
cp /recalbox/share/roms/snespibsas/controller.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/jp/
cp /recalbox/share/roms/snespibsas/game.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/eu/
cp /recalbox/share/roms/snespibsas/game.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/us/
cp /recalbox/share/roms/snespibsas/game.svg /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/data/jp/

Paso 10(podemos saltearlo tranquilamente)--Can be skipped:

Editaremos nuestro--Edit custom.xml, en el cambiaremos las lineas--Change <text>, colocando la info que veamos que sea necesario para nuestro theme.

nano /etc/emulationstation/themes/recalbox-next/rpibuenosaires/custom.xml

Recalbox 8.1.1 & 9.0 & 9.1 & 9.2:

nano /recalbox/share_init/system/.emulationstation/themes/recalbox-next/snespibsas/custom.xml

Modificamos --Modify:

<view name="system">
<text name="info1" extra="true">
<text>Manufacturer : Sega Raspberry Pi Buenos Aires/Nintendo Pi BsAs</text>
<text name="info2" extra="true">
<text>Year of Release : 2023</text>
</text>
<text name="info3" extra="true">
<text>Units sold : 300 million</text>
</text>
<text name="info4" extra="true">
<text>Best-selling game : Sonic the Quiaca</text>
</text>
<text name="info5" extra="true">
<text>CPU : 16-bit Motorola 68000 @ 7.6 MHz</text>
</text>
<text name="info6" extra="true">
<text>CPU2 : 8-bit Zilog Z80 @ 3.58 Mhz (sound CPU)</text>
</text>
<text name="info7" extra="true">
<text>RAM : 64 kB / VRAM : 64kB / sound RAM : 8kB</text>
</text>
<text name="info8" extra="true">
<text>Video : 16-bit Sega VDP</text>
</text>
<text name="info9" extra="true">
<text>Resolution : 320×224 pixels, 64 colors (512 colors palette)</text>
</text>
<text name="info10" extra="true">
<text>Sound : Yamaha YM2612 FM and TI SN76489 PSG</text>
</text>
</view>

Guardamos y cerramos el archivo con--Close and save:

Ctrl+ o (vocal o) , enter, Ctrl+x

Paso 11:

Reiniciamos--Restart:

reboot

Paso 12:

Si no nos equivocamos veremos un nuevo sistema con nuestro logo y los juegos que hemos elegido. If we do all right, we can see our new custom system, make sure to put roms in the custom rom folder.