nvrl/ultimate-ban-tracker
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases 6 Wiki Activity

init
Some checks failed
Build and Release / build (push) Has been cancelled
Details

Browse Source
This commit is contained in:
Nils Pukropp
2026-02-21 01:48:48 +01:00
commit 64fe49e58e
47 changed files with 13695 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

47
README.md Normal file
View File

@@ -0,0 +1,47 @@
# 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](https://git.narl.io/nvrl/ultimate-ban-tracker/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](https://git.narl.io/nvrl/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.