Skip to content

Home Assistant Target Timeframes#

Target timeframes was a feature that has been extracted out of the Octopus Energy integration. The idea is you can configure binary sensors that will find and turn on during the most optimal time periods based on external data sources, targeting either the lowest or highest values. What these values represent can be anything. In the original integration, the values represented cost of energy, and so the cheapest periods were discovered. But it could represent other things like

  • Temperature to turn on sprinklers during the hottest times of the day
  • Carbon emissions to turn on devices when renewables on the grid are at their highest
  • Solar generation to turn on devices when the most energy is being generated.

How the sensors behave is configurable in a number of ways and explained further in the docs.

How to install#

There are multiple ways of installing the integration. Once you've installed the integration, you'll need to setup your account before you can use the integration.

HACS#

hacs_badge

This integration can be installed directly via HACS. To install:

Manual#

You should take the latest published release. The current state of develop will be in flux and therefore possibly subject to change.

To install, place the contents of custom_components into the <config directory>/custom_components folder of your Home Assistant installation. Once installed, don't forget to restart your home assistant instance for the integration to be picked up.

How to setup#

You will initially need to setup one or more data sources. You'll then need to setup one or more target timeframe or rolling target timeframe sensors.

Events#

This integration raises several events, which can be used for various tasks like automations. For more information, please see the events docs.

Services#

This integration includes several services. Please review them in the services doc.

Blueprints#

A selection of blueprints are available to help get you up and running quickly with the integration.

FAQ#

Before raising anything, please read through the faq. If you have questions, then you can raise a discussion. If you have found a bug or have a feature request please raise it using the appropriate report template.

Sponsorship#

Please see the sponsorship page for more information.