Color Toolkit#

Convert colors, check WCAG contrast, generate palettes, and manipulate colors. Pure Python, no dependencies.

Quick Start#

bash

# Convert between formats (accepts #hex, rgb(), hsl(), CSS names, or r,g,b)
python3 scripts/color_toolkit.py convert '#ff6347'
python3 scripts/color_toolkit.py convert tomato
python3 scripts/color_toolkit.py convert 'rgb(52, 152, 219)'

# WCAG contrast check
python3 scripts/color_toolkit.py contrast '#333333' '#ffffff'

# Generate palettes
python3 scripts/color_toolkit.py palette '#3498db' -s triadic
python3 scripts/color_toolkit.py palette '#e74c3c' -s monochromatic -n 7

# Modify colors
python3 scripts/color_toolkit.py modify '#3498db' --op lighten --amount 20
python3 scripts/color_toolkit.py modify coral --op darken --amount 15

# Mix colors
python3 scripts/color_toolkit.py mix '#ff0000' '#0000ff' --weight 0.5

# Random colors
python3 scripts/color_toolkit.py random -n 5

# Search CSS named colors
python3 scripts/color_toolkit.py lookup green

Commands#

CommandDescriptionconvertConvert any color to HEX, RGB, HSL, HSV, and CMYK.contrastWCAG contrast ratio between foreground and background. Reports AA/AAA compliance.paletteGenerate palettes: complementary, analogous, triadic, split-complementary, monochromatic.modifyAdjust color: lighten, darken, saturate, desaturate. --amount 0-100.mixBlend two colors. --weight controls the ratio (0.0 = all color1, 1.0 = all color2).randomGenerate random colors. -n sets count.lookupSearch CSS named colors by partial name.

All commands support --json for structured output.

Accepted Color Formats#

#hex (3 or 6 digit), rgb(r, g, b), hsl(h, s%, l%), r,g,b, or any CSS color name (e.g., tomato, steelblue, coral).