Skip to content

Beat-YT/hydropeak-ha

Repository files navigation

❄️ Hydro-Québec Peak Events in Home Assistant

illo-hero-periodes-pointe-16-9

Hydro-Peak is a lightweight Home Assistant integration dedicated to monitoring Hydro-Québec peak events. This integration helps you optimize your energy consumption and potentially reduce costs by leveraging preheat events and peak event timings. It uses the modern hydro-quebec api to retrieve events.

Installation

1. Install the integration (Recommended: via HACS)

The easiest way to install HydroPeak is through HACS.
Find HydroPeak in HACS and install it directly from the UI.

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Alternatively, you may install it manually:

  • Download the repository files.
  • Copy custom_components/hydropeak and paste it into home assistant's custom_components folder.

2. Add the integration in Home Assistant

  • After installation, go to Configuration > Integrations > Add Integration and search for HydroPeak.
  • Configure the integration:
    • Select Your Hydro-Québec Savings Offer: Choose between options such as Flex-D or Winter Credit
    • Set your Preheat Start time (when your devices should pre-heat before a peak event begins)

Sensors

Once configured, HydroPeak will create the following sensors in Home Assistant:

  • Event Begin: A timestamp showing when the peak event will begin.
  • Event End: A timestamp indicating when the peak event will end.
  • Preheat Start: A timestamp when devices should start preheating or preparing, as configured during setup.

These sensors allow you to automate and regulate your energy usage based on the upcoming peak events.

About

HydroPeak is a standalone integration, it does not connect to any Hydro-Québec customer account and does not require a login. It only uses publicly available open data from Hydro-Québec, which keeps the setup simple, reliable and privacy friendly.

The integration supports both Residential and Business peak savings programs. When you configure it in Home Assistant, it automatically retrieves the list of active offers for the current winter season along with their descriptions. It then keeps the peak event schedule updated during the day so your Home Assistant automations can use the correct times for preheat periods and peak events.

Sources:

A detailed list of Hydro-Québec offers and descriptions, as well as information about open data, can be found here:
Événements de pointe – Saison hivernale

A list of all events published by Hydro-Québec is also available:
Événements de pointe – Saison hivernale — Données ouvertes Hydro-Québec

Community & Support

Have questions, feature ideas, or want to share your automations using HydroPeak?

Join the Domo-Québec Discord community and chat with others in the #general-hydropeak channel!

📩 Discord invite: https://discord.gg/M8UabTrZAj

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Hydro-Québec winter peak events in Home Assistant — supports Winter Credit, Flex-D, and more. Automatically fetches event windows and preheat periods to help you optimize energy use and reduce costs.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages