Skip to content

Latest commit

ย 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

RAT VISION โ€” XRAT Visual Systems, Level Black

๐Ÿ€ RAT VISION

๐Ÿ‘๏ธ See what the rat sees.
๐ŸŽฎ Automatic per-game display color profiles for Windows โ€” gamma, brightness, contrast and NVIDIA Digital Vibrance.

RAT VISION automatically applies the display colors you want when a configured game or application becomes active, then restores your desktop profile after Alt-Tab or exit.

๐Ÿงช Public beta โ€” Windows/NVIDIA hardware feedback welcome.

Windows 10/11 Public beta License LGPL-2.1 Windows CI

๐Ÿš€ Download

XRAT DISTRIBUTION NODE // PUBLIC BETA
WINDOWS 10/11 ยท VERSION 1.2.0-beta.1 ยท SHA-256 VERIFIED

๐ŸชŸ Windows Installer โ€” recommended

Creates Start Menu and uninstall entries and gives the updater a stable installation path.

๐Ÿ“ฆ Portable

Unzip anywhere and run RAT VISION.exe โ€” no installation required.

๐Ÿ›ก๏ธ Display utility only โ€” no injection, no memory access, no game modification.

๐Ÿ–ฅ๏ธ RAT VISION in action

RAT VISION Level Black

โœจ Features

VISUAL SYSTEMS // CAPABILITY INDEX
FOREGROUND DETECTION ยท PROFILE AUTOMATION ยท MULTI-MONITOR CONTROL

  • ๐Ÿ€ Per-game/app profiles with instant ON/OFF toggles
  • ๐ŸŒ Global fallback profile for the desktop and unconfigured apps
  • โ˜€๏ธ Brightness, โ— Contrast, ๐ŸŒ— Gamma, ๐ŸŽจ NVIDIA Digital Vibrance
  • ๐Ÿ–ฅ๏ธ Multi-monitor targeting and Windows friendly monitor names
  • ๐ŸŽฏ Multiple executable triggers per profile
  • ๐Ÿงช Copy visual settings between profiles
  • ๐Ÿ“Œ Always-on-top window option
  • ๐ŸŒ™ Level Black + โ˜€๏ธ Clean Lab themes
  • โ” Guided tutorial tour + contextual tooltips
  • ๐Ÿ€ Tray mode with fast global XRAT toggle
  • ๐Ÿ”„ GitHub release updater
  • ๐Ÿ“Š Pseudonymous usage analytics โ€” enabled by default in configured builds and easy to turn off

๐ŸŽฏ Typical usage

Dark shooters often need a different gamma or color setup than the desktop. RAT VISION enables a brighter or differently corrected profile when the game becomes active, then restores your Global/desktop profile when you Alt-Tab or exit.

It also works as general per-application color correction for games, creative tools, video players and other Windows apps.

โ˜• Support

Support the lab โ€” Buy me a coffee

If RAT VISION saves you time tweaking gamma every time you launch a shooter, click the panel above or use the in-app โ˜• Buy me a coffee button. Your support keeps XRAT development, hardware testing and public releases moving.

๐Ÿงช How it works

  1. ๐Ÿ‘๏ธ Observe foreground-window changes through Win32.
  2. ๐ŸŽฏ Match the executable name to an enabled profile.
  3. ๐Ÿ–ฅ๏ธ Apply Windows gamma ramp to selected displays.
  4. ๐ŸŽจ Apply NVIDIA Digital Vibrance through NVAPI when available.
  5. ๐ŸŒ Return to Global or normal colors when the application loses focus.

๐Ÿ›ก๏ธ NOT A CHEAT

XRAT LABS // SECURITY CLASSIFICATION: DISPLAY UTILITY
PROCESS OBSERVATION ยท DISPLAY OUTPUT CONTROL ยท NO GAME INJECTION

RAT VISION changes what your monitor displays โ€” not what the game renders.

RAT VISION is a display-output utility. It detects which configured application is in the foreground and applies your chosen monitor color profile. It does not inject code, does not read or write game memory, does not modify game files, does not automate mouse/keyboard input, and does not interact with anti-cheat systems.

โœ… RAT VISION does โŒ RAT VISION does not
๐Ÿ–ฅ๏ธ Change Windows gamma ramp Inject DLLs/code
๐ŸŽจ Change NVIDIA Digital Vibrance Read/write game memory
๐Ÿ‘๏ธ Observe the foreground executable name Modify game files
๐ŸŽฎ Select a profile for that app Automate input
๐ŸŒ— Restore desktop colors after Alt-Tab Interact with anti-cheat

๐Ÿ“ฆ Installer vs Portable

๐ŸชŸ Installer ๐Ÿ“ฆ Portable
Admin required No No
Start Menu entry โœ… โ€”
Uninstaller โœ… โ€”
Easy updater path โœ… โœ…
Move folder freely โ€” โœ…
Profiles/settings %APPDATA%\RAT VISION %APPDATA%\RAT VISION

๐ŸŽฎ Per-game profiles

Create a profile, select one or more .exe files, choose monitors, then set the visual parameters. When a configured executable receives focus, RAT VISION applies that profile.

