Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/NickM-27/swatch

Color detection in images to capture presense of known objects.
https://github.com/NickM-27/swatch

ai camera home-assistant home-automation object-detection opencv

Last synced: 8 days ago
JSON representation

Color detection in images to capture presense of known objects.

Host: GitHub
URL: https://github.com/NickM-27/swatch
Owner: NickM-27
License: apache-2.0
Created: 2022-03-24T20:15:12.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2023-10-01T14:43:19.000Z (about 1 year ago)
Last Synced: 2024-11-01T14:04:39.310Z (13 days ago)
Topics: ai, camera, home-assistant, home-automation, object-detection, opencv
Language: Python
Homepage:
Size: 445 KB
Stars: 67
Watchers: 4
Forks: 4
Open Issues: 13
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/funding.yml
- License: LICENSE

Awesome Lists containing this project

README

        



[![GitHub Release](https://img.shields.io/github/release/NickM-27/swatch.svg?style=flat-square)](https://github.com/NickM-27/swatch/releases)

[![Build Status](https://img.shields.io/github/workflow/status/NickM-27/swatch/Build?style=flat-square)](https://github.com/NickM-27/swatch/actions/workflows/build.yaml)

[![License](https://img.shields.io/github/license/NickM-27/swatch.svg?style=flat-square)](LICENSE)

# swatch

Color detection in images to capture presence of known objects.

## Why?

There is great object and face detection software out there, but sometimes AI detection is overkill or not suitable different types of objects. Swatch was created to create an easy to use API to detect the presence of objects of known color in expected places.

In this example you can see a cropped section of the street with a trash can. Then, using expected color bounds, the parts of the image that don't match the expected color are masked away. If a significant enough amount of pixels are left that match the color then it can be considered a true positive.

![street](https://user-images.githubusercontent.com/14866235/171231052-a7a4dbf0-569b-41f5-83c9-dd603ac3301e.png)

![street-bounding](https://user-images.githubusercontent.com/14866235/171231110-0192438d-d2ae-4e9b-8382-466be5c9b9c9.jpg)

![street-mask](https://user-images.githubusercontent.com/14866235/171231286-1c38ffbe-679d-40a0-8840-eff91f19eb59.jpg)

## Features

- REST API to be invoked by other applications

- Intuitive frontend UI to manage swatch and use the **Color Playground** to fine tune colors for the config.

- [HomeAssistant Integration](https://github.com/NickM-27/swatch-hass-integration)

- [HomeAssistant Addon](https://github.com/NickM-27/swatch-hass-addon)

## Web UI

### Color Playground



## Configuration

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

Check out [GitHub Docs](docs/config.md) for example and more instructions on creating the config file.

## Adding Objects

Check out the [Color Setup Docs](docs/finding-color-values.md) for how to setup objects and fine the color values to use.

## API References

Check out [GitHub Docs](docs/api.md) for the API reference.

## Contributing

**Contributions are very much welcome!**

For instructions on how to get started, see the [contributing section](CONTRIBUTING.md)

### Donations

If you would like to make a donation to support development, please use [GitHub Sponsors](https://github.com/sponsors/NickM-27).