[ 🇫🇷 Version Française ici ](FR_Home) ## Introduction This repository allows you to integrate Recalbox in your Home Assistant : - In your dashboard : - Get status - Display current game - Stop current game - Take a screenshot - Pause/resume game - Save/Load game state - Turn off - Reboot - etc - Trigger any automation you want. For example, change light color according to the game launched, send notifications, etc. - Voice/text commands with assistant (EN/FR) : - Launch a game by its title (full or partial title search) - Ask what is the current game - Stop current game - Take a screenshot - Pause/resume game - Save/Load game state - Turn off Recalbox - etc ![](https://github.com/recalbox/RecalboxHomeAssistant/blob/master/docs/RecalboxHomeAssistantIntegration.png?raw=true) ## Requirements - You should have a `Recalbox` available. Tested only with Recalbox 9.2.3 and 10.0, Raspberry Pi 3 B+. Should be accessible by its hostname, like `recalbox.local` for example. > Its API ports (80 and 81) and UDP ports (1337 and 55355) should be accessible in the local network (enabled by default). - You should have a `Home Assistant`. Tested on Home Assistant 2026.1, 2026.2, 2026.2.1, on Raspberry Pi 3 B+. By default, It should be accessible in the same network, at `homeassistant.local` INSTALLATION