Skip to main content

ORES smart home integration, free and open source

ORES integration for Gladys Assistant

ORES (Wallonia) network status: outages and planned works at your address.

This integration watches the ORES distribution network (Wallonia, Belgium) at your home and, optionally, at a second address: outages in progress, planned works with a power cut, announced delays. It reads the public ORES outage map (Outages and interruptions).

Unofficial integration, not affiliated with ORES. It uses the unauthenticated web service behind the public outage map of ores.be, which ORES may change at any time.

Tag: cloud (the integration queries the ORES website, nothing is read locally).

Configuration​

Home​

By default, the home is your Gladys house (Settings → Houses, with its position on the map). The integration asks Gladys for the location of the houses (an authorization shown at install time). Gladys only gives GPS coordinates, so the integration turns them once into a postal address through OpenStreetMap Nominatim, then caches the result under /data. The coordinates are sent nowhere else, never to ORES.

FieldPurpose
Home address"Gladys house location" (default) or "Address typed below".
Gladys houseName of the house to watch when Gladys has several (empty: the first located).

The Test the ORES outage map button shows the address found: check it. When it is wrong (imprecise position, house at a street corner...), choose "Address typed below" and fill in the fields.

Coming from version 0.1? As long as you do not save the configuration, the address you typed keeps being used.

Address typed by hand​

FieldPurpose
Zip codeRequired in manual mode: the municipality to watch.
LocalityOnly when several localities share the same zip code.
StreetTo know whether your street is hit, not only the municipality.
House numberNarrows to your side of the street (ORES publishes odd/even ranges).

Without a street, the whole municipality counts as "your address". Street names are compared without accents, case nor punctuation: "Rue de l'Église" matches "RUE DE L EGLISE".

Second address (optional)​

Another address to watch: second home, relatives, workplace... Give it a name (e.g. "Parents") and fill in at least its zip code. It gets its own device, and the scene triggers, the scene action and the widget can target it. Empty the zip code to disable it.

Other settings​

  • Planned works horizon (days): works announced further ahead are ignored (7 by default).
  • Refresh interval (s): how often the map is read (300 s by default, 60 s minimum).

The "ORES network status" devices​

Create them from the Discover tab: one for the home, one for the second address. Each exposes four binary sensors (0/1):

  • Outage at my address: an unplanned outage hits the address;
  • Planned works at my address: planned works with a power cut are in progress there;
  • Upcoming planned works at my address: works are announced within the chosen horizon;
  • Incident in my municipality: at least one outage or works site is in progress there.

Scene triggers​

TriggerWhen
ORES outage or works startedan outage or a works site begins
ORES outage or works endedan outage or works in progress are over
ORES outage or works delayedORES announces a later end
ORES planned works announcednew planned works appear on the map

Filters: Address (home / second address), Type (outage / planned works) and Where (at the address / elsewhere in the municipality). Variables for the next actions: {{triggerEvent.data.reference}}, city, start_time, end_time (ISO dates, UTC) and customers (customers impacted).

The first read after the installation (or an address change) is the baseline: incidents already running fire nothing. The state is kept under /data, so a restart neither replays nor misses a transition.

Scene actions​

  • Check an address on the ORES network: any address, typed in the scene. Outputs: outage, planned_interruption, upcoming_interruption, commune_incidents, reference, end_time, next_start_time.
  • Get the ORES network status: the last known status of the home or of the second address (Address field), no network call, same outputs.

Widget​

The ORES network status widget shows the live sensors, the status of the address, the number of incidents in the municipality, the list of outages and works (details on tap) and a Refresh button. Its Address setting picks the home or the second address: add two widgets to see both.

Gas and electricity consumption​

Not planned. The my.ores.be portal has no public API and only accepts the itsme / eID sign-in (the e-mail / password sign-in is discontinued). These sign-ins need a human approval every time and cannot be automated.

An occasional import of the my.ores.be consumption export remains possible. If you are interested, open an issue.

Privacy​

  • Only the public incident list is downloaded from ORES. Your addresses never leave your Gladys: the matching runs locally.
  • In "Gladys house" mode, the coordinates of the house are sent once to OpenStreetMap Nominatim (then each time the house moves). Type your address by hand to avoid it.
  • The addresses are never written to the logs.

Configuration settings​

These are the settings ORES asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
Watched addressessectionNoThe integration reads the public ORES outage map every few minutes and watches your home and, optionally, a second address. By default the home is your Gladys house: its coordinates are turned into a postal address ONCE through OpenStreetMap (Nominatim), then cached. Prefer typing it? Choose "Address typed below". Unofficial integration, not affiliated with ORES.
Home addressselectNoWhere the home address comes from.
Gladys house (optional)stringNoName of the house to watch when Gladys has several. Empty: the first located house.
Home address typed by handsectionNoOnly used with "Address typed below". The zip code is required; add the street (and the house number) to know whether YOUR home is impacted, not only your municipality.
Zip codestringNo
Locality (optional)stringNoOnly when several localities share your zip code.
Street (optional)stringNo
House number (optional)stringNo
Second address (optional)sectionNoAnother address to watch (second home, relatives...). It gets its own device, and the scene triggers and the widget can target it. Leave the zip code empty to disable it.
NamestringNo
Zip codestringNo
Locality (optional)stringNoOnly when several localities share your zip code.
Street (optional)stringNo
House number (optional)stringNo
Planned works horizon (days)numberNoPlanned works announced further ahead are ignored.
Refresh interval (s)numberNoHow often the ORES outage map is read, in seconds (one minute minimum).

How to install ORES in Gladys​

  1. In Gladys, open Integrations: ORES appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/gboulvin/gladys-ores:0.2.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/gboulvin/Gladys-ORES.

ORES requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

ORES is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by gboulvin, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