# Swatch

Swatch is a lightweight API that detects objects of a known color in expected places within images, giving home automation users a simpler alternative to AI-based object detection for predictable targets. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2231/swatch

## Description

Swatch is a lightweight API that detects objects of a known color in expected places within images, giving home automation users a simpler alternative to AI-based object detection for predictable targets.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

18/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (last commit 1147 days ago)
- Popular: 39 (89 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 10 (3 serious findings, 8 minor, CI, tests)

## Security check

3 serious findings: Uses numpy 1.22., which has a known critical vulnerability; Uses pyyaml 6.0., which has a known critical vulnerability; Uses pyyaml 6.0., which has a known critical vulnerability.
Automated checks on commit 03b05b2, 10 Nov 2026. Not an audit.

## Links

- GitHub: https://github.com/NickM-27/swatch
- Docker Hub: https://hub.docker.com/repository/docker/crzynik/swatch/general
- Unraid: https://ca.unraid.net/apps/swatch-1vxizbe1svkpwu?q=swatch

## Common questions

### Does Swatch require a config file before running?

Yes. A config.yaml file must be created and mapped to /config.

### How do I fine-tune colors for detected objects?

Use the frontend Color Playground to adjust color values for the config.

### Can Swatch be used with Home Assistant?

The README lists a Home Assistant integration and a Home Assistant Addon.

### How can other applications interact with Swatch?

Swatch exposes a REST API that other applications can invoke.

---
Source: Our Local Host (https://ourlocalhost.com/app/2231/swatch), the self-hosted and open-source app directory.
