Skip to content

tstromberg/observer-effect

Repository files navigation

The Observer Effect

Auto-unlock and auto-open when movement is detected.

Configures your Android device to automatically unlock and optionally open an application when it detects your presence using the camera and ambient light sensors.

While initially designed for an Android-based home security system, it's also perfect for Home Assistant, Calendars, and Public Transit schedules. No more tapping the screen—just walk up and it's ready. This app is similar in concept to Yakk, but I didn't know it existed when I started hacking on this. In comparison, TOE is open-source, with support for more sensors and different customization options. TOE does not record video or store data other than your configuration data. TOE does not require any network access.

Screenshots

Tablet View (light mode)

Mobile View (dark mode)

Features

  • Camera motion detection with adjustable sensitivity
  • Ambient light sensor for detecting lighting changes
  • Auto-unlock screen and launch your dashboard app
  • Automatic keyguard dismissal (works with swipe-to-unlock and no security)
  • Configurable notification sound on wake
  • Start at boot for set-and-forget operation
  • Clean, simple UI with tablet layouts
  • Full accessibility support with TalkBack

Permissions

On first launch, the app will request the following permissions:

  • Camera - For motion detection
  • Display over other apps (SYSTEM_ALERT_WINDOW) - Required to reliably launch apps from background on Android 10+
  • Battery optimization exemption - For reliable background operation

These permissions are essential for the app to function properly.

Building

You are probably best off using Android Studio, but we have make targets too:

make              # Build debug APK → out/heisenberg-debug.apk
make release      # Build release APK → out/heisenberg-release.apk
make sideload     # Install via adb

Requirements: Android 8.0+, JDK 17+

License

Apache 2.0

About

#android app to enable & unlock the screen when motion is detected #home #automation

Resources

License

Stars

Watchers

Forks

Packages

No packages published