uudruid74/sucky-monitor — explained in plain English
Analysis updated 2026-05-18
Stop a Wyze robot vacuum from cleaning the whole house after it recovers from getting stuck.
Automatically detect when a robot vacuum stops moving and dock it before it drags debris everywhere.
Restrict a scheduled robot vacuum cleaning job to specific rooms only.
| uudruid74/sucky-monitor | 0xallam/my-recipe | 0xhassaan/nn-from-scratch | |
|---|---|---|---|
| Stars | 0 | — | 0 |
| Language | Python | Python | Python |
| Last pushed | — | 2022-11-22 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 2/5 | 2/5 | 4/5 |
| Audience | general | general | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires a Wyze robot vacuum, the Wyze SDK, and a cron job configured with your own device MAC and room IDs.
Sucky Monitor is a small personal automation script built for one specific robot vacuum, a Wyze robot vacuum nicknamed Sucky that keeps getting stuck on things like socks, towels, and charging cables. The problem it solves is that Wyze's default behavior after the vacuum gets stuck and recovers is to restart cleaning across the entire house, so if the vacuum chokes on a sock in the kitchen, it is then free to drag that same sock through every other room. This project runs alongside your regularly scheduled Wyze cleaning job and watches the vacuum's position and status roughly every 30 seconds. If the vacuum stops moving and reports an error state for three checks in a row, meaning about ninety seconds of no movement, the monitor cancels the cleaning run and sends the vacuum back to its dock. When the schedule tries again, it calls a room restricted cleaning function instead of the whole house one, so the vacuum only ever cleans the specific rooms you have allowed, currently the kitchen and living room, rather than the entire house. A daily cron job kicks off the cleaning script at 9 AM using the Wyze SDK to trigger the room restricted clean, and a separate Python script does the ongoing status polling and stuck detection. The vacuum's device identifier, the allowed room IDs, the stuck detection threshold, and the daily schedule are all listed as simple configuration values in the README. The README notes it was built with a tool called Hermes Agent on top of the Wyze SDK, and the project has an informal, personal tone throughout, describing the vacuum's history of eating towels and cables that led to this fix being written. No license is stated in the README.
A watchdog script for a Wyze robot vacuum that detects when it gets stuck and restricts its cleaning to specific rooms instead of the whole house.
Mainly Python. The stack also includes Python, Wyze SDK, cron.
No license information was provided in the README.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.