#monocol

monocol is a simple cli you can use to generate wpg compatible monochromatic color scheme files.

#Install

You need Go installed, then simply run:

go install git.sr.ht:~primalmotion/monocol

The package monocol and monocol-git are also available on the AUR.

#Usage

The simplest usage would be:

monocol --color ff0000

#Offsets and Steps

You can tweak the difference between the dark and light colors by using --offset. The bigger the number, the more difference there will be.

monocol -c ff0000 --offset 0.1

You can play with the --step parameter to decide how much of a jump there should be between a color and the next. The bigger the number, the less difference their will be between two adjacent colors.

monocol -c ff0000 --step 0.7

If you find the offset is not enough for the black or white color, you can overrides the --offset parameter for these colors using --offset-black (or -B) and/or --offset-white (or -W)

#Blending Red and Green

You can add blending colors for the traditional red and green ANSI colors:

monocol -c 333333 -R ff0000 -G 00ff00

This will blend the provided colors into color01 and color09 for red and color02 and color10 for green. You can control how much the colors should blend by setting --blend-factor (or -F). The bigger the number, the more diluted the colors will be.

#Exporting the scheme file

When you are ready, simply redirect to a file to get the json or the output to cat or less or anything to preview the file. monocol will detect the redirection and will generate the file instead of the preview. It will add the _command key that will contain the command that was used to generate the file.

$ monocol -c 222222 -R ff0000 -G 00ff00 -F 8 -s 0.4 -o 0.5 -F 8 -B 2 -f 999999 -W 0.2 | cat
{
  "_command": "monocol -c 222222 -R ff0000 -G 00ff00 -F 8 -s 0.4 -o 0.5 -F 8 -B 2 -f 999999 -W 0.2",
  "alpha": "80",
  "special": {
    "background": "#111111",
    "foreground": "#999999",
    "cursor": "#f3f3f3"
  },
  "colors": {
    "color00": "#111111",
    "color01": "#522a20",
    "color02": "#3b5832",
    "color03": "#3a3a3a",
    "color04": "#464646",
    "color05": "#535353",
    "color06": "#606060",
    "color07": "#999999",
    "color08": "#262626",
    "color09": "#60352a",
    "color10": "#4b6942",
    "color11": "#565656",
    "color12": "#6a6a6a",
    "color13": "#7e7e7e",
    "color14": "#949494",
    "color15": "#bbbbbb"
  }
}

#Options

There are several other options you can check by using --help:

monocol -h
Generate monochromatic 16 color palette

Usage:
  monocol [flags]

Flags:
  -A, --algo string          Algorithm to use to generate palette. Can be 'monochromatic', 'tones', 'shades', tints', or 'default' (default "default")
  -a, --alpha string         Set the alpha value. Between 0 and 100 (default "80")
  -b, --background string    Set the background color (default "#111111")
  -F, --blend-factor int     Blend factor for blend color. The smaller, the more vivid the blend will be (default 8)
  -G, --blend-green string   If set, blend the color with the usually green colors
  -R, --blend-red string     If set, blend the color with the usually red colors
  -c, --color string         Set the base color
  -C, --cursor string        Set the cursor color (default "#f3f3f3")
  -f, --foreground string    Set the foreground color (default "#f3f3f3")
  -h, --help                 help for monocol
  -o, --offset float         Set the offset between 0-7 and 8-15 (default 0.35)
  -B, --offset-black float   Set the offset for black. If 0, --offset applies
  -W, --offset-white float   Set the offset for white. If 0, --offset applies
  -s, --step float           Set the color step. The smaller the more different colors will be (default 0.9)