ultimate-ban-tracker/README.md

Ultimate Ban Tracker

Ultimate Ban Tracker is a standalone desktop application for Windows and Linux designed to manage multiple Steam accounts and monitor ban statuses. It features an automated account switcher and an optional community-driven synchronization system for sharing account access and cooldown data.

Features

Account Management

• Credential-free Login: Switch between Steam accounts instantly. The application extracts and injects authentication tokens directly into local Steam configuration files, bypassing the need for manual credential entry or Steam Guard codes on every switch.
• Session Synchronization: Sync login states across multiple machines via the optional community server. Authenticate once, and the session is available to authorized community members.
• Auto-Discovery: Automatically detects and imports accounts currently logged into the local Steam client.

Monitoring and Tracking

• Cooldown Tracking: Scrapes Steam Personal Game Data (GCPD) to provide live countdowns for Counter-Strike competitive cooldowns.
• Distributed Scraping: Cooldown data is aggregated on the community server; only one active client is required to keep the status updated for all users tracking that account.
• Ban Detection: Real-time monitoring for VAC and developer game bans.

User Interface

• Dynamic Theming: Includes several built-in color schemes including Steam Classic, Catppuccin (Mocha/Latte), Nord, and Tokyo Night.
• Denisty-Focused Design: Compact list view allows for monitoring a large number of accounts simultaneously.

Installation

For Users

Download the latest pre-built installer for your operating system from the Releases page.

• Windows: Download the .exe installer.
• Linux: Download the .AppImage (portable) or .deb (Debian/Ubuntu) package.

For Developers

Local development requires Node.js v22 or higher and an active Steam installation.

1. Clone the repository.
2. Navigate to the frontend directory.
3. Install dependencies: npm install.
4. Start the development environment: npm run electron:dev.
5. To build production binaries: npm run electron:build.

Community Server

The backend server required for community features (sharing and sync) is hosted in a separate repository: Ultimate Ban Tracker Server

Security

• Encryption: All sensitive data, including Steam cookies and configuration blobs, are encrypted using AES-256-GCM before being synchronized with the backend.
• Local Storage: Account data is stored locally using electron-store. Usage of the community server is optional.
• Session Isolation: Steam authentication is performed in an isolated browser partition that is cleared after each session to prevent credential leakage.

License

ISC License. Created by Nils Pukropp.