A Home Assistant integration to track your load schedding schedule.

💡This integration uses the Eskom SePush API.
🚨Read the EskomSePush API Licence Agreement.
🔑Get a Free (50 requests per day) API Key from Eskom Se Push. You can pay for a higher limit.
⚠️Do not use more than one API key from the same IP. Your key will be blocked.

1. Go to HACS Integrations on your Home Assitant instance
2. Select "+ Explore & Download Repositories" and search for "Load Shedding"
3. Select Load Shedding: A Home assistant integration to track your load shedding schedule. and Download this repository with HACS
4. Once downloaded, click the My Integrations button to configure the integration.
   
5. Setup cards and automations
6. Please support my work

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.

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.

3EGnQKKbF6AijqW9unyBuW8YeEscY5wMSE

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

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

| | |

• Mushroom

• Code

• Markdown Card

• Code

• Atomic Calendar Revive

• Code

Thanks to @ribeirompl for this contribution

• Lovelace HTML Jinja2 Template card

• Code

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)

Do stuff when load shedding starts, e.g. update your slack status, turn off lights, etc.

• Load Shedding (Start/End)

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

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

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

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

• Load Shedding (Warning)

2 hour warning on smart speaker

• Load Shedding (Warning) (2hr)

Reload the integration every night. This is a workaround for Issue #70/#71

• Load Shedding Reload