NESiCAxLive games are Windows programs. Recalbox runs them with Wine-Proton, the Wine build Valve maintains for Proton.
The controls go through iDmacX, a loader of the JConfig family that replaces the cabinet's iDmacDrv I/O driver. It also acts as a local NESYS network service, which is what makes playing without a network possible. It is installed once (see BIOS and loaders).
Wine is licensed under LGPL 2.1.
iDmacX is third-party, closed software. It is not shipped with Recalbox.
Compatibility| RPI3/RPI02W | RPI4/400 | RPI5/500 | OGA/OGS/RG351 | PC | RG353 |
|---|---|---|---|---|---|
| ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
64-bit PC (x86_64) only, with a Vulkan-capable graphics driver.
Features| Feature | Supported |
|---|---|
| Automatic pad configuration | ✔︎ |
| Offline play (no NESiCA card) | ✔︎ |
| Cabinet Test menu and Service button | ✔︎ |
| Quit with Hotkey + Start | ✔︎ |
| Pause | ❌ |
| Save states | ❌ |
| Netplay | ❌ |
| RetroAchievements | ❌ |
There is no BIOS. There is, however, the iDmacX loader, its libraries and the CryptServer keys.
Recalbox does not provide these files. Use those of the io/1cc loader pack (the JConfig family). TeknoParrot is not supported.
The EmulationStation BIOS manager does not know these files: it will never report them as missing.
Copy them once, like this:
┣ 📁 recalbox
┃ ┣ 📁 share
┃ ┃ ┣ 📁 bios
┃ ┃ ┃ ┣ 📁 arcadeloaders
┃ ┃ ┃ ┃ ┣ 📁 idmacx
┃ ┃ ┃ ┃ ┃ ┣ 🗒 iDmacDrv32.dll
┃ ┃ ┃ ┃ ┃ ┣ 🗒 iDmacDrv64.dll
┃ ┃ ┃ ┃ ┃ ┣ 🗒 msvcp120.dll
┃ ┃ ┃ ┃ ┃ ┣ 🗒 msvcr120.dll
┃ ┃ ┃ ┃ ┃ ┣ 🗒 NesicaXlive.reg
┃ ┃ ┃ ┃ ┃ ┣ 📁 d3dx9
┃ ┃ ┃ ┃ ┃ ┃ ┣ 🗒 d3dx9_37.dll
┃ ┃ ┃ ┃ ┃ ┃ ┣ 🗒 d3dx9_43.dll
┃ ┃ ┃ ┃ ┃ ┃ ┣ 🗒 d3dcompiler_43.dll
┃ ┃ ┃ ┃ ┣ 📁 keys
┃ ┃ ┃ ┃ ┃ ┣ 🗒 *.key
.reg carries the Taito settings (local server off, coin mode): Recalbox imports it once into the Wine prefix..fx effects, which then stop on Create effect … failure.idmacx/keys/.
RomsA game is a folder: the full dump of the game, renamed with the .wine extension. Change nothing inside the dump: Recalbox completes it at launch.
Place the games like this:
┣ 📁 recalbox
┃ ┣ 📁 share
┃ ┃ ┣ 📁 roms
┃ ┃ ┃ ┣ 📁 nesica
┃ ┃ ┃ ┃ ┣ 📁 Ultra Street Fighter IV.wine
┃ ┃ ┃ ┃ ┃ ┣ 🗒 game.exe
┃ ┃ ┃ ┃ ┃ ┣ 🗒 ...
At launch, Recalbox:
dinput8.dll aside, renamed dinput8.dll.wine-off, because iDmacX carries its own DirectInput and the dump's makes pad initialisation crash under Wine;game.exe.It records the files it added in .arcade-loaders. When you update the pack, they are replaced on the next launch. A file the dump ships itself is never overwritten.
A NESiCAxLive game filed under
taitotypexis recognised, because it importsiDmacDrv. It then gets iDmacX and this system's controls.
Recorded in November 2026, on the team's hardware. This list is in no way exhaustive: the other games have not been tried.
| Game | State |
|---|---|
| Chaos Code | ✅ playable, controls and exit verified |
| Skullgirls | ⚠️ starts up to the "INSERT COIN" screen |
| Ultra Street Fighter IV | ⚠️ starts up to the title screen |
Advanced emulator configurationPads are configured automatically from EmulationStation: Recalbox writes the files the loader reads, monitor_input.bin and monitor_misc.bin, into the game folder.
| Cabinet | Pad |
|---|---|
| Directions | D-pad |
| Coin | Select |
| Start | Start |
| Buttons 1, 2, 3 | A, B, RB |
| Buttons 4, 5, 6 | X, Y, LB |
| TEST (operator menu) | Left stick click (L3) |
| SERVICE | Right stick click (R3) |
| Quit the game | Hotkey + Start |
The left stick is deliberately left unbound: iDmacX would read its resting position as a held direction, and the menus would scroll on their own. Directions are on the d-pad.
A game folder you configured by hand, with JConfig, keeps your configuration: Recalbox only rewrites the files it wrote itself. The screen size is written there too, otherwise the games open in a 640 × 480 window in a corner.
NESiCAxLive games talk to the NESYS network service through a named pipe, \\.\pipe\nesys_games. By default iDmacX answers that pipe itself: no network and no server are needed. The game behaves like an unplugged cabinet and reports that the NESiCA card is unavailable.
To use a real NESYS service (a local server, a card reader), add this to recalbox.conf:
wine.nesys.online=1
iDmacX then leaves the pipe to the service. You have to start that service yourself, through a launch script (see below). Only the drivers copied from bios/arcadeloaders follow this setting. A driver the dump ships itself is never modified.
Every script placed in /recalbox/share/system/configs/wine/hooks.d/ is run, in name order:
pre <game folder>, just before the game;post <game folder>, right after it.The scripts inherit the WINEPREFIX and RUNNER variables: they can start a service in the same Wine prefix as the game.
.sh files are run with sh..py files are run with python3.As for Recalbox userscripts, the extension decides: the share is often exFAT, which keeps no executable bit.
A failing script is reported in the log, but never keeps the game from starting.
A game.windows text file, placed in the game folder, changes the launch of that game alone:
| Key | Role |
|---|---|
exe= |
program to launch |
args= |
program arguments |
dxvk=0 or dxvk=1 |
turns DXVK off or on (dxvk=0 renders through OpenGL, useful when the screen stays black) |
setenv=NAME=VALUE |
environment variable |
prefix= |
Wine prefix to use, instead of the system's own |
runner= |
another Wine install, under /recalbox/windows/runners/ |
In args= and setenv=, %GAMEDIR% is replaced by the game folder as Windows sees it.
The games of one system share a Wine prefix (a bottle), /recalbox/windows/prefixes/nesica: it is created on the first launch.
The log is in /recalbox/share/system/logs/wine.log.
[arcade-loaders] loader missing: …: the bios/arcadeloaders/idmacx folder is missing.[arcade-loaders] missing from loader: iDmacDrv…: the folder is there, but not the driver for the right architecture.XIO ERROR on screen: the game's CryptServer key is missing.Create effect … failure: the D3DX9 libraries are missing from the pack as well as from the dump.iDmacDrv32.dll is a packed build.
External links