# 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](https://git.narl.io/nvrl/ultimate-ban-tracker/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.
```bash
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](https://git.narl.io/nvrl/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.