Local ESPHome control for a cloud connected litter box

Oct 25, 2026 Last reply: 1 day ago 2 Replies
Jump to replies (2)

Automatic litter boxes are great until you realise the app and cloud servers sit between you and your own pet hardware. Joseph DiGiovanni has released a custom ESPHome component for the Litter Robot 3 that cuts Whisker's app and cloud service out of the loop entirely, giving full local control through Home Assistant. The stated goal is freeing these boxes from the cloud, and one practical motivation was triggering a robot vacuum after each use without any online service involved.



The path to a finished component is worth reading about. Serial hexadecimal traffic was captured during normal operation and app use, then fed to a language model to decode the protocol. A simple YAML prototype with a test button and a status sensor was flashed first, and once that confirmed a button could start a clean cycle, the final firmware was written as a dedicated C++ external component for ESPHome. A replacement mainboard bought online was used for early testing, which seems like a sensible way to avoid bricking the real one.



Architecturally, the ESP32 acts as a WiFi-to-UART bridge relaying commands to the mainboard microcontroller, while all hardware control and safety-critical logic stay on that separate chip. Community feedback also shaped the feature set, adding multi-cat visit counts and weight tracking for individual cats, and a hidden debug mode publishes live raw sensor data in the ESPHome debug logs.



One open question remains: it is unconfirmed whether the Litter Robot 3 can be flashed without soldering, and a wireless method from the stock firmware is still being tested. Support for the Litter Robot 5 is planned too, though not yet available. The code, a flashing guide, and the earlier Litter Robot 4 work are all hosted on Codeberg, alongside pre-compiled binaries and hardware installation instructions.



Project by Joseph DiGiovanni. Watch it on their YouTube channel:

formatting link


This is exactly the kind of local-first approach I want in my setup. The flashing part is the bit I keep going back to, though. On the Litter Robot 3 specifically, does the flashing have to go through soldered wires on the board, or is there any way to attach the programmer without picking up an iron? I have read that a wireless option is still being worked on, but I would like to know what the current recommended path is before committing to a used unit.

The maker has said soldering is currently the best way to attach the flashing wires on this model, and whether the Litter Robot 3 can be flashed without soldering is still unconfirmed. For tools, the flashing guide uses the ESP-PROG-2 programmer, but the maker says an older ESP-PROG, an FTDI adapter, or another ESP32 can also be used. A wireless flashing method from the stock firmware is being developed, so that may change things once it is released.

Join the Discussion

Have something to add? Share your thoughts — no account required.

Didn't find your answer?

Ask the community — no account required