android

# Home Assistant Companion for Android

[![Build Status](https://github.com/home-assistant/android/actions/workflows/onPush.yml/badge.svg)](https://github.com/home-assistant/android/actions/workflows/onPush.yml)
[![E2E Status](https://github.com/home-assistant/android/actions/workflows/e2e.yml/badge.svg)](https://github.com/home-assistant/android/actions/workflows/e2e.yml)
[![Play Store](https://img.shields.io/badge/Play%20Store-Download-blue?logo=google-play)](https://play.google.com/store/apps/details?id=io.homeassistant.companion.android)
[![Play Store Beta](https://img.shields.io/badge/Play%20Store%20Beta-Download-blue?logo=google-play)](https://play.google.com/apps/testing/io.homeassistant.companion.android)
[![Discord](https://img.shields.io/discord/330944238910963714?label=Discord&logo=discord)](https://discord.gg/c5DvZ4e)
[![Stars](https://img.shields.io/github/stars/home-assistant/android?style=social)](https://github.com/home-assistant/android/stargazers)

Welcome to the **Home Assistant Companion for Android**! This is the official Android app for [Home Assistant](https://www.home-assistant.io/), a powerful open-source home automation platform. Join us in building an app used by millions of users worldwide.

---

## Features

- **Control Your Smart Home**: Seamlessly interact with your Home Assistant instance.
- **Native Android Experience**: Leverage Android-specific features like widgets, notifications, and location tracking.
- **Customizable**: Tailor the app to your needs with themes, dashboards, and more.
- **Open Source**: Contribute to a project that empowers users to take control of their smart homes.

## Get the app

- **[Download from the Play Store](https://play.google.com/store/apps/details?id=io.homeassistant.companion.android)**
  Join the [Play Store Beta](https://play.google.com/apps/testing/io.homeassistant.companion.android) to test new features early.
- **Other Stores**: The app is also available in other app stores.

## Documentation

Looking for help? Check out the [Home Assistant Companion Documentation](https://companion.home-assistant.io/) for detailed guides on using the app.

## Report a bug or request a feature

Found a bug or have an idea for a new feature? Let us know!

- **[Open a Bug Report](https://github.com/home-assistant/android/issues/new?template=bug_report.yml)**
- **[Request a Feature](https://github.com/home-assistant/android/issues/new?template=feature_request.md)**

We appreciate your feedback and contributions to make the app even better!

## Contributing

We are thrilled to welcome contributions from the community! This app exists thanks to the incredible efforts of the Home Assistant community. Whether you're fixing bugs, adding new features, or improving documentation, your contributions make a difference.

Every contribution, big or small, is greatly appreciated. Together, we can make the Home Assistant Companion for Android even better!

### Getting started

1. Read the [Developer Guide](