Files
ultimate-ban-tracker/README.md
2026-02-21 05:15:07 +01:00

3.1 KiB

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, stealth cooldown tracking, and an optional community-driven synchronization system.

Features

Account Management

  • One-Click Switching: Switch between Steam accounts instantly. The application manages authentication tokens and registry keys directly, bypassing the need for manual login or Steam Guard codes.
  • Session Synchronization: Optional cross-machine sync via a dedicated backend. Authenticate once, and the encrypted session is available to authorized community members.
  • Auto-Discovery: Detects and imports local Steam accounts automatically.
  • Isolated Sessions: Uses per-account browser partitions to prevent session leakage during authentication.

Monitoring and Tracking

  • Cooldown Tracking: Automated scraping of Steam Personal Game Data (GCPD) for live Counter-Strike competitive cooldown countdowns.
  • Stealth Sync: Uses randomized intervals and non-blocking background workers to avoid Steam web detection.
  • Ban Status: Real-time monitoring for VAC and developer game bans with high-signal indicators.

Desktop Integration

  • System Tray: Persistent tray icon for quick account switching and synchronization without opening the main window.
  • Minimize-to-Tray: The application runs in the background to ensure continuous ban monitoring and data freshness.
  • Dynamic Theming: Support for Steam Classic, Catppuccin (Mocha/Latte), Nord, and Tokyo Night. App icons automatically adapt to match the selected theme.

Installation

For Users

The recommended way to use Ultimate Ban Tracker is to download a pre-built installer from the Releases page.

  • Windows: .exe (NSIS Installer)
  • Linux: .AppImage (Portable) or .deb (Ubuntu/Debian)

Arch Linux (makepkg)

For Arch-based distributions, a PKGBUILD is provided in the repository root.

git clone https://git.narl.io/nvrl/ultimate-ban-tracker.git
cd ultimate-ban-tracker
makepkg -si

For Developers

Requires Node.js v22+ and an active Steam installation.

  1. cd frontend && npm install
  2. npm run electron:dev (Development mode)
  3. npm run electron:build (Production packaging)

Community Server

Backend functionality for sharing and synchronization is optional and hosted separately: Ultimate Ban Tracker Server

Security

  • AES-256-GCM Encryption: All sensitive credentials (cookies and config blobs) are encrypted before being synced to the community server.
  • Local-First Storage: Data is stored locally using electron-store. Usage of the community server is strictly optional.
  • Atomic Operations: VDF file updates use atomic write strategies to prevent Steam configuration corruption.

License

Personal Use and Non-Commercial License. Created by Nils Pukropp. See LICENSE file for details.