AddressAlarm is an open-source Android app that helps anyone avoid risky, curious, or problematic addresses. The app runs entirely on-device, watching for locations through Android accessibility services and alerting you whenever a monitored app shows an address on your personal watchlist.
Originally designed with gig workers in mind, AddressAlarm now supports law enforcement, social workers, real estate agents, contractors, utility workers, and the public at large.
Latest build: https://github.com/TohnJravolta/AddressAlarm/releases/tag/v0.2.42
- Per-app monitoring controls let you choose exactly which navigation, gig, or messaging apps AddressAlarm watches.
- SQLCipher-backed storage keeps the watchlist encrypted with a key that only the device can unlock.
- Delete confirmations (single and bulk) prevent accidental data loss.
- The in-app support dialog links directly to the maintainer's Ko-fi for voluntary support.
- A first-run license screen bundles the full LICENSE text with a plain-language summary so acceptance is stored locally.
Watch the initial configuration walkthrough and live demo on YouTube. The video covers downloading the APK, granting accessibility permissions, enabling notifications, tuning alerts, and shows AddressAlarm catching a flagged location in real time so you can follow along from a fresh install.
- On-device matching: no data or addresses ever leave your phone.
- Custom flags and tags: note why a location matters so you can act with context.
- Safety-first alerts: debounced overlays and gig-app warnings reduce noise without hiding risk.
- Import and export: back up your data or move it between devices.
- Android Studio (latest stable)
- JDK 17 or newer
- Gradle (bundled with Android Studio)
- Clone the repository:
git clone https://github.com/TohnJravolta/AddressAlarm.git cd AddressAlarm - Open the project in Android Studio and let Gradle sync.
- Build and run on an Android device or emulator.
See the docs/ directory for more help:
- Overview - Project background and audience.
- Installation - Sideloading and accessibility walkthroughs for popular devices.
- No auto-decline or accept: you always decide what happens next.
- No server logging: everything remains local to the device.
- Assistive only: AddressAlarm surfaces reminders; it never acts on your behalf.
See ROADMAP.md for upcoming milestones and planned enhancements.
Review CONTRIBUTING.md for contribution guidelines, coding standards, and the pull-request process. Need help? Visit SUPPORT.md for support options, including responsible disclosure steps.
Licensed under the GNU AGPL-3.0.
Copyright (C) 2025 TohnJravolta and AddressAlarm contributors.
See the LICENSE file for details.
