About
Gaming Status is a Home Assistant integration that tracks active gaming sessions across Steam, Xbox, PlayStation, Discord and Playnite. It combines the platforms and PC sensors into one master status sensor for each person, which avoids the online and offline flutter of individual Xbox and Steam sensors. Session start and end alerts can go out through Discord, SMS or mobile notifications, and weekly summaries are available. Parental controls track daily playtime and notify when a limit, curfew or age-rating threshold is reached. Each player can have games excluded, achievement history cleared, and a place on an optional public page. It works locally, is set up in the UI, and optionally uses SteamGridDB artwork with local image caching.
Automatic summary of the README and code of adamjthompson/Gaming-Status. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Gaming Status Setup
- Platforms to Track
- Enable Notifications & Reporting
- Enable Parental Controls
- SteamGridDB API Key (Optional)
- Enable Local Image CachingDownloads artwork directly to your Home Assistant storage. Makes dashboard load times instant, allows for offline artwork access, and prevents broken images during Internet outages. *Note: If you do NOT have an external Home Assistant URL, using this setting will break Discord notification images.*
Discord Configuration
- Discord Bot Token
- Discord Server ID
Set up your first Player
- Player Name
- Steam Sensor
- Xbox Sensor
- PlayStation Sensor
- Discord Profile
- Playnite Sensor
- Gaming Status Agent Sensor
- Custom Sensor
After setup
- Player Menu
- Friendly Namee.g. John
- Steam sensore.g. sensor.steam_player_one
- Xbox sensore.g. sensor.player_one_xbox_status
- PlayStation sensorSelect the 'Now Playing' sensor for this PSN account (suffix varies by language, e.g. _now_playing or _spielt_gerade)
- PS3 media playerSelect the PlayStation Network media_player entity for this PS3 (e.g. media_player.playstation_3). Adds to this player's PlayStation history alongside their regular PSN activity.
- Discord memberSelect the Discord user from the dropdown.
- Gaming Status Agent sensorSelect this player's Gaming Status Agent sensor, e.g. sensor.gsa_player_one
- Custom sensorAny sensor whose state is the game title (or on/off), e.g. sensor.player_one_active_pc_game
- Playnite sensore.g. sensor.playnite_playing_game
- Steam sensor
- Xbox sensorSelect the 'Status' sensor — the suffix varies by HA language
- PlayStation sensorSelect the 'Now Playing' sensor — the suffix varies by HA language
- PS3 media playerSelect the PS3 media_player entity for this PSN account
- Discord memberSelect the Discord user from the dropdown.
- Gaming Status Agent sensorSelect this player's Gaming Status Agent sensor (sensor.gsa_*)
- Custom sensorAny sensor whose state is the game title (or on/off), e.g. a HASS.Agent or template sensor
- Playnite sensor
- Delete this player
- Session Start Notification(s)Select notification method(s) when this player starts gaming.
- Session End Notification(s)Select notification method(s) when this player stops gaming.
- Suppress other players' Xbox sensorsWhen this player is confirmed playing on any of their own sensors, block the selected Xbox sensor(s) from also claiming the same game.
- Games to exclude (one per line)Game titles to ignore for this player, one per line.
- Clear Achievement/Trophy HistoryUse with caution: Permanently deletes this player's entire recorded achievement/trophy unlock history, across every platform. Applies once on the next reload, then automatically switches back off. This cannot be undone.
- Show on public pageInclude this player on the no-login public page. Turn the page itself on and choose what it shows under Public Page in the main menu.
- Steam
- Xbox
- PlayStation
- Steam
- Xbox
- PlayStation
- Enable Notifications & ReportingTurns session alerts and weekly summaries on or off. Your notification settings are kept while this is off.
- Notification Menu
- Notification Methods
- Weekly Report Settings
- Notification Artwork Style
- NameA friendly name, e.g. Dad's Phone
- Notification Type
- Notifier
- Target IDRequired for Discord (Channel ID) or SMS (Phone Number).
- Name
- Notification Type
- Notifier
- Target ID
- Delete this notification
Texts from the code of adamjthompson/Gaming-Status.
Troubleshooting
- Repair noticesNotices it can show in Settings, Repairs:SteamGridDB API key rejected
From the README
This is a powerful, unified custom integration for Home Assistant that tracks and consolidates gaming presence across Steam, Xbox Live, PlayStation Network, Discord, Playnite, and the Gaming Status Agent PC app into a single, clean dashboard sensor for each person in your household / friend group. It's super useful if you want to be able to track who is online, what they're playing, and for how long.
I started developing this as a way to have persistent sensors since I was annoyed that the Xbox and Steam sensors would regularly flutter between online/offline status, making notifications and my gaming dashboard unreliable.
- Unified Master Sensor: Combines Xbox, PlayStation, Steam, Discord, Playnite, and Gaming Status Agent into one clean "Master Status" sensor per person.
- Online/Offline Notifications: Receive Discord, SMS, and/or Mobile notifications when users start or finish playing a game.
- Parental Controls: Track daily playtime and receive notifications when a limit, curfew, or age-rating threshold is reached.
- Discord Rich Presence: Track hundreds of standalone games, emulators, and Epic/EA/Ubisoft launchers automatically by hooking into Discord's Rich Presence status. Automatically ignores custom text…
- Gaming Status Agent Support: Track PC games from Amazon Games, Battle.net, EA, Epic, GOG, HoYoverse, Minecraft (Java Edition), Playnite, Riot Games, Roblox, Rockstar Games, and Ubisoft (plus your…
Shows in Vulpo
Button card, Chart card, Apple Watch.Information
- Installs
- 95 sharing analytics
- GitHub stars
- 11
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- 2026.10.8,
- Category
- Media and entertainment, Gaming
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
gaming_status- Issues
- Report an issue
