[ 🇫🇷 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

## 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