ROOMGUARD-X
A real-time presence detection system that watches your room, recognizes when someone enters, and alerts you instantly — on your desktop and your phone.
// "DETECTION IS THE FIRST LINE OF DEFENSE."
Built like software that watches back.
Every module runs locally, in real time, with zero cloud dependency for the detection itself. Alerts route out to wherever you actually check your phone.
Real-time YOLOv8 detection
Identifies a person in any pose — standing, walking, waving — not just on motion. Runs entirely on your own machine.
Targeting-bracket HUD
A live interface with session stats, FPS, uptime, and a snapshot panel — styled like an actual detection console, not a webcam popup.
Dual-channel alerts
Native Windows toast notifications and Discord push alerts with the captured photo attached, the moment someone enters frame.
Continuous recording
Snapshots save automatically the entire time a person is visible — a running photographic log, not a single blurry frame.
Tray-native background mode
Runs invisibly with a custom system tray icon. Start, stop, and monitor status without a window ever open.
Dark / light, windowed / full
Toggle theme and display mode on the fly — built to sit comfortably on a desk or run fullscreen on a spare monitor.
Every detection, timestamped.
A running record of who's been seen, and when — logged locally, pushed to your phone in real time.
No shortcuts on the stack.
Computer vision, native OS integration, and a rendering pipeline built from scratch — packaged into a single standalone executable.
Up and running in under five minutes.
No installer wizard, no account, no cloud setup. Download, unzip, run.
Download the build
Go to the v1.0 release page on GitHub and download ROOMGUARD-X.zip.
Unzip it
Extract the folder anywhere on your PC — Desktop, Documents, wherever. Keep ROOMGUARD-X.exe and the _internal folder together in the same place.
Run it
Double-click ROOMGUARD-X.exe. If Windows SmartScreen shows a warning, click "More info" → "Run anyway" — this is expected for unsigned personal builds.
Connect your alerts (optional)
To get push notifications on your phone, set up a free Discord webhook and paste the URL into the app's settings.
Click Start
That's it. RoomGuard-X is watching. Press Q anytime to stop, or minimize to the system tray to keep it running in the background.
Your data stays yours. Literally.
No cloud backend. No central server. No account. Here's exactly where every piece of data goes.
Detection runs 100% locally
YOLOv8 processes your webcam feed entirely on your own machine. Nothing about your video feed is ever uploaded anywhere, by anyone, ever.
Alerts go to YOUR server only
Each install uses its own Discord webhook, configured by you in Settings and stored only in a local config.json on your PC. It is never hardcoded, never shared, and never sent to the developer.
No webhook, no problem
Discord alerts are entirely optional. Leave it unconfigured and RoomGuard-X still detects, records, and shows Windows notifications — just without the phone push.
Snapshots stay on disk
Captured photos and logs are saved to a local folder next to the app. They're only transmitted if — and only to where — you've configured your own webhook to send them.
Open source, verifiable
Every claim above is checkable in the source code on GitHub. Don't take our word for it — read it yourself.
No telemetry, no analytics
RoomGuard-X does not phone home, track usage, or collect any information about you or your device beyond what you explicitly configure.
Used it? Let people know.
Rate your experience and leave a comment below — visible to everyone who visits this page. Comments are powered by GitHub Discussions, so you'll need a free GitHub account to post.
Deploy it on your own machine.
Clone the repo, drop in your own Discord webhook, and RoomGuard-X is watching within minutes.