obskeyhold.py

Description

obskeyhold.py is a Windows-only helper tool designed for streamers who use OBS Studio while playing games such as Rust, DayZ, or other open-world titles where showing the in-game map could reveal their position to viewers. When you hold down certain keys in-game, OBS can automatically toggle overlays or sources (like hiding a map capture). This script automates that key press/release behavior, using Python to send **virtual key events (F13–F24) — keys that OBS can detect as hotkeys without interfering with your normal gameplay.

Core Features:
- Hold-to-toggle behavior for hiding in-game maps.
- Lightweight and simple to run — no setup tools or extra dependencies required.
- Designed specifically for Windows 10/11 (x64).
- Easy customization through the `config/variables.py` file.

Use case example:
> You hold `G` to open your in-game map — OBS automatically hides your map overlay so viewers can’t see your location. When you release `G`, the map reappears in your stream.