README.md
obskeyhold.py is een Windows-only utility CLI-tool ontworpen voor streamers die OBS Studio gebruiken tijdens het spelen van open-world games zoals Rust of DayZ, waarbij het tonen van de in-game map op stream de locatie van de speler aan kijkers kan verraden.
Het project werd ontwikkeld als persoonlijk real-world utility project nadat een streamer tegen een praktisch probleem aanliep tijdens het streamen van Rust: er was geen eenvoudige tool beschikbaar om automatisch map-gerelateerde OBS-sources alleen te verbergen terwijl een in-game maptoets werd ingedrukt. De tool lost dit op door te detecteren wanneer specifieke toetsen worden ingedrukt en virtuele functietoetsen van F13 tot F24 te verzenden, die veilig als OBS-hotkeys gebruikt kunnen worden zonder normale gameplaybesturing te verstoren.
Een typisch gebruiksvoorbeeld is het ingedrukt houden van een toets zoals G om een in-game map te openen. Terwijl die toets wordt ingedrukt, stuurt obskeyhold.py een virtuele hotkey naar OBS zodat een geselecteerde source of overlay verborgen kan worden. Wanneer de toets wordt losgelaten, wordt een ander event verzonden zodat de map-overlay opnieuw zichtbaar kan worden. Hierdoor ontstaat een eenvoudige maar nuttige automation workflow voor streamprivacy en viewer-safe gameplay.
Het project werd zelfstandig ontwikkeld in Python met behulp van de keyboard package en wordt geconfigureerd via een eenvoudig variables-bestand. De tool werkt via de CLI en bevat README-documentatie zodat andere streamers de tool kunnen configureren en gebruiken binnen hun eigen OBS-setup.
Dit project was één van mijn eerste Python utilities die werd gebouwd om een echt probleem voor iemand anders op te lossen. Het bood praktische ervaring met desktop automation, keyboard event handling, OBS workflow-integratie, Windows-specifieke scripting en het bouwen van kleine publieke tools met duidelijke gebruiksinstructies.
De tool is momenteel functioneel, maar wordt niet actief onderhouden. Mogelijke toekomstige verbeteringen zijn Linux-ondersteuning, sterkere security-overwegingen en een flexibeler configuratiesysteem.
Gebouwd met Python, keyboard automation, OBS hotkey workflows, Windows scripting en CLI-tooling.
