RetroAchievements integration – track points, achievements and what you're playing

If you use RetroAchievements (https://retroachievements.org/) (achievements for retro games across dozens of emulated consoles), I've been building a Home Assistant integration that pulls your profile, progress and activity into HA so you can put it on
a dashboard or drive automations.

It's a HACS custom integration, open source, with English and Brazilian Portuguese translations.

What you get

Profile & stats sensors — total points, true points, global rank; hardcore vs. softcore points; games mastered/beaten/played; total awards; status and rich presence; recently played games and recent achievements.

Per-game sensors — completion %, achievements earned/total, points, last played (one device per monitored game).

Other entity types

  • image – box art of the game you're currently playing + your last achievement badge
  • todo – read-only mirror of your "Want to Play" backlog
  • binary_sensor – is_gaming and aotw_unlocked
  • button – force refresh

Automations — events retroarchievements_achievement_unlocked, retroarchievements_award_earned, retroarchievements_aotw_changed, plus a notify-on-unlock blueprint (with a hardcore-only filter). Example:

automation:
- trigger:
- platform: event
event_type: retroarchievements_achievement_unlocked
action:
- service: notify.mobile_app_your_phone
data:
title: ":trophy: Achievement unlocked!"
message: >
{{ trigger.event.data.title }} ({{ trigger.event.data.points }} pts)
— {{ trigger.event.data.game_title }}
data:
image: "{{ trigger.event.data.badge_url }}"

Install — HACS → custom repo GitHub - hudsonbrendon/HA-retroachievements: The RetroAchievements project aims to provide tools for creating achievements for retrogames and ways to enjoy such creations. · GitHub (Integration) → restart → add integration → username + API key (account settings on the RA site). Min HA 2025.2.4; brand icon on the card needs HA 2026.3+.

Links — repo: GitHub - hudsonbrendon/HA-retroachievements: The RetroAchievements project aims to provide tools for creating achievements for retrogames and ways to enjoy such creations. · GitHub · RA: https://retroachievements.org/