Find pokemon that match your image's color palette! Upload any image and discover which Pokemon share similar colors using computer vision and color theory.
Ever wondered which Pokemon would blend perfectly with your favorite photo? This CLI tool analyzes the dominant colors in any image and finds Pokemon with the most similar color palettes.
# Find Pokemon that match your sunset photo
pokepalette sunset.jpg -t 5
# Results:
# charizard
# moltres
# arcanine
# raikou -s
# charizard --form mega-yShiny variants are differentiated with -s. Different forms will be indicated with --form <form>. This format can be plugged directly into krabby.
cargo install pokepaletteSee crates.io/crates/pokepalette for more info.
Add to your flake inputs:
inputs.pokepalette.url = "github:aig77/pokepalette";Then add to your packages:
# NixOS configuration.nix
environment.systemPackages = [
inputs.pokepalette.packages.${pkgs.system}.default
];
# Or home-manager
home.packages = [
inputs.pokepalette.packages.${pkgs.system}.default
];Or run directly:
nix run github:aig77/pokepalette -- image.pngpokepalette <IMAGE> [OPTIONS]| Option | Description |
|---|---|
-t, --top-k <NUMBER> |
Number of Pokemon returned (default: 10) |
-g, --gen <GEN> |
Filter by generation (see below) |
-v, --verbose |
Print additional color/score info |
--no-shiny |
Filter out shinies |
--all-shiny |
Filter out non-shinies |
--no-mega |
Filter out megas |
--all-mega |
Filter out non-megas |
--no-gmax |
Filter out gmax |
--all-gmax |
Filter out non-gmax |
--no-regional |
Filter out regional variants |
The -g, --gen option supports flexible generation filtering:
| Format | Example | Description |
|---|---|---|
| Single | -g 1 |
Only Gen 1 Pokemon |
| Range | -g 1-3 |
Gen 1, 2, and 3 Pokemon |
| List | -g 1,4,8 |
Gen 1, 4, and 8 Pokemon |
Valid generations: 1-9 (Kanto through Paldea)
# Basic usage - find top 10 matching Pokemon
pokepalette my_photo.jpg
# Get more results
pokepalette landscape.png -t 20
# Only classic Gen 1 Pokemon
pokepalette retro.png -g 1
# Gen 1-3 Pokemon, no shinies
pokepalette wallpaper.jpg -g 1-3 --no-shiny
# Only shiny Mega Pokemon from specific gens
pokepalette cool.png -g 1,3,6 --all-shiny --all-megaThis project originally started as a small side-quest while I was ricing my Arch Linux setup with neofetch and pywal.
I wanted to find Pokémon sprites that matched the colors of my terminal and wallpaper, but I couldn’t find any tool that did this automatically. So I decided to build one myself.
This tool is best paired with krabby, since the results are formatted to work directly with the krabby CLI tool.
That means you can generate palettes with PokePalette and instantly use them in krabby without extra conversion.
Although I’ve since moved on to using NixOS, I still wanted to finish this project. It’s been a fun way to explore Rust, experiment with computer vision, and learn more about color theory.
What started as a simple utility for my own setup has grown into a project I hope others can also find fun or useful.
The tool uses several computer vision and color theory techniques to find accurate matches:
Color Quantization: Extracts dominant colors from your image using uniform quantization
LAB Color Space: Converts colors to LAB space for perceptually uniform color comparisons
Euclidean Distance: Calculates color similarity using euclidean distance in LAB space
Common image formats: JPG, JPEG, PNG, BMP, GIF Any image size (larger images may take longer to process)
This project started as a fun way to learn Rust, so I'd love to hear your thoughts! Especially:
Accuracy improvements: Know better color matching algorithms?
Performance optimizations: Ideas for faster color extraction?
Feature suggestions: What would make this more useful or fun?
Feel free to open issues or PRs!
Pokemon data sourced from krabby. This is an awesome project, check it out!
This project is licensed under the MIT License