RetroHA

RetroHA is a lightweight and efficient dashboard for Home Assistant, specifically designed for legacy Android tablets intended to serve as wall-mounted home control panels.

Key Features

Bauhaus Canvas Engine: A custom graphics engine. The interface does not use standard Android XML views but is manually rendered on a Canvas. This ensures extreme fluidity even on decade-old devices.
Low-End Hardware Optimization: Minimal RAM usage, no unnecessary libraries, and aggressive caching of graphical layouts.
Bauhaus Design: A minimalist aesthetic inspired by the Bauhaus school—high contrast, geometric shapes, and maximum legibility.
Kiosk Mode: Built-in "Wake Lock" support to prevent the screen from turning off while the panel is active.
Rapid Control:
- Tile Click: Toggle or Execute.
- Light Long Press: Brightness menu with "slide and release" gesture (auto-save).

Libraries & Acknowledgments

This project utilizes the following Open Source libraries (compliant with F-Droid requirements):

Retrofit (Square Inc.) — Apache License 2.0: Type-safe HTTP client for Android and Java.
OkHttp (Square Inc.) — Apache License 2.0: An efficient HTTP client for Android.
Gson (Google) — Apache License 2.0: A Java library that can be used to convert Java Objects into their JSON representation.
MPAndroidChart (PhilJay) — Apache License 2.0: A powerful Android chart view / graph view library.
AndroidX Libraries (Google) — Apache License 2.0: Component libraries for Android.

Technical Requirements

Android: minSdk 14 (Support back to Android 4.0 ICS), optimized for Android 4.4+.
Home Assistant: Requires Server URL and a Long-Lived Access Token.

Roadmap

The current project status and planned features are detailed in TASKS.md.

License

This project is licensed under the GNU GPL v3. See the repository for details.

2.0 KiB Raw Blame History