Skip to content

Commit 02a1ab4

Browse files
authored
feat: transition behaviours and friendly name fix
BREAKING CHANGE: The friendly name fix in #153 may break your configuration. Entities will be created based on the YAML section name but will respect friendly name in frontend. Note: #156 is the actual release ppull request if you want to check changes. I accidentally merged the PR before filling in all this Commit text information 😞
1 parent cce7cbc commit 02a1ab4

File tree

1 file changed

+11
-12
lines changed

1 file changed

+11
-12
lines changed

README.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,18 @@
1-
# Introduction
1+
[![License](https://img.shields.io/github/license/danobot/entity-controller.svg?style=flat-square)](https://github.com/danobot/entity-controller/blob/develop/COPYING)
2+
[![donate paypal](https://img.shields.io/badge/donate-PayPal-blue.svg?style=flat-square)](https://paypal.me/danielb160)
3+
[![donate gofundme](https://img.shields.io/badge/donate-GoFundMe-orange?style=flat-square)](https://gf.me/u/w62k93)
4+
5+
# :wave: Introduction
26
Entity Controller (EC) is an implementation of "When This, Then That for x amount of time" using a finite state machine that ensures basic automations do not interfere with the rest of your home automation setup. This component encapsulates common automation scenarios into a neat package that can be configured easily and reused throughout your home. Traditional automations would need to be duplicated _for each instance_ in your config. The use cases for this component are endless because you can use any entity as input and outputs (there is no restriction to motion sensors and lights).
37

4-
**Latest stable version `v5.1.1` tested on Home Assistant `0.106.2`.**
8+
**Latest stable version `v5.1.1` tested on Home Assistant `0.109.5`.**
59

6-
## Video Demo
10+
## :clapper: Video Demo
711
I created the following video to give a high-level overview of all EC features, how they work and how you can configure them for your use cases.
812

913
[![Video](images/video_thumbnail.png)](https://youtu.be/HJQrA6sFlPs)
1014

11-
## EC Demo Instance
15+
## :computer: EC Demo Instance
1216
I created a demo instance which (over time) will showcase all the different EC features.
1317

1418
[Demo Instance](https://ec-demo.danielbkr.net)
@@ -27,6 +31,9 @@ Password: W8VfFdKU2zvS3GHV
2731
This instance may not be available at all times. Do not raise issues for this. All the confugration is available in the `hass-demo` directory.
2832
[Buy me a coffee to support ongoing development](https://www.gofundme.com/danobot&rcid=r01-155117647299-36f7aa9cb3544199&pc=ot_co_campmgmt_w)
2933

34+
# :boom: Recent Breaking Changes :boom:
35+
* `v6.0.0` introduces a breaking change if you are relying on the entities `friendly_name` in other automations. See [#153](https://github.com/danobot/entity-controller/pull/153). The release PR is [#156](https://github.com/danobot/entity-controller/pull/156).
36+
3037
# Requirements
3138
This component started out as an AppDaemon script implementation of motion activated lighting but it has since been generalised to be able to control any Home Assistant entity. I have discussed the original core requirements for motion lights [on my blog](https://www.danielbkr.net/2018/05/17/appdaemon-motion-lights.html). The basic responsibilities of EC are as follows:
3239
* (1) turn on **control entities** when **sensor entities** are triggered
@@ -62,14 +69,6 @@ This FSM implementation is by far the most elegant solution I have found for thi
6269

6370
Note that `control_entities == state_entities` unless you specifically define `state_entities` in your configuration.
6471

65-
66-
## 📢 Are you a seasoned Python developer? 📢
67-
68-
Help is needed over on issue #101 to get the goodness of automated unit testing going on this project. ✔️🌞💯
69-
70-
All the boilerplate for Pytest is set up, but I got stuck mocking the passage of time. 😅 [see #101 for details](https://github.com/danobot/entity-controller/issues/101)
71-
72-
7372
# Configuration
7473
EC is very configurable. The following documentation section explain the different ways you can configure EC. In its most basic form, you can define:
7574

0 commit comments

Comments
 (0)