๐ŸŒ Global Profile

The Global Profile is process-independent. It is used when no enabled application-specific profile matches. Its ON/OFF switch disables only the Global fallback; the top-level XRAT TRACING switch disables all automatic color management.

๐Ÿ–ฅ๏ธ Multi-monitor

Profiles can target one or more monitors independently. RAT VISION prefers Windows DisplayConfig/EDID friendly names and keeps the technical \\.\DISPLAYx identifier for diagnostics.

๐Ÿ”„ Updates

RAT VISION checks public GitHub Releases. Updates are never installed silently: the app discovers a newer eligible release, downloads the matching Installer/Portable asset, verifies SHA-256, then asks you to apply it.

See docs/UPDATE_PROTOCOL.md.

๐Ÿ“Š Pseudonymous usage analytics

TELEMETRY PROTOCOL // USER CONTROLLED
PSEUDONYMOUS ยท MINIMAL EVENTS ยท SETTINGS OPT-OUT

๐Ÿ“Š Pseudonymous usage analytics are enabled by default in configured builds, and you can turn it off at any time in Settings. RAT VISION uses TelemetryDeck to measure retention and version adoption. Unconfigured builds send no analytics.

The random installation UUID is SHA-256 hashed locally before transmission. No executable names, game/profile names, file paths, usernames, serial numbers or foreground history are collected. See docs/ANALYTICS.md.

GitHub itself provides Release Asset download counts plus recent repository traffic/referrers.

๐Ÿ›ก๏ธ Security & VirusTotal

Every public release publishes SHA256SUMS.txt. The Installer EXE, Portable RAT VISION.exe and Portable ZIP must each be scanned separately with VirusTotal. Never copy VirusTotal links from another build. Real URLs will be added only after scanning the exact published artifacts.

See SECURITY.md for responsible disclosure guidance.

๐Ÿ“ธ More interface views

OBSERVATION ARCHIVE // INTERFACE CAPTURES
CLEAN LAB ยท GUIDED PROTOCOL

โ˜€๏ธ Clean Lab

RAT VISION Clean Lab

โ” Guided tour

RAT VISION tutorial tour

โš™๏ธ Installation

Installer

Run RAT-VISION-Setup-vX.Y.Z.exe. The default per-user location is %LOCALAPPDATA%\Programs\RAT VISION.

Portable

Extract RAT-VISION-Portable-vX.Y.Z.zip and run RAT VISION.exe.

๐Ÿงฐ Beta verification checklist

For hardware feedback, verify these concrete scenarios: Global OFF restore, Alt-Tab restore/reapply, two-monitor independent restore, NVIDIA saturation, tray OFF/ON lamp, and exit restore. Include diagnostics plus Windows/GPU/monitor details in bug reports.

โšก Everyday UX details

  • Quick ON/OFF toggles are available directly beside each profile.
  • Contextual tooltips explain controls and the Global profile behavior.
  • The built-in Tutorial Tour provides guided onboarding with draggable help cards.
  • ๐Ÿ“Œ Always on top is available in the header beside Day/Night.
  • Display rows show the system-reported monitor name plus technical DISPLAYx identity when available.
  • The remaining working Settings toggles are Launch with Windows, Start minimized to tray, and Closing the window minimizes to tray.

๐Ÿง‘โ€๐Ÿ’ป Build from source

On Windows run:

scripts\build-windows.bat

The one-click builder downloads a private CPython 3.13 x64 runtime with Tcl/Tk, installs build dependencies, runs tests, and creates dist\RAT VISION\RAT VISION.exe.

For a complete release build with Inno Setup installed:

.\release\build-release.ps1 -Version 1.2.0-beta.1

๐Ÿงช Simulation / development workflow

RAT VISION v1.2.0-beta.1 can be launched without touching real display hardware:

python -m ratvision --simulate

The Windows one-click build is self-contained: system Python is not required. scripts\build-windows.bat installs a private CPython 3.13 x64 runtime with Tcl/Tk into the project build directory.

๐ŸŽฏ Built-in starter profiles

The first run includes starter profiles for Escape from Tarkov, Escape from Tarkov: Arena, and Hunt: Showdown. They are ordinary editable profile presets, not game modifications.

The one-click Windows builder downloads the official CPython 3.13.15 x64 installer from python.org, verifies its SHA-256, and installs it privately for the build.

The private runtime is installed with Tcl/Tk enabled so the Tkinter UI builds and runs consistently.

๐Ÿ—บ๏ธ Roadmap

  • ๐Ÿงช Broaden Windows/NVIDIA hardware testing during public beta
  • ๐Ÿ–ฅ๏ธ Improve display/GPU compatibility diagnostics
  • ๐Ÿ”„ Harden self-update based on real published releases
  • ๐Ÿ“Š Improve pseudonymous retention metrics while keeping telemetry transparent and easy to disable

๐Ÿ“œ Licenses

See LICENSES.md for third-party and reused-code license notices.

About

๐Ÿ€ Automatic per-game gamma & color profiles for Windows. Brightness โ€ข Contrast โ€ข Gamma โ€ข NVIDIA Digital Vibrance. No injection โ€” just display output.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages