Load Shedding

A Home Assistant integration to track your load schedding schedule.

ℹ️ NOTE: Prior to v1.0.0 this integration made use of this Python library which only supports schedules for Eskom Direct customers. If you can find your schedule on https://loadshedding.eskom.co.za/ then you'll have schedule info available.
If you are not an Eskom Direct customer, then a work-around is to find an Eskom Direct schedule which matches yours and use that instead. There are no immediate plans to add other municipalities, but Merge Requests on the library to expand support are welcome.

v1.0.0 uses the Eskom SePush API. Get a Free (50 requests per day) API Key from Eskom Se Push. You can also pay to get a higher request limit.

HACS Install

1. Go to HACS Integrations on your Home Assitant instance
2. Select "+ Explore & Download Repositories" and search for "Load Shedding"
3. Select "Load Shedding" and "Download this repository with HACS"
4. Once downloaded, click the "My Integrations" button to configure the integration.
   
5. Setup cards and automations
6. Support

Support

If you find this integration useful, please consider supporting my work by buying me a coffee or making a donation in the form of Bitcoin.

Buy me a coffee

Sign-up for a free Luno wallet using this invite link or enter the code X48WY in the Rewards section and we can both earn R 25.00 free BTC after investing our first R 500.

Bitcoin

3EGnQKKbF6AijqW9unyBuW8YeEscY5wMSE

Manual Install

Instructions

1. Download and unzip to your Home Assistant config/custom_components folder.

Screenshot

2. Restart Home Assistant.
3. Go to Settings > Devices & Services > + Add Integration

5. Search for 'Load Shedding' and follow the config flow.

Screenshot

6. If you're coming from a previous version of this integration, you may need to delete the .json files in /config/.cache.

Screenshot

Sensor

The load shedding sensor State will always reflect the current load shedding stage.
i.e When load shedding is suspended, it will show No Load Shedding. When Stage 2 is active, it will show Stage 2.

Screenshot

| | |

Cards

I created these cards with the help the following

• template-entity-row
• 🍄 Mushroom
• Atomic Calendar Revive

Card 1

Code

Card 2

Code

Card 3

Code

Card 4 - Mushroom Chips and Atomic Calendar Revive

Code

Automation Ideas

These are just some automations I've got set up. They are not perfect and will require some tweaking on your end.
Replace sensor.load_shedding_south_africa_stage, sensor.load_shedding_milnerton_14 and other entity_id with your own.

Announce Load Shedding stage changes on speakers and push notifications.

• Load Shedding (Stage)

15 minutes warning on speaker and telegram before load shedding starts.

• Load Shedding (Warning)

2 hour warning on speaker

• Load Shedding (Warning) (2hr)

Update your Slack status

Setup a REST Command and two automations to set your Slack status when Load Shedding starts and ends.

Example

secrets.yaml

slack_token: Bearer xoxp-XXXXXXXXXX-XXXXXXXXXXXX-XXXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

configuration.yaml

rest_command: 
    slack_status:
      url: https://slack.com/api/users.profile.set
      method: POST
      headers:
        authorization: !secret slack_token
        accept: "application/json, text/html"
      payload: '{"profile":{"status_text": "{{ status }}","status_emoji": "{{ emoji }}"}}'
      content_type: "application/json; charset=utf-8"
      verify_ssl: true

• Load Shedding (Start/End)