DormGuard

Student dorm security device (or maybe any other place too)

Android app for DormGuard. This repo contains the software.

Building the APK

Requirements

• Android SDK 35+ (or Android Studio)
• Java 11+
• Git

Build with Android Studio

1. Clone the repo and open it in Android Studio
2. Wait for Gradle sync
3. Connect an Android device or use an emulator
4. Click Run to build and install

Build from command line

git clone https://github.com/rynekryz/dormguard.git
cd dormguard
./gradlew build

APK location: app/build/outputs/apk/debug/app-debug.apk

Screenshots

Features

• Real-time door status monitoring via ESP32 --> App
• Push alert when door left open too long
• Remote alert disable button from the app (Anytime, anywhere)
• Alert stop until door reopened again if stopped from app
• Auto alert timeout after 20s if not manually stopped
• PIR motion-triggered auto lamp control
• Remote lamp enable/disable toggle
• NeoPixel LED strip visual alert indicator (blink blink) and can also become a lamp
• Buzzer beep beep Beep BEEP alert (can be enable/disable via in app switch)
• LED alert indicator (can be enable/disable via app too)
• Door open/close events logged to Google Sheets (free database lol)
• Alert state synced between ESP and app via Google Apps Script
• Vibration notification on alert trigger
• Vibration toggle in settings
• Logs list with timestamp and date
• Last opened time display
• Full and latest 50 records CSV export
• Google Sheets database link viewer
• Dark mode and light mode support
• High contrast mode
• Reduce motion toggle (some people hate animation)
• Material design 3 Expressive
• etc.

License

Licensed under GPL-3.0. See LICENSE for details.

Made with ♥︎ by Ryne