Skip to content

EN_Architecture

Jump to bottom
Aurélien Tomassini edited this page Feb 10, 2026 · 1 revision

Recalbox to Home Assistant

On the Recalbox, a script listens on local events, based on Scripts sur événements d'EmulationStation | Recalbox Wiki . The scripts reads the needed data for game information, and sends a message to Home Assistant with JSON data. Home Assistant can then update its "Recalbox" entity with the current game.

The attributes read by Home Assistant are, through this JSON :

  • game
  • console
  • rom
  • genre
  • genreId
  • imageUrl
  • recalboxIpAddress
  • recalboxVersion : Version of the Recalbox OS
  • hardware : Device running the Recalbox
  • scriptVersion : Version of the integration script in the Recalbox

Home Assistant to Recalbox

On Home Assistant, orders are sent to Recalbox via API and UDP commands :

  • Stop, reboot, screenshot commands via API
  • Game list via API
  • Launch a game via UDP

Assist integration for voice/text control has also been implemented in order to control, get information, or find a game to launch.
It uses the same services just listed.

Recalbox main wiki : https://wiki.recalbox.com/

Clone this wiki locally