explaingit

botts7/dreame-scheduler-addon

Analysis updated 2026-05-18

7JavaScriptAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A Home Assistant add-on with a visual setup panel and floor plan editor for the Dreame Scheduler integration, so you can schedule robot vacuum cleaning without editing YAML.

Mindmap

mindmap
  root((dreame-scheduler-addon))
    What it does
      Visual config panel
      Floor Plan Studio
      Weekly reports
    Tech stack
      JavaScript
      Python
      Home Assistant
    Use cases
      Schedule cleaning
      Draw no-go zones
      Presence-based pause
    Audience
      Smart home users
      HA add-on users

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

What do people build with it?

USE CASE 1

Set up a cleaning schedule for a Dreame robot vacuum through a visual panel instead of YAML.

USE CASE 2

Get a weekly report showing which rooms were cleaned or missed and why.

USE CASE 3

Draw no-go and no-mop zones on a floor plan for the robot to avoid.

USE CASE 4

Automatically pause cleaning when someone is home and resume once the house is empty.

What is it built with?

JavaScriptPythonHome Assistant

How does it compare?

botts7/dreame-scheduler-addonboneskull/promwrapbrunosimon/ecole-multimedia-fi-dev2-2019
Stars777
LanguageJavaScriptJavaScriptJavaScript
Last pushed2020-07-212021-08-12
MaintenanceDormantDormant
Setup difficultymoderateeasyhard
Complexity2/52/52/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the separate Dreame Scheduler integration installed first via HACS.

Free to use, modify, and share for any purpose, including commercial use, as long as the copyright notice is kept.

In plain English

This is a Home Assistant add-on that gives you a visual configuration panel and floor plan editor for the Dreame Scheduler integration, a separate project that connects Dreame robot vacuums to Home Assistant. Instead of writing YAML configuration by hand, you get a graphical interface, running behind Home Assistant's ingress system, where you set up schedules and view reports. You need to install the Dreame Scheduler integration first, through HACS, and add your vacuum there. Then you add this add-on's repository to Home Assistant's add-on store and install it from the sidebar. It ships as prebuilt images for amd64, aarch64, and armv7 processors, so it should install quickly even on a Raspberry Pi, since its underlying dependencies are pure Python. Once running, the panel can pause a cleaning run when you are home, using your existing presence sensors with a short grace delay, and send the robot back to its dock, then start again once the house is empty. It also produces a weekly report showing which rooms were cleaned, which were missed and why, along with the robot's own coverage maps, any obstacles it flagged, and a history of past runs. A separate Floor Plan Studio feature, marked as beta, lets you draw zones the robot should avoid, including no-mop areas, mark virtual walls, have the tool automatically fit and join rooms together, view the layout in 3D, and export it to your own dashboard. If the robot gets physically stuck partway through a clean, the scheduler can mark that spot as blocked, back the robot out, and continue the rest of the run rather than leaving it stopped. On the security side, the add-on communicates with Home Assistant using the Supervisor token, which is kept on the backend and never reaches your browser. It only asks for the Home Assistant API permission, not the broader Supervisor API, and its internal network port only accepts connections coming through the ingress gateway, so other add-ons cannot reach it directly. The project is released under the MIT license, and issues are tracked on the separate Dreame Scheduler integration repository rather than this add-on's own page.

Copy-paste prompts

Prompt 1
Walk me through installing the Dreame Scheduler integration and this add-on in Home Assistant.
Prompt 2
Explain how the presence-based pause and resume feature works with my existing sensors.
Prompt 3
How do I use the Floor Plan Studio to mark no-go zones for my robot vacuum?
Prompt 4
What does the weekly cleaning report show and how do I read the coverage maps?

Frequently asked questions

What is dreame-scheduler-addon?

A Home Assistant add-on with a visual setup panel and floor plan editor for the Dreame Scheduler integration, so you can schedule robot vacuum cleaning without editing YAML.

What language is dreame-scheduler-addon written in?

Mainly JavaScript. The stack also includes JavaScript, Python, Home Assistant.

What license does dreame-scheduler-addon use?

Free to use, modify, and share for any purpose, including commercial use, as long as the copyright notice is kept.

How hard is dreame-scheduler-addon to set up?

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

Who is dreame-scheduler-addon for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.