Skip to main content

Generate iTerm2 colors from an image

Project description

PyPi Status PyPi Version Python Versions

This theme generator will produce a color set for iTerm2 from an image.

Check out the gallery


From pip:

$pip install --upgrade iterm-theme-generator


To generate a color set from an image:

$ iterm_theme_generator <path-to-image> --parent <your-profile>

This will generate colors and create iTerm2 profile in its DynamicProfiles directory. This theme profile will inherit profile you mention with –parent option. Go to the profiles tab and select this new profile as default and restart iTerm. Now, when you change theme again iTerm will load it dynamically, so no need to restart again.


usage: iTerm2 Theme Generator [-h] [--parent PROFILE] [--out FILE]
                              [--tiled TILED] [--blend BLEND]
                              [--transparency VALUE] [--contrast CONTRAST]
                              [--saturation-min MIN] [--saturation-max MAX]
                              [--brightness-min MIN] [--brightness-max MAX]
                              [--rotate TIMES] [--inverted] [--reversed]

Generate iTerm2 color scheme based on an image

positional arguments:
  IMAGE                 Image to process

optional arguments:
  -h, --help            show this help message and exit
  --parent PROFILE      Profile this theme will inherit. Default:
  --out FILE            Output file. Default:
  --tiled TILED         Tile the image. Default: False
  --blend BLEND         Blend(0.0-1.0). Default: 0.10
  --transparency VALUE  Transparency(0.0-1.0). Default: 0.0
  --contrast CONTRAST   Contrast(0.0-1.0). Default: 0.0
  --saturation-min MIN  Minimal saturation(0.0-1.0). Default: 0.0
  --saturation-max MAX  Maximal saturation(0.0-1.0). Default: 1.0
  --brightness-min MIN  Minimal brightness(0.0-1.0). Default: 0.0
  --brightness-max MAX  Maximal brightness(0.0-1.0). Default: 1.0
  --rotate TIMES        Rotate colors order N times(0-7). Default: 0
  --inverted            Invert colors. Default: No
  --reversed            Reverse colors order. Default: No
  --no-background       Disable background image. Useful if using


Some iTerm features are exposed through the generator such as tiling, blending, contrast.

The generator provides rudimentary color control, including:

  • saturation min/max bound
  • brightness min/max bound
  • rotation and reversion of the generated color set
  • color inversion

Using these features will allow you to capture an awesome color set that will fit your background image neatly.

Thanks To

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for iterm-theme-generator, version 0.3.8
Filename, size File type Python version Upload date Hashes
Filename, size iterm_theme_generator-0.3.8-py3-none-any.whl (9.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size iterm-theme-generator-0.3.8.tar.gz (5.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page