Skip to content
This repository has been archived by the owner on Aug 7, 2020. It is now read-only.

Maxr1998/home-assistant-Android

Repository files navigation

HassDroid - a Home Assistant Client for Android

Platform Android CircleCI GitHub issues Crowdin License GPLv3

PROJECT STATUS

This project has been inactive for quite some time now, and was de-facto already abandoned for a few months. Too many changes to the Home Assistant software, the API and finally the introduction of the custom "Lovelace" UI made supporting this app again more and more unlikely. Since there's an official Android app now, which wraps the web client, there's also no real need for this project anymore.

Downloads

Get it on F-Droid

Getting Started

Build in terminal with ./gradlew assembleRelease or import into Android Studio and build there (recommended).

Dependencies

Model & UI

  • Android support libraries: Used for a lot of classes, views, etc.
  • Ason: A really awesome JSON library building on top of Android's integrated JSON classes.
  • Google Play services: Used for acquiring your location for the device_tracker feature and configuring the Wearable app.
  • Mapzen Lost: alternative location provider used in the F-Droid builds, replacing Google Play services.
  • JetBrains' Kotlin build tools and stdlib

Networking

  • OkHttp: Used for WebSocket integration in an elegant and fast way.

App signature

The official releases are signed with my personal keys, but gradle will use debug keys if the signing config/keys aren't found.

Contributing

See CONTRIBUTING.md

LICENSE

GPLv3

Credits

The format and some content of this README.md comes from the home-assistant-iOS repository.