Skip to content

An Ecologi sensor for Home Assistant

License

Notifications You must be signed in to change notification settings

owenvoke/hass-ecologi

Repository files navigation

HASS Ecologi

Latest Version Software License Build Status Buy us a tree

An Ecologi sensor for Home Assistant

Install

Via HACS

  1. Install the Home Assistant Community Store (HACS)
  2. Add Ecologi as a custom repository. See the HACS FAQs and add https://github.com/owenvoke/hass-ecologi
  3. Select integration as the category
  4. You should now be able to install Ecologi via HACS
  5. Once installation is complete, restart Home Assistant
  6. In the HA UI, go to Configuration -> Integrations, click + and search for Ecologi

Manual

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml)
  2. If you do not have a custom_components directory there, you need to create it
  3. Add the ecologi directory and its contents from this repository to the custom_components directory in your Home Assistant configuration directory
  4. Restart Home Assistant
  5. In the HA UI, go to Configuration -> Integrations, click + and search for Ecologi

Dependencies

This component relies on my ecologi-sdk Python package, an unofficial client for the Ecologi API.

Usage

This can be configured fully via the Integrations interface. Click the following link to add a new Ecologi user.

Add Integration

The "Scan interval" can also be configured, this defaults to polling the API every 5 minutes.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.

Treeware

You're free to use this package, but if it makes it to your production environment please consider buying the world a tree.

It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to plant trees. If you support this package and contribute to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

You can buy trees here.

Read more about Treeware at treeware.earth.