Tempest smart home integration, free and open source
WeatherFlow Tempest weather stations: live observations, lightning, rain and forecasts.
Published by guim31
- Devices
- Version 1.0.1
- Requires Gladys >=5.1.0
- ★ 0
Brings your WeatherFlow Tempest weather stations into Gladys: temperature, humidity, pressure, wind, rain, lightning, UV, sunlight and the station's own forecast, in real time.
Developed without the hardware: this integration follows the official Tempest API documentation and real API answers published by other projects, but it has not yet been tried on a real station. Feedback is welcome on the GitHub repository.
This integration is not affiliated with WeatherFlow-Tempest, Inc.
Overview
The integration connects to the Tempest cloud with your personal access token, exactly like the Tempest app does:
- one Gladys device per station of your account;
- a live feed (WebSocket): one observation per minute, the wind every 3 seconds, rain and lightning detected the moment they happen;
- the station forecast ("better forecast" of the Tempest API) for today, tomorrow and the next days;
- two scene triggers, one scene action and one dashboard widget.
Everything is read-only: the integration never changes anything on your Tempest account.
Requirements
- Gladys 5.1 or later.
- A Tempest station (the all-in-one sensor,
ST) set up in the Tempest app. Older WeatherFlow AIR and SKY sensors are not supported. - Internet access from Gladys: the data comes from the Tempest cloud.
- A personal access token: sign in to the Tempest web app (tempestwx.com), open Settings → Data Authorizations, then Create Token. Copy the token.
The Tempest also broadcasts its data on the local network (UDP), but Gladys integrations run in an isolated container that cannot receive local broadcasts: this integration therefore uses the cloud only.
Configuration
- Install the integration: Integrations → Install from GitHub, or from the store.
- In the Configuration tab, paste your personal access token and save.
- Optional settings:
- Language of the texts (French by default): the names of the features of the stations you add from now on, the precipitation type, the forecast texts and the scene sentences;
- Instant wind every 3 seconds (on by default): see below.
- Click List my stations to check the token: the button lists the stations of your account and tells which ones can be added.
- Open the Discovery tab and add your station.
The status at the top of the Configuration screen says when the token is refused or the Tempest service cannot be reached.
The station device
Each station brings these features (read-only):
| Feature | Unit | Source |
|---|---|---|
| Temperature, feels like, dew point | °C | every minute |
| Humidity | % | every minute |
| Station pressure, sea-level pressure | hPa | every minute |
| Average wind, wind gusts | km/h | every minute |
| Wind direction | degrees | every minute |
| Instant wind (3 s) | km/h | every 3 seconds, no history |
| Rain intensity | mm/h | every minute |
| Rain today | mm | every minute |
| Raining | yes/no | every minute |
| Precipitation type | text | none, rain, hail |
| Lightning strikes (last hour) | count | every minute |
| Last lightning distance | km | at each strike |
| UV index, solar radiation, illuminance | index, W/m², lux | every minute |
| Battery voltage | V | every minute |
| Forecast today / tomorrow | text | every 30 minutes |
| Minimum and maximum today / tomorrow | °C | every 30 minutes |
| Chance of rain today / tomorrow | % | every 30 minutes |
Gladys converts temperatures and speeds to your preferred units. The battery is the voltage of the Tempest's supercapacitor (about 2.4 to 2.8 V; the station saves power below 2.45 V), not a percentage. The sea-level pressure is computed from the station pressure and the station elevation, with the formula of the Tempest documentation.
Widget
Add the Tempest station widget to a dashboard and pick a station:
- five live tiles: temperature, humidity, wind, rain today, pressure;
- a status list: current conditions, wind direction and gusts, pressure trend, precipitation, last lightning (distance and time), UV index;
- the forecast of the next days, or of the next hours (widget setting).
Scene triggers
In the scene editor, Integrations category:
- it starts raining — the station detects rain after at least 30 minutes without any. It fires once per rain episode, within seconds thanks to the station's own rain-start event. Optional filter: the station. Variable: the station name.
- lightning nearby — a lightning strike within the distance you choose (5, 10, 15, 20, 30 or 40 km), the first one for 30 minutes at that distance. When a storm comes closer, the smaller distances fire in turn. Variables: the strike distance (km) and the station name.
After a restart of the integration, rain already falling or a strike already known does not fire the triggers again.
Scene action
forecast summary — today's or tomorrow's forecast of a station:
summary: a ready-made sentence, e.g. "Today: Rain possible, 4 to 12 °C, 60 % chance of rain.";condition,temperature_min,temperature_max,precipitation_probability: the numbers, to use in conditions.
The sentence follows the Language of the texts setting.
Scene examples
- Close the awning when it starts raining: trigger "it starts raining", action "close the awning".
- Unplug the antenna amplifier when a storm comes: trigger "lightning nearby" within 10 km, action: turn off the plug and send a message with the strike distance.
- Morning briefing: at 7:00, action "forecast summary" (today), then send
the
summaryoutput as a message. - Skip the watering: at 6:00, "forecast summary"; if the chance of rain is above 60 %, do not start the sprinkler. The "Rain today" feature can also stop it after a shower.
Refresh and data use
- The live feed keeps one connection to the Tempest cloud for all your stations; it reconnects by itself (from 1 second to 5 minutes between attempts) and is reopened when it stays silent for 3 minutes.
- While the live feed is down, each added station is read once a minute over the REST API. The forecast is read every 30 minutes per station.
- WeatherFlow asks applications to stay under 100 REST requests per minute per user: the integration uses at most about 3 per minute per station.
- Only the stations you added to Gladys are followed.
- A value that does not change is sent again every 6 hours, so it never shows "no recent value".
- Tempest data is for the personal use of the station owner (Tempest remote data access policy).
Troubleshooting
- "The Tempest access token was refused": the token was deleted or mistyped. Create a new one on tempestwx.com and paste it again.
- No station in Discovery: click List my stations. A station without a Tempest (AIR and SKY only) cannot be added.
- Values stop updating: check that Gladys has Internet access and look at
the integration logs (one line when a problem starts, one when it ends;
LOG_LEVEL=debugshows every message). - The instant wind is too lively: turn off Instant wind every 3 seconds; the feature then follows the one-minute average.
Limits
- Developed without the hardware: the integration has not been tried on a real station yet.
- Cloud only: no local (UDP) data, inaccessible from the integration container.
- Tempest (
ST) stations only: no AIR or SKY. - The feature names are set when the station is added: changing the language later only applies to stations added afterwards.
- Scene filters only compare values for equality: the lightning trigger offers fixed distances.
- The forecast is the Tempest one, for the station location.
Configuration settings
These are the settings Tempest asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Connect your Tempest account | section | No | Sign in to the Tempest web app (tempestwx.com), open Settings, then Data Authorizations, and create a personal access token. Paste it below: the stations of the account then appear in the Discovery tab. |
| Personal access token | secret | Yes | |
| Language of the texts | select | No | Feature names of the stations added from now on, precipitation type, forecast texts and scene sentences. |
| Instant wind every 3 seconds | boolean | No | Updates the instant wind feature from the live feed every 3 seconds (not kept in the history). Off: it follows the one-minute average. |
How to install Tempest in Gladys
- In Gladys, open Integrations: Tempest appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/guim31/gladys-tempest:1.0.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/guim31/gladys-tempest.
Tempest 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
Tempest 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 guim31, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation