[APP][Pro] HUUM UKU Sauna

HUUM UKU Sauna gives you full control over your HUUM sauna heater, including

the settings the official HUUM app for Homey leaves out — target humidity

above all.

What is this app?

An unofficial, third-party companion app for HUUM sauna heaters with the UKU WiFi controller. It talks directly to HUUM’s cloud API — the same one the official HUUM mobile app uses — so everything that API exposes is available on Homey too, not just the subset the official Homey app covers.

Why this app exists

The official Homey app for HUUM can’t set target humidity, even though HUUM’s own mobile app can. I reported that gap to Athom in June 2025; as of today it still hasn’t made it into the official app, so I built this one instead.

What can it do?

  • Settable target humidity (the official app only shows it, can’t set it)
  • A no-water alarm for the steamer
  • A safety cut-out / fault alarm
  • A remote-start-blocked sensor — separate from the door sensor, shows when the UKU’s own remote-safety confirmation is blocking a start
  • A time-remaining readout, plus a Flow trigger shortly before the UKU’s own auto shut-off
  • 3 profiles (temperature + humidity presets), startable from the device tile, a Flow, or the dashboard widget
  • A scheduled start with optional auto-off. HUUM’s API has no booking endpoint, so this runs entirely on Homey — it survives a restart, and a start missed by more than 30 minutes is dropped rather than fired late
  • Per-session energy and cost, fed by a kW estimate or by a measured-power value you push in from a Flow (e.g. from a Shelly)
  • A dashboard widget with live status and quick-start buttons
  • Steamer and light are auto-detected during pairing, so you only see the controls that actually apply to your setup

Flow Cards

When (triggers):

  • The sauna reached its target temperature
  • Remaining time drops below (x) minutes
  • Maximum heating duration almost reached (based on the UKU’s own auto shut-off timer, not the target temperature)
  • The current temperature changed (Homey’s own measure_temperature defaults
    only offer threshold cards, not a plain “changed” one — this app adds it)
  • Remote start became blocked / available
  • A sauna session ended (with duration, temperature, humidity, energy and
    cost tokens)

And (conditions):

  • Remaining time is / is not below (x) minutes
  • A start is / is not scheduled
  • Remote start is / is not blocked

Then (actions):

  • Start the sauna at a temperature and humidity
  • Start the sauna with a profile
  • Schedule a sauna start today / tomorrow at [time] with a profile
  • Cancel the scheduled start
  • Save the current settings as a profile
  • Set the sauna’s measured power (for the energy statistics, e.g. from a Shelly via a Flow)

(Plus everything Homey generates itself from the standard capabilities — turn
off, set temperature/humidity, the light, door/alarm triggers, and so on.)

Setup

Pairing uses the same email and password as the HUUM app. Everything runs against HUUM’s cloud (sauna.huum.eu) — there is no local/LAN protocol for the UKU, so this can’t be a fully local app. The app requests no special Homey permissions; no data leaves your Homey beyond what talking to HUUM’s own API requires.

About this app

I built this for my own sauna after reporting the target-humidity gap to Athom and not seeing it get picked up. Built with Claude’s assistance.

Available in the Homey App Store:

Support the development

Building, testing and maintaining this app takes a lot of time, and I’m happy to keep doing it. If it helps your smart home run smarter and you’d like to say thanks, a coffee (or a beer) is always appreciated.

PayPal | Buy Me a Coffee

Settings guide and FAQ

App settings (Apps → HUUM UKU Sauna → Configure)

Overview tab

Everything the API currently reports, a refresh button with a timestamp, and the scheduled start (set a time, a profile or a temperature/humidity pair, and an optional auto-off). If remote start is currently blocked, the form warns you right there before you schedule a start that would fail. Whether a start is scheduled, and when, is also on the device tile itself (huum_booking_status).

Settings tab

The two poll intervals (active/idle) and the auto-shutoff warning threshold, then the 3 profiles (name, temperature, humidity each).

Statistics tab

Session and energy totals, average per session, a recent-sessions list, the heater-power source (estimate / Flow), and the electricity price used for the cost figures. A scheduled start that failed or was dropped (door open, remote blocked, login failed, missed because the app was offline, …) shows up in that same list with its reason, not just as a fleeting notification.

Support tab

A link to this forum thread.

Device settings (the gear icon on the device)

Read-only sauna info, a toggle for the “check the water before heating” push notification, and Sensors/hardware: whether this sauna actually has a water-level sensor and a door sensor (auto/present/absent). Setting either to “absent” hides the matching alarm; for the door sensor it also skips the “don’t start with the door open” safety check, since a heater with no door contact would otherwise always report the door as open.

FAQ

Does this replace the official HUUM app?

No, they can run side by side — this app just exposes what the official one doesn’t.

What if my sauna has no steamer?

Detected automatically during pairing (based on the settings of the UKU); humidity control and the no-water alarm simply aren’t added.

Can I control more than one sauna?

Yes — a HUUM account maps to exactly one sauna, so pair again with the second account to add a second device.

Is any of this processed locally?

No. The UKU has no local/LAN protocol, so every command and status read goes through HUUM’s cloud, same as the official app.

Does the app need any special Homey permissions?

No. It requests no permissions beyond what every app has. (Earlier versions asked for homey:manager:api for a power-meter picker; that feature was removed, see the next question for the replacement.)

What does “remote start blocked“ actually mean?

The UKU sometimes requires someone to confirm safety on the physical control panel before it will accept a start command sent remotely. This app surfaces that as its own sensor and Flow trigger/condition, separate from the door-open alarm, and warns about it right in the scheduling form too.

How accurate is the energy/cost tracking?

Depends on the source you pick in Settings: a duty-cycle estimate (no extra hardware), or a measured power value you push in from your own Flow (e.g. from a Shelly), which the app integrates over the session.

How do I feed in the real power of a Shelly (or any other power meter)?

Create a Flow: WHEN the meter’s power changed (or on a 30-second timer) THEN “Set the sauna’s measured power to [the meter’s power] W”. Then switch Settings → Statistics → Heater power to “From a Flow”. The app only counts energy while a session is running, so standby readings don’t end up in your statistics.

My sauna showed 'heating' with the door open — does that count as a session?

No. If the door was never closed during that period (so the heater never actually ran), it isn’t counted as a session.

Does the scheduled start survive a Homey restart?

Yes, a booking missed by more than 30 minutes is dropped rather than fired late, and any failed or dropped attempt is recorded in the session history so it doesn’t go unnoticed.

Where do I report a bug or request a feature?

Reply in this thread, or open a GitHub issue if you want it tracked: Issues · RickD-CH/com.rickd.huum · GitHub

First of all thanks for developing for the Homey platform!

As Head of Partnerships, I naturally want to ensure the quality of the apps we develop and maintain, and I believe this functionality would be a valuable addition. Unfortunately, I haven’t been able to find any record of the June 2025 communication, whether in a commit, issue, or pull request in our HUUM repository or in the feature-request system.

Would you happen to have any further insight into this? It would help us understand what happened and prevent similar requests from going unnoticed in the future.

Hi Abe @Doekse

Please See Ticket nr 136009 and a screenshot of the last email:

My initual request was:

Hi There

I’m missing a flow card to set the settings for humidity → it’s possible with the controller & the huum app. but not here with homey

Added some more Information after that and last update was the Screenshot of the mail

Happy to support the community