colorgen 1.0.0

Generate terminal colorschemes from images

colorgen

Generate terminal colorschemes from images for kitty, AwesomeWM, and rofi.

Repo: Codeberg (primary) | GitHub (mirror)

Documentation | PyPI

Install

pip install colorgen

Or from source:

git clone https://codeberg.org/piotrkrzysztof/colorgen.git
cd colorgen
make install

Requires Python 3.12+.

Usage

# Preview colors from an image
colorgen wallpaper.png --preview

# Generate and apply a kitty colorscheme
colorgen wallpaper.png --config kitty --theme dark --apply

# Multiple targets
colorgen wallpaper.png --config kitty awesome rofi --apply

# All targets
colorgen wallpaper.png --full-config --theme dark --apply

When applying, the old theme gets commented out, not deleted.

How it works

Extracts 10 dominant colors from the image via K-means clustering, then maps them to a 19-color terminal palette (bg, fg, cursor, colors 0-15) based on hue diversity and luminance.

Supported targets

• kitty - terminal color config
• AwesomeWM - window manager theme
• rofi - launcher theme (adi1090x/rofi layout)

Development

make install   # install deps
make test      # run tests
make lint      # check code style

License

GPL-3.0-or-later

Author

Piotr Krzysztof Lis - Codeberg | GitHub

Built with Pylette for color extraction.