[BETA] AlarmoGuard — Native Android (IOS soon) client for Home Assistant Alarmo

Share your Projects!
1

[BETA] AlarmoGuard — Native Android (IOS soon) client for Home Assistant Alarmo

Hey everyone,

I’m excited to share the first beta of AlarmoGuard — a lightweight, native Android app (Kotlin + Jetpack Compose) built specifically for monitoring and controlling your Home Assistant Alarmo setup.

This beta focuses on reliability, instant status feedback, and a frictionless alarm UX on Android, including proper notifications, fullscreen alerting, and a PIN keypad.

Note: This beta is Android-only for now. An iOS version is planned for a future release.

Highlights

  • Real-time monitoring: Persistent WebSocket connection to Home Assistant /api/websocket with reconnection.
  • Action chips: Disarm / Arm Home / Away / Night / Vacation (configurable visibility).
  • Fullscreen alarm flow: Attention-grabbing activity on pending/triggered with Mute/Disarm actions and fallback alarm sound + vibration.
  • Notifications: Dedicated channels for monitor (low) and alarm (high with DnD bypass if allowed).
  • Setup wizard: Validates base URL, token, and Alarmo entity before you start.
  • Theming: Light/Dark with gradient tokens and customizable keypad/chip colors.
  • Security: Optional settings lock (salted SHA-256).
  • Modern Android: Foreground service, explicit package broadcasts, overlay option (if permitted).

Requirements

  • Home Assistant with the Alarmo integration.
  • Android 10+ (API 29+).
  • Long-Lived Access Token for Home Assistant.
  • Your Alarmo entity id (e.g., alarm_control_panel.alarmo).

Availability

  • Android: Available via the beta APK below.
  • iOS: Planned for a later release (TestFlight invites to follow).

Download (Beta APK)

Note: Sideloading is required. Enable installation from unknown sources on your device if prompted.

Quick Start

  1. Install the APK and open AlarmoGuard.
  2. Enter:
    • Base URL (must start with http:// or https://)
    • Long-Lived Access Token
    • Alarm entity id (e.g., alarm_control_panel.alarmo)
  3. The app performs a connection check and initial state read.
  4. On success, you land on the Front Screen with status + action chips.

Screenshots

Front Screen
Front Screen1080×2412 108 KB

Privacy & Security

  • The app connects only to your Home Assistant instance.
  • Uses a Long-Lived Access Token you provide; store it like a password.
  • Preferences are stored locally on-device via Android SharedPreferences.
  • Fullscreen intents follow Android 14+ policies; fallback sound/vibration ensures user feedback.

Known Limitations (Beta)

  • UI uses Material 3; some components may receive refinements.
  • Progress and divider components are being modernized across Compose APIs.
  • No i18n in this beta (English UI only).

Roadmap

  • Improved error surfaces and connection diagnostics.
  • Optional haptic feedback patterns per action.
  • More theme presets and export/import.
  • Optional code entry prompts for arming/disarming flows.

Feedback

Please share issues, ideas, and device-specific behaviors in the comments. If you prefer GitHub issues, use: GitHub Link Soon

Changelog

  • v0.1.0-beta
    • Initial public beta with setup wizard, WebSocket monitor, fullscreen alarm flow, notifications, and theming.

Thanks for trying AlarmoGuard! :raised_hands: