🎨 HueHunter: A command-line tool for quickly identifying and naming dominant colors in digital images. 🌈

• Detects dominant colors in an image using KMeans clustering.
• Maps detected colors to the nearest CSS3 color names for easy reference.
• Simple command-line interface for straightforward usage.

Before installing HueHunter, ensure you have Python installed on your system. HueHunter works best with Python 3.6 or newer.

To install HueHunter directly from the source:

1. First, clone the repository:

   git clone https://github.com/txhno/huehunter.git

2. Navigate to the huehunter directory:

   cd huehunter

3. Install the package:

   pip install .

This series of commands will download the HueHunter source, move you into the HueHunter project directory, and install HueHunter along with its dependencies directly from the source code. This method is particularly useful if you plan to modify the code or contribute to the project.

HueHunter relies on several third-party libraries:

• OpenCV-Python: For image processing.
• Pillow: For image manipulation tasks.
• numpy: For numerical operations.
• scikit-learn: For performing KMeans clustering to determine dominant colors.
• webcolors: For converting RGB values to human-readable color names.

These dependencies are automatically installed when you install HueHunter via pip.

Once installed, you can run HueHunter directly from your terminal. To analyze an image and print out its dominant colors, use the following syntax:

huehunter path/to/your/image.jpg

huehunter example.jpg

Output:

Image Name: example.jpg
Detected Colors: silver, darkslategray, dimgray

This output tells you the image name and lists the dominant colors detected in the image.

Contributions to HueHunter are welcome! If you have suggestions for improvements or new features, feel free to fork the repository, make your changes, and submit a pull request.

HueHunter is open-sourced under the MIT license. See the LICENSE file for more details.

For support or to contact the developers, please send an email to [[email protected]].

Thank you for using HueHunter!