Load Shedding ![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg)
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.
HACS Install
- Go to HACS Integrations on your Home Assitant instance
- Select "+ Explore & Download Repositories" and search for "Load Shedding"
- Select Load Shedding: A Home assistant integration to track your load shedding schedule. and Download this repository with HACS
![image](https://user-images.githubusercontent.com/2578772/167293308-d3ef2131-bc71-431e-a1ff-6e02f02af000.png)
- Once downloaded, click the My Integrations button to configure the integration.
![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)
- Setup cards and automations
- Please support my work
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
![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)
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
![image](https://user-images.githubusercontent.com/2578772/164681660-57d56fc4-4713-4be5-9ef1-bf2f7cf96b64.png)
2. Restart Home Assistant.
3. Go to Settings > Devices & Services > + Add Integration
[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=load_shedding)
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
![image](https://user-images.githubusercontent.com/2578772/164681929-e3afc6ea-5821-4ac5-8fa8-eee04c819eb6.png)
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
Mushroom Chips
Status Alert
Calendar
ESP Status Bar
Thanks to @ribeirompl for this contribution
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.
Load Shedding Stage
Announce Load Shedding stage changes on speakers and push notifications.
Load Shedding Start/End
Do stuff when load shedding starts, e.g. update your slack status, turn off lights, etc.
Slack Status
Setup a REST Command and two automations to set your Slack status when Load Shedding starts and ends.
Example
`secrets.yaml`
```yaml
slack_token: Bearer xoxp-XXXXXXXXXX-XXXXXXXXXXXX-XXXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
```
`configuration.yaml`
```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 Warning (15 min)
15 minutes warning on speaker and telegram before load shedding starts.
Load Shedding Warning (2 hr)
2 hour warning on smart speaker
Load Shedding Reload
Reload the integration every night. This is a workaround for Issue #70/#71