Home

🇫🇷 Version Française ici

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