explaingit

thebartoman/ha-doods

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A fork of Home Assistant's DOODS object detection integration that adds full point and click setup instead of YAML editing.

Mindmap

mindmap
  root((ha-doods))
    What it does
      UI config flow for DOODS
      Per-camera detection profiles
      Automatic YAML import
    Tech stack
      Python
      Home Assistant
      HACS
    Use cases
      Set up object detection cameras without YAML
      Run two detection zones on one camera
      Migrate existing YAML config automatically
    Audience
      Home Assistant users
      Smart home hobbyists
    Concepts
      Config flow UI
      Per-label confidence overrides
      Repair notice cleanup

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 and manage DOODS object detection cameras entirely through the Home Assistant UI.

USE CASE 2

Run two independent detection profiles on the same camera, such as a full-frame and a cropped zone.

USE CASE 3

Automatically migrate an existing YAML-based DOODS setup into the new UI with nothing lost.

What is it built with?

PythonHome AssistantHACS

How does it compare?

thebartoman/ha-doods0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a running DOODS detection server to connect to, the integration itself only handles the Home Assistant side.

Based on code licensed under the Apache License 2.0, which allows free use, modification, and distribution including commercially, as long as the license and notices are kept.

In plain English

ha-doods is a modified version of Home Assistant's built in DOODS integration, which connects Home Assistant to a Dedicated Open Object Detection Service to spot things like people or cars in camera images. The original built in version can only be set up by hand editing a configuration file. This fork replaces that with a full setup screen inside Home Assistant itself, under Settings then Devices and Services, so no text file editing is required. Through that setup screen you can connect to your DOODS server, choose which detector it should use, and then add, edit, or remove cameras one at a time. For each camera you can set separate confidence thresholds per label, so different objects can require different certainty levels before triggering, define a specific area of the image to watch, choose where an annotated snapshot image should be saved, and set how often that camera gets checked. It also allows more than one independent detection setup on the very same camera, for example one general profile watching the whole frame and a second one cropped to just a smaller zone, something the original YAML based setup could not do with a single camera entry. If you already had the old style setup in your configuration file, this integration automatically imports it the first time it starts after installing, carrying over every camera, label, confidence level, detection area, snapshot path, and scan interval exactly as they were. Once that import happens, Home Assistant shows a repair notice reminding you that the old configuration text is now redundant and safe to delete, and that notice clears itself automatically once you remove it. Installation is done either through HACS, a popular Home Assistant add-on manager, by adding this project as a custom repository, or manually by copying its folder into Home Assistant's custom components directory. The project notes that it has not yet been submitted back to the official Home Assistant codebase, and it is based on and credits the original built in DOODS integration, which is licensed under the Apache License 2.0.

Copy-paste prompts

Prompt 1
Walk me through installing this integration via HACS as a custom repository.
Prompt 2
Explain how per-camera confidence overrides and detection areas work in this integration.
Prompt 3
Show me how my existing YAML doods config gets imported automatically after installing this.
Prompt 4
How do I set up two separate detection profiles on the same camera?

Frequently asked questions

What is ha-doods?

A fork of Home Assistant's DOODS object detection integration that adds full point and click setup instead of YAML editing.

What language is ha-doods written in?

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

What license does ha-doods use?

Based on code licensed under the Apache License 2.0, which allows free use, modification, and distribution including commercially, as long as the license and notices are kept.

How hard is ha-doods to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ha-doods for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.