Skip to content
This repository has been archived by the owner on Jan 20, 2021. It is now read-only.
/ octocost Public archive

Octocost is an app which works under AppDaemon within Home Assistant which gets yearly and monthly cost and usage of Octopus Energy Agile Octopus Tariff

License

Notifications You must be signed in to change notification settings

badguy99/octocost

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

octocost

hacs_badge

Codacy Badge

Please note: I am archiving this repository. I will no longer maintain it, but leave it here read only. Currently I will leave it in HACS default, so it can still be installed, however I reserve the right to remove it from HACS default (it will still be installable via HACS custom). There are a number of issues remaining with this, that I have not resolved:

  • It doesn't handle variable rate gas tariffs, or the tracker gas tariff which is not in the normal Octopus API.
  • It doesn't deal well with missing usage data, and will probably mismatch the cost - usage, getting the calculations wrong.

However feel free to fork the repo and take it on

If you think this will be useful to you, please consider signing up to Octopus Energy with my referral code: https://share.octopus.energy/dense-ape-125 - You'll get £50 credit too!

Summary

Octocost is an app which works under AppDaemon within Home Assistant which shows the yearly and month cost and usage of the Octopus Energy Agile Octopus Tariff It creates and sets sensors for yearly and monthly cost (£) and usage (kWh), up to yesterday:

sensor.octopus_yearly_cost
sensor.octopus_yearly_usage
sensor.octopus_monthly_cost
sensor.octopus_monthly_usage

If can also pull monthly and yearly gas cost and usage, and have sensors for them set up, if the gas section is included in the yaml configuration:

sensor.octopus_yearly_gas_cost
sensor.octopus_yearly_gas_usage
sensor.octopus_monthly_gas_cost
sensor.octopus_monthly_gas_usage

The data is updated once every two hours, although in reality the data Octopus Energy gets only seems to be updated once a day, so this is a compromise between trying to be up-to-date, and not hammering their servers, when the data doesn't update very frequently anyway.

Installation

Use HACS or download the octoblock directory from inside the apps directory here to your local apps directory, then add the configuration to enable the octocost module.

Apps.yaml Configuration

octocost:
  module: octocost 
  class: OctoCost 
  region: H
  mpan: <13 digit MPAN number>
  serial:  <Serial number>
  auth: <Octopus Energy API Key>
  startdate: 2020-02-23
  gas:
    mprn: <Gas MPRN number>
    gasserial: <Gas meter serial number>
    gas_tariff: FIX-12M-20-02-12
    gas_startdate: 2020-02-23

The module and class sections need to remain as above, other sections should be changed as required. The whole gas section is optional and can be excluded if not required.

Field Changeable Example
Title Yes octocost
module No octocost
class No OctoCost
region Yes H
mpan Yes 2000012345678
serial Yes 20L123456
auth Yes sk_live_abcdefg
startdate Yes 2020-02-23
gas: Yes
mprn Yes 1234567890
gasserial Yes E1S12345678901
gas_tariff Yes FIX-12M-20-02-12
gas_startdate Yes 2020-02-23

The startdate setting should be set to the date you started on the Agile Octopus tariff, not the date you joined Octopus Energy. It is used to adjust the start point if you joined within the current year or month, it should not be left blank if you joined earlier. region is the region letter from the end of E-1R-AGILE-18-02-21-H which can be found on the Octopus Energy developer dashboard webpage in the Unit Rates section for your account.

Lovelace UI Cards

Once the sensors are created, they can be displayed as cards within the Lovelace UI. For example:

      - entities:
          - entity: sensor.octopus_yearly_usage
            icon: 'mdi:flash'
            name: Yearly Usage (kWh)
          - entity: sensor.octopus_yearly_cost
            icon: 'mdi:cash'
            name: Yearly Cost (£)
          - entity: sensor.octopus_monthly_usage
            icon: 'mdi:flash'
            name: Monthly Usage (kWh)
          - entity: sensor.octopus_monthly_cost
            icon: 'mdi:cash'
            name: Monthly Cost (£)
        show_icon: true
        title: Octopus Usage / Cost
        type: glance

Example Lovelace UI Usage and Cost glance card

About

Octocost is an app which works under AppDaemon within Home Assistant which gets yearly and monthly cost and usage of Octopus Energy Agile Octopus Tariff

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages