gitwtfhub

wtf is sucky-monitor?

uudruid74/sucky-monitor — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5Setup · moderate

TL;DR

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.

Mindmap

mindmap
  root((Sucky Monitor))
    What it does
      Detects stuck vacuum
      Cancels runaway clean
      Restricts to allowed rooms
    Tech stack
      Python
      Wyze SDK
      Cron scheduling
    Use cases
      Prevent whole house clean
      Auto dock stuck vacuum
      Room restricted scheduling
    Audience
      Wyze vacuum owners
      Home automation hobbyists
    Setup
      Configure device MAC
      Set allowed room IDs
      Schedule with cron

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Stop a Wyze robot vacuum from cleaning the whole house after it recovers from getting stuck.

REASON 2

Automatically detect when a robot vacuum stops moving and dock it before it drags debris everywhere.

REASON 3

Restrict a scheduled robot vacuum cleaning job to specific rooms only.

What's in the stack?

PythonWyze SDKcron

How it stacks up

uudruid74/sucky-monitor0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Wyze robot vacuum, the Wyze SDK, and a cron job configured with your own device MAC and room IDs.

No license information was provided in the README.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Explain how Sucky Monitor detects that the vacuum is stuck versus just cleaning slowly.
Prompt 2
Walk me through adapting this script's room IDs and schedule for my own Wyze vacuum.
Prompt 3
What does the sweep_rooms function do differently from the regular clean function in the Wyze SDK?
Prompt 4
Help me set up the daily cron job that triggers the room restricted clean.

Frequently asked questions

wtf is sucky-monitor?

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.

What language is sucky-monitor written in?

Mainly Python. The stack also includes Python, Wyze SDK, cron.

What license does sucky-monitor use?

No license information was provided in the README.

How hard is sucky-monitor to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is sucky-monitor for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.