Skip to content
AWTRIX Flows
Submit flow
XBOX Game Status shown on an AWTRIX display
Fig. 1 XBOX Game Status, as strusic runs it.

XBOX Game Status

XBOX Game Status

Specifications
System AWTRIX NG Scripts
Firmware AWTRIX NG
Topic Social
Built by strusic
File CPcMMuot5ehY.ax · 4.2 KB
Icons 1
Published 26 Aug 2026

🎮 Xbox Live Presence Monitor (Standalone)
A native Berry script for AWTRIX NG that dynamically displays your currently played Xbox game along with the live session duration (e.g., Gears of War - 1h 23m).

✨ Features
Smart Visibility: The app only appears in your AWTRIX loop when you are actively playing a game. It automatically hides (skips) when the console is off, you are on the Dashboard, or watching media apps.

Precision Filtering: Reads the raw JSON from the API and strictly looks for "placement": "Full" to ensure it only tracks active, full-screen games.

Native Time Tracking: Calculates your play session duration directly on the ESP32. It uses Julian date math, meaning it perfectly handles sessions that roll over past midnight or into a new month.

Smooth Transitions: Utilizes the "loop" scroll mode and an is_finished flag to ensure the text smoothly exits the screen before transitioning to the next app, preventing any visual glitches or flickering.

🛠️ Prerequisites (xbl.io API Key)
Since the official Xbox API requires a complex OAuth 2.0 flow, this script uses xbl.io, a trusted proxy service that makes fetching Xbox Live data incredibly easy.

Go to xbl.io and log in with your Microsoft/Xbox account.

Navigate to Profile -> API Keys.

Generate a new API Key and copy it.

⚙️ Configuration
Once installed, go to Apps -> Settings (next to the script name) in your AWTRIX WebUI to configure:

apikey (text): Paste your xbl.io API key here. (Required)

every (number): Polling interval in minutes. Default is 2.

⚠️ Important: The free tier of xbl.io allows up to 150 requests per hour. An interval of 2 minutes uses 30 requests/hour, keeping you perfectly safe from rate limits.

speed (number): Text scrolling speed. Default is 200.

repeat (number): How many times the text scrolls before switching to the next app. Default is 2.

More flows for AWTRIX NG Scripts or Social

Something wrong with this flow? Report it.