Skip to content

worldofunreal/Metapixel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Metapixel

Metapixel Hero

Python 3.8+ License: MIT

Metapixel is an intelligent tool that understands the colors in your images.

Whether you are a designer looking for the perfect palette or a developer building a search engine based on color, Metapixel uses computer vision to extract, name, and categorize the dominant colors in any digital asset.

✨ Why Metapixel?

Most color pickers give you a hex code. Metapixel gives you context.

  • Automated Extraction: No more manual sampling.
  • Semantic Naming: Instead of #000080, get "Navy Blue".
  • Visual Verification: Instantly see the palette compared against your original image.

🚀 Quick Start

1. Installation

Install the package directly from the repository:

pip install .

2. Extract Colors

Run it on any image to see the top 5 dominant colors:

metapixel image.png

🛠️ Key Features

Color Palette Generation

Extract up to any number of dominant colors using K-Means clustering.

metapixel photo.jpg --colors 8

Side-by-Side Visualization

Generate a comparison image to see how the extracted palette matches the original art.

metapixel photo.jpg --visualize

Developer-Friendly Output

Need to pipe this into another tool? Metapixel supports JSON and CSV.

metapixel logo.png --output json

📋 Command Line Interface

Option Command Description
Colors -k or --colors Number of colors to find (Default: 5)
Output -o or --output Choose text, json, or csv
Visual -v or --visualize Creates metapixel_viz.png

🏗️ Project Structure

  • metapixel/: The core engine and color database.
  • pyproject.toml: Simple installation management.
  • docs/assets/: Visual documentation assets.

Built with passion by World of Unreal.

About

Tools to identify metadata on images

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages