Visualize deadlocks, monitor sessions, and use overlays/HUDs
- Download the latest release from the link above
- Extract the archive (WinRAR / 7-Zip)
- Run
python main.py(or see Usage below) - Configure settings in
config.yaml
- Python 3.11 or higher.
- These packages:
PyYAML
Pillow
PyAutoGUI
psutil
pystray
keyboard
You can install them using pip: pip install -r requirements.txt
Configuion is done via config.yaml. Here's an example:
monitor:
refresh_interval: 0.5 # seconds
process_name: "target.exe"
overlay:
enabled: true
color: "red"
thickness: 2
position:
x: 100
y: 100
input:
hotkey_toggle_overlay: "ctrl+shift+o"
hotkey_exit: "ctrl+shift+q"
pixel_detection:
enabled: true
coordinates:
- { x: 50, y: 50, color: "(255, 0, 0)" }
- { x: 100, y: 100, color: "(0, 255, 0)" }
paths:
log_file: "logs/application.log"
data_directory: "data/"Feel free to tweak these values.
- Make sure you've installed the requirements.
- Modify
config.yamlto your liking. - Run
python main.py. - The app will start monitoring and display overlay based on your configuion.
- Screen analysis: Analyzes screen content for specific patterns or colors.
- Overlay: Displays custom graphics on top of other applications.
- Crosshair: Adds a customizable crosshair to the screen.
- Pixel detection: Detects specific pixel colors at defined coordinates.
- Hotkey automation: Automates actions based on hotkey presses.
- Configuion: Configurable behavior via YAML file.
- Overlay not showing up? Double-check that
overlay.enabledis set totruein yourconfig.yaml. Also, ensure that the target application isn't running in elevated mode (as administor). - Hotkeys not working? Make sure no other applications are using the same hotkeys. Try changing the hotkeys in
config.yaml. - App crashing? Check the logs in the
logs/directory (if enabled) for any error messages.
Can I use this with multiple games?
Yes, just change theprocess_name in config.yaml to the executable name of the game you want to monitor.
How do I change the overlay color?
Edit thecolor field under the overlay section in config.yaml. You can use standard color names like "red", "blue", or hex codes like "#FF0000".
Is there a way to disable the overlay temporarily?
Yes, you can use the hotkey defined byhotkey_toggle_overlay in the config.
💪 Community-driven development