Real-time VALORANT match tracker — ranks, stats, and encounter history for all 10 players, live.
Written in Rust · No account login · No API keys · Reads only from 127.0.0.1
| 🎮 Live match table | All 10 players — rank, RR, peak rank, HS%, K/D, WR%, party grouping — refreshed every 30 s |
| 👁 Encounter tracking | Click any player to see every previous match you've shared with them |
| 💾 Match history | Save matches to a local SQLite database and browse them any time |
| 🎉 Party detection | Premade groups highlighted with icons (★ ▲ ● ■); enemy premades tinted red |
| 🕵️ Streamer mode | Incognito players shown with an [S] tag |
| 🖥 Desktop GUI | Native egui window with side panels, settings modal, and minimize-to-tray |
| 💻 Terminal UI | Full-featured ratatui TUI — works over SSH, no GPU required |
| 🔔 Toast notifications | Desktop popups for match detection and update completion |
| 🎮 Discord Rich Presence | Map, mode, party size, and elapsed time shown in Discord |
| 🔄 Auto-updater | Silent background check on startup; installs new versions in-place |
| 🚀 Run on startup | Optionally launch hidden in the system tray at Windows login |
| 🐍 Python bindings | pip install valotracker — full engine exposed via PyO3 |
Download ValoTracker-Setup-x.x.x.exe from the
latest release and run it.
The wizard installs the TUI, GUI, or both — with optional desktop and Start Menu shortcuts.
Download ValoTracker-x.x.x-x86_64.msi from the
latest release.
- Per-user install, no UAC prompt required
- Supports silent deployment:
msiexec /i ValoTracker.msi /qn
Grab a standalone .exe directly from the
latest release — no install needed, just drop it anywhere on your PATH.
| File | Description |
|---|---|
ValoTracker.exe |
Terminal UI |
ValoTracker-gui.exe |
Desktop GUI |
scoop bucket add valotracker https://github.com/Londopy/ValoTracker
scoop install valotrackerScoop handles updates automatically (scoop update valotracker).
pip install valotracker
valotracker # TUI
valotracker-gui # GUIThe wheel bundles pre-compiled Windows binaries — no Rust toolchain required.
git clone https://github.com/Londopy/ValoTracker.git
cd ValoTracker
# TUI
cargo build --release -p valotracker-tui
# → target\release\ValoTracker.exe
# GUI
cargo build --release -p valotracker-gui --features gui
# → target\release\ValoTracker-gui.exe
# MSI (requires cargo-wix and WiX Toolset v3)
cargo install cargo-wix
cargo wix -p valotracker-installer --no-build --nocaptureRequirements: Rust 1.78+, Windows 10/11, VALORANT installed.
ValoTracker.exe
| Key | Action |
|---|---|
r |
Force refresh |
s |
Save current match to history |
h |
Open match history |
c |
Open config editor |
j / k or ↑ / ↓ |
Navigate player rows |
Enter / Tab |
Open encounter history for selected player |
q / Esc |
Quit |
ValoTracker-gui.exe
- Click any player with a 👁 icon to open their encounter history side panel
- Use the ⚙ Settings button to configure tray behaviour and startup options
- The window minimizes to the system tray when closed (if enabled in Settings)
pip install valotrackerimport valotracker
client = valotracker.ValoTrackerClient()
client.wait_for_match() # blocks until a match is detected
for p in client.get_players():
print(f"{p.name}#{p.tag} {p.rank_name} {p.rr}RR HS:{p.headshot_pct:.0%}")Config is stored at %APPDATA%\ValoTracker\config.toml and created automatically on first run.
[display]
show_streamer_tag = true
show_party_size = true
highlight_enemy_parties = true
short_ranks = false
show_level = true
show_kd = true
show_hs = true
show_wr = true
show_rr_delta = true
[features]
minimize_to_tray = false # GUI: minimize to tray on close instead of quitting
run_on_startup = false # Add ValoTracker to Windows startup (hidden in tray)
check_updates = true # Silent background update check (once per 24 h)
notifications = true # Windows desktop toast notifications
discord_rpc = false # Discord Rich Presence
discord_app_id = "" # Leave blank to use the bundled app IDPress [c] in the TUI to edit display settings live without touching the file.
ValoTracker is fully open source — every line of code is auditable in this repository.
- Connects only to
127.0.0.1(the local Riot client); no data leaves your machine - Release binaries are scanned by VirusTotal before publishing
- SHA-256 checksums for every artifact are included in each GitHub release
ValoTracker/
├── crates/
│ ├── valotracker-core/ # Engine: API, history, updater, Discord, notifications
│ ├── valotracker-tui/ # ratatui terminal frontend
│ ├── valotracker-gui/ # egui desktop GUI (--features gui)
│ │ └── src/views/ # Modular view files (match, history, encounter…)
│ ├── valotracker-py/ # PyO3 Python bindings → PyPI wheel
│ └── valotracker-installer/ # cargo-wix MSI target
├── installer/
│ └── ValoTracker.iss # Inno Setup script (per-user, no UAC)
├── scoop/
│ └── valotracker.json # Scoop manifest with autoupdate
├── python/ # Python package source (pip install valotracker)
└── .github/
└── workflows/release.yml # CI: build → MSI → wheel → PyPI → GitHub release
ValoTracker reads data from VALORANT's local client endpoints (https://127.0.0.1:{port})
using credentials stored on your own machine. It does not bypass any external API, inject
into the game process, or violate Riot's Terms of Service as interpreted for read-only local
tooling.
Use at your own risk. The authors are not affiliated with Riot Games.
See DISCLAIMER.md.
See CONTRIBUTING.md. PRs welcome!
Please run before submitting:
cargo fmt --all
cargo clippy --workspace -- -D warnings
cargo test --workspaceMIT — see LICENSE.