55 lines
3.1 KiB
Markdown
55 lines
3.1 KiB
Markdown
# 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.
|