Skip to content

Unofficial Home Assistant integration for interacting with Octopus Energy

License

Notifications You must be signed in to change notification settings

lildude/HomeAssistant-OctopusEnergy

 
 

Repository files navigation

Home Assistant Octopus Energy

installation_badge

Custom component built from the ground up to bring your Octopus Energy details into Home Assistant to help you towards a more energy efficient (and or cheaper) home. This integration is built against the API provided by Octopus Energy UK and has not been tested for any other countries.

This integration is in no way affiliated with Octopus Energy.

If you find this useful and are planning on moving to Octopus Energy, why not use my referral link?

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

Please follow the setup guide to setup your initial account. This will include a few sensors be default depending on your account.

Target Rate Sensors

These sensors calculate the lowest continuous or intermittent rates within a 24 hour period and turn on when these periods are active. If you are targeting an export meter, then the sensors will calculate the highest continuous or intermittent rates within a 24 hour period and turn on when these periods are active.

These sensors can then be used in automations to turn on/off devices that save you (and the planet) energy and money. You can go through this flow as many times as you need target rate sensors.

Please follow the setup guide to setup.

Energy Dashboard

The core sensors have been designed to work with the energy dashboard. Please see the guide for instructions on how to set this up.

Community Contributions

A collection of community contributions can be found here.

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.

About

Unofficial Home Assistant integration for interacting with Octopus Energy

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published

Languages

  • Python 99.4%
  • Other 0.6%