Skip to content

palettize list

The list command group explores presets and export formats. palettize formats is the fuller view of formats: it also prints each format’s options.

Terminal window
palettize list presets
palettize list presets --search blue --category sequential --limit 20
palettize list presets --namespace colorbrewer --swatch
palettize list categories
OptionShortDefaultDescription
--search-qKeep presets whose name contains this text.
--categorysequential, diverging, cyclic, qualitative, or miscellaneous.
--namespaceFilter by publisher, e.g. colorbrewer.
--swatchDraw a gradient beside each row.
--limit50Maximum rows. 0 shows every match.

palettize list categories prints each category and how many presets it contains.

This displays a table of all preset names from the cmap library plus any custom presets.

Example output:

Available Preset Palettes
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Name ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ custom/grayscale │
│ custom/simple_rgb │
│ inferno │
│ magma │
│ plasma │
│ viridis │
│ ... │
└──────────────────────────────────────┘
Terminal window
palettize presets viridis

Prints that preset’s category, source, and a short swatch. A missing name suggests palettize list presets --search.

Once you find a preset name, use it with show or create:

Terminal window
palettize show viridis
palettize create viridis -f gdal -o viridis.txt

Presets come from multiple sources:

  • Built-in custom presets: Prefixed with custom/ (e.g., custom/grayscale)
  • cmap library presets: Standard scientific colormaps like viridis, magma, inferno, plasma, etc.
Terminal window
palettize list exporters
palettize formats # same list, plus whether each format uses --domain and --scale
palettize formats gdal # options, types, and defaults for one format

Built-in identifiers: gdal, qgis, sld, titiler, mapgl, observable, gee, css, svg, gimp, json, hex, rgba, hsl.

Use the identifier (first column) with the --format option:

Terminal window
# Single format
palettize create viridis -f gdal -o output.txt
# Multiple formats
palettize create viridis -f gdal,qgis,mapgl -o "{name}_{format}.{ext}"

If you’ve installed additional exporter plugins, they will also appear in this list. See Custom Exporters for information on creating your own.