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…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
18/100 Low
- Maintained
- 0last commit 1147 days ago
- Popular
- 3989 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 103 serious findings, 8 minor, CI, tests
Based on 4 of 5 factors.
Security check: 3 serious findings
- Uses numpy 1.22., which has a known critical vulnerability (PyPI)
- Uses pyyaml 6.0., which has a known critical vulnerability (PyPI)
- Uses pyyaml 6.0., which has a known critical vulnerability (PyPI)
Automated checks on commit 03b05b2, 10 Nov 2026. Not an audit.
Availability: platform listings confirmed today, links checked 29 days ago
- GitHub stars
- 89
- Open issues
- 13
- Last commit
- 2023-10-01
- Latest release
- 3.1.1
- License
- Apache-2.0
- Activity
- stale
Checked 9 days ago - source: GitHub (NickM-27/swatch)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Create the env file first Copy .env.example to .env.local and fill in your API tokens or local settings. If you skip this, the app may start but not have the values it needs to work. source
- Configuration Create a config.yml file in the config directory before starting Swatch; a sample is provided in the repository. source
Fetched 39 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
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.
Answers sourced from github.com
Community
- All things Swatch - Reddit (reddit)
- SWATCH alternative with gui / Docker? : r/selfhosted - Reddit (reddit)
- [Discussion] What are your thoughts on Swatch watches? - Reddit (reddit)
Collected 53 days ago - public community threads