xbox_monitor

Powerful tool for real-time monitoring of Xbox Live players' activities.

🚀 Quick Install & Run

New to Python or unsure what is installed? Follow the Python install walkthrough first.

Install from PyPI:

pip install xbox_monitor

Run the setup wizard:

xbox_monitor --setup

The wizard asks for the target, the Microsoft Entra application credentials and optional notifications. Review the settings before saving them. See Setup & First Run for the application credentials, the first authorization and the required privacy settings.

For the manual single-file method, dependencies and upgrade commands, see Installation.

Features

🔍 Activity Tracking

• Gaming activity: Track status, game starts, finishes and changes.
• Appear Offline: Detect gaming activity from title history when presence is hidden.
• Session statistics: Measure state and game durations, preserving statistics through short offline interruptions.

📊 Profile Insights

• Profile details: View XUID, status, platform, account tier, gamerscore and friends.
• Games and achievements: See recent games, playtime and earned achievements.

🔔 Notifications and History

• Event alerts: Configure email, Discord and ntfy notifications independently.
• CSV history: Save reported activity with timestamps.
• Saved status: Retain monitoring state across restarts.

⚙️ Setup and Configuration

• Guided setup: Configure credentials and complete OAuth2 authorization with --setup.
• Preflight checks: Check readiness with --doctor without writing files.
• Flexible settings: Use config files, dotenv files, environment variables and command-line options.
• Terminal and runtime controls: Customize colours and adjust the running monitor through supported signals.