Quick Start

Preview colors from an image

colorgen wallpaper.png --preview

This extracts colors and prints them as colored blocks in your terminal.

Generate a config

colorgen wallpaper.png --config kitty --theme dark

This writes a color file to ~/.config/kitty/colors/wallpaper-dark.conf but doesn't activate it.

Generate and apply

colorgen wallpaper.png --config kitty --theme dark --apply

This writes the color file AND updates your kitty.conf to include it. The old theme gets commented out, not deleted — you can switch back by editing the config.

Preview + generate + apply

colorgen wallpaper.png --preview --config kitty --theme dark --apply

Multiple targets at once

colorgen wallpaper.png --config kitty awesome rofi --theme dark --apply

All targets

colorgen wallpaper.png --full-config --theme dark --apply

Light theme

colorgen wallpaper.png --config kitty --theme light --apply

Tips

• Preview first: Use --preview to see what you're getting before applying
• Existing include needed: with --apply, the main config file of kitty, AwesomeWM, rofi or Waybar must already exist, or that target is skipped (the color file is still written); dunst has no main config to check. For kitty, AwesomeWM and rofi the file must also already have a theme include line, such as include colors/<name>-<theme>.conf in kitty.conf. colorgen swaps that line and does not add one. Waybar is the exception: if there is no import, colorgen adds one at the top of style.css.