iterm-theme-generator 0.3.1

Generate iTerm2 colors from an image

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

Check out the gallery

Contents

• Installation

• Usage

• Features

• Thanks To

• Links

Installation

From pip:

$pip install --upgrade iterm-theme-generator

Usage

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.

Options:

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]
                              [--no-background]
                              IMAGE

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:
                        'Default.Profile'
  --out FILE            Output file. Default:
                        /Users/m4yers/Library/Application
                        Support/iTerm2/DynamicProfiles/theme.json
  --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
                        transparency.

Features

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

• radiosilence for the original script

• metakirby5 for colorz util

Links

• PyPI

• GitHub