CLI Overview

Palettize provides a command-line interface for previewing, checking, and exporting colormaps.

Basic Usage

palettize [OPTIONS] COMMAND [ARGS]

Global Options

These options are available for all commands:

Option	Description
`--version`, `-V`	Show the application version and exit
`--verbose`, `-v`	Increase output verbosity. Use `-vv` for more detail
`--help`	Show help message and exit

Commands

Command	Description
`show`	Preview a colormap in the terminal, or write a PNG or SVG
`analyze`	Check lightness, uniformity, and color-vision safety
`create`	Export a colormap, or save it as a reusable JSON file
`formats`	List export formats and the options each one accepts
`list presets`	Search the preset catalog
`list categories`	List preset categories
`list exporters`	List export formats (same as `formats`)
`presets`	Show one preset’s metadata
`info`	Show the version, links, and a banner

Exit Codes

Code	Meaning
`0`	Success
`1`	Usage error (invalid arguments)
`2`	Invalid color
`3`	Export error
`4`	Resource not found (preset or exporter)
`5`	Unexpected error

Color Input Formats

When specifying colors via --colors, you can use:

Named colors: red, blue, midnightblue, gold
Hex colors: #ff0000, #0000ff
Comma-separated lists: --colors "red,white,blue" or --colors red --colors white --colors blue

Colors are parsed via the ColorAide library, which supports many formats.

Examples

# Show help
palettize --help

# Show version
palettize --version

# Run with verbose output
palettize -v show viridis

# Run with extra verbose output (includes tracebacks on error)
palettize -vv create viridis -f gdal -o output.txt