Anova Smart-Home-Integration, kostenlos und Open Source

Anova sous vide cookers and ovens via the official API: temperature, timer, stop; start as option.
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Shows your Anova Precision Cookers (sous vide) and Anova Precision Ovens in Gladys through the official Anova Developer API (a WebSocket of Anova's cloud), and lets Gladys stop them, and start a sous vide cook when you allow it.
Never tested with a real device: written from the official documentation and from the library of the Anova integration of Home Assistant. Not affiliated with Anova. Feedback welcome on the Gladys forum.
What you need
- An Anova account with your devices paired in the Anova app.
- A personal access token: in the Anova Oven app (also for a sous vide
cooker: sign in with the same account), go to More → Developer → Personal
Access Tokens, give it a name and create it. It starts with
anova-. An account can have up to 10 tokens. - The use of the API is subject to the Anova API Terms of Use (https://developer.anovaculinary.com/terms): personal, non-commercial use.
Setup
- Paste the token in Personal access token and save. The token is kept by Gladys in its database, never shown again, sent only to Anova.
- The status should say "Connected to Anova: N devices".
- Open the Discovery tab and add your devices.
Features of each device
| Feature | Precision Cooker | Precision Oven |
|---|---|---|
| Temperature | water (°C) | oven, dry or wet bulb (°C) |
| Target temperature | read only (°C) | read only, while cooking (°C) |
| Time remaining | minutes (0 when idle) | minutes, while the timer runs |
| Cook time | minutes | minutes, while cooking |
| State | idle, preheating, cooking, timer done… | idle or cooking |
| Alert | water low or critical, leak, too hot | water tank empty, door open |
| Stop cooking | button | button |
A value Anova does not give stays unknown: it is never shown as 0. Anova pushes a state when something changes; when nothing came for 25 min, the integration opens the connection again to get fresh states (Anova closes an idle connection after 30 min).
The oven readings come from the community description of its state messages: they are not in the official documentation. The A3, A4/A5 and A6/A7 cookers send their state in different shapes, all read; other types are read when they send one of these shapes.
Stopping
The Stop cooking button of each device, and the scene action Anova:
stop cooking, need no option and are never refused: not by the start option,
nor by a pause asked by Anova (HTTP 429), nor by a refused token (one attempt
per click, and one for a stop kept across a restart), nor by a slow or
unreadable /data. Without a connection, one is opened at once; if it cannot
open within 3.5 s, the stop is kept (also in /data, for 10 min) and sent as
soon as a connection opens.
A stop is sent with a ping: without the answer, a message or the pong within 1.5 s, the connection is taken as dead (a router restarted, for instance), cut and opened again at once, and the stop is sent on the new one (3 dead connections at most per stop, then the backoff). Such a send does not count.
It is sent 3 times in all at most, again while the device still reports the
same cook 20 s after it; it is not sent again when a different cook is shown
(one started afterwards from the app or the device). A click always leaves at
once, whatever cook the device shows, also on the connection it opened itself
within its 3.5 s. Only a kept stop (not sent within those 3.5 s, or read back
from /data after a restart) whose cook is known checks it on a new
connection, states that came with the opening included (2 s at most): idle, it
is done; another cook, it is not sent; the same cook, or no state, it is sent.
A stop already accepted by Anova is checked the same way before being sent
again. The identity of the cook is kept in /data. A stop also
cancels a start not yet sent.
What a stop cannot do: reach Anova without a token, or before the token is
read from Gladys after a restart (the token is never written to /data).
The scene action gives a result: confirmed (the device reports idle),
accepted (Anova answered ok), refused (Anova answered an error: checked
again and sent again), sent (sent, no answer yet), queued (sent as soon as
connected) or skipped (a kept stop not sent: another cook was started).
Starting a sous vide cook (off by default)
Starting heats water: it needs the option Allow starting a cook, off by default. Then the scene action Anova: start a sous vide cook takes a Precision Cooker, a temperature (25 to 92 °C, rounded to 0.1 °C) and a timer (whole minutes, 1 to 5999). Check that the cooker is in water before.
The start is refused, and nothing is sent, when:
- the option is off (checked again just before the send);
- the device is an oven (starting an oven is not supported), or not on the Anova account;
- a temperature or a timer is out of range or not a number;
- the connection is closed, or there is no state of the cooker on the current connection from the last 30 minutes;
- the cooker is already cooking (or its state is unknown), or reports a problem (water level, leak, too hot, failure);
- the cooker is starting or updating (state unknown or busy);
- another start of the cooker is in progress, or no state came since the last start (a start without confirmation blocks the next one until a state after it);
- a stop of the cooker is in progress, or was pressed meanwhile;
/datacannot be written within 10 s (the start is written there before it leaves; past 10 s, nothing is sent, so Gladys never sees a failure while the water heats).
Results: started (a state shows the cook), accepted (Anova answered ok, no
state yet) or sent (no answer: without confirmation). A start refused by
Anova fails the action. A cook in progress is never changed: stop it, then
start again. Changing the target during a cook is not in this version (the
personal access tokens only allow start, stop and the temperature unit).
Stop at the end of the timer (option, off by default)
Like in the Anova app, a Precision Cooker keeps the water at temperature when its timer ends. With Stop the cooker when its timer ends, Gladys sends a stop once per cook when the cooker reports its timer done.
Connection, limits and privacy
- One connection per integration, URL from the documentation; the token goes
in the query string as the documentation requires: it is never logged, never
shown, never written to
/data. The User-Agent saysgladys-anova/<version>. - Anova cuts the connection when its rate limit is reached: the integration
connects again after 5 s, 15 s, 30 s, 1, 2, 5, 10 then 30 min (half to the
whole of each step), and starts again from 5 s once a connection stayed up
3 min. After a restart, never faster than this (the time of the last attempt
is in
/data). - HTTP 429: pause for its Retry-After (1 min to 6 h, 15 min without), kept in
/dataacross a restart. A stop still goes through. - Refused token: an HTTP 401, or (what Anova does with an invalid token) a
connection closed by Anova with code 1005 within 5 s of its opening, without
any message, twice in a row. A network drop or another close code (1006,
1012, 1013…) is never a refusal. Nothing is sent again by itself: save a new
token, or click Test the connection (one new try). Only 8 bits of a hash
of the refused token are kept in
/data. A 403 or any other status is not a refusal: the integration backs off. /dataunreadable: nothing is sent by itself (read again every 10 s); Test the connection starts again from an empty state.- Messages larger than 256 KB are cut before they are read.
Test the connection
Connects now if needed (at most every 30 s, not during a 429 pause) and says how many devices Anova lists.
Konfigurationseinstellungen
Diese Einstellungen fragt Anova in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Your Anova account | section | Nein | Shows your Anova Precision Cookers (sous vide) and Precision Ovens in Gladys through the official Anova Developer API, in real time: temperature, target, time remaining, state and alerts, and a Stop button. Create a personal access token in the Anova Oven app (also for a sous vide cooker): More, Developer, Personal Access Tokens. Paste it below, save, then add the devices from the Discovery tab. Starting a sous vide cook is a scene action that needs the option below, off by default; stopping needs no option. Starting an oven is not supported. Never tested with a real device. Not affiliated with Anova. |
| Personal access token | secret | Ja | Starts with "anova-". Created in the Anova Oven app (More, Developer, Personal Access Tokens). Kept by Gladys in its database, never shown again, sent only to Anova. |
| Allow starting a cook | boolean | Nein | Off by default. On: the scene action "Start a sous vide cook" may heat the water of a Precision Cooker (25 to 92 °C, 1 min to 99 h 59). Make sure the cooker is in water before. Off: that action sends nothing. Stopping never needs this option. |
| Stop the cooker when its timer ends | boolean | Nein | Off by default: like in the Anova app, a Precision Cooker keeps the water at temperature when its timer ends. On: Gladys sends a stop once per cook when the cooker reports its timer done. |
| Language of the feature names | select | Nein | Used for the feature names of the devices added from now on, for the state texts and for the command errors. |
So installierst du Anova in Gladys
- Öffne in Gladys Integrationen: Anova erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-anova:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-anova.
Anova benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Anova ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation