🎨 colorspec

Terminal color scheme manager - preview, convert, and validate color themes across different terminal formats.

Features

• Preview: View color schemes directly in your terminal
• Convert: Transform between formats (iTerm2, Alacritty, Kitty, Windows Terminal, etc.)
• Validate: Check color contrast ratios for accessibility
• Generate: Create new schemes from base colors
• Export: Save in multiple formats simultaneously

Installation

pip install colorspec

Or use directly:

python colorspec.py --help

Quick Start

Preview a color scheme:

colorspec preview dracula.json

Convert between formats:

colorspec convert input.itermcolors --to alacritty --output theme.yml

Validate accessibility:

colorspec validate theme.json --wcag aa

Supported Formats

• iTerm2 (.itermcolors)
• Alacritty (.yml)
• Kitty (.conf)
• Windows Terminal (.json)
• Xresources (.Xresources)
• VS Code Terminal (.json)

Color Scheme Structure

{
  "name": "My Theme",
  "author": "Your Name",
  "colors": {
    "background": "#1e1e1e",
    "foreground": "#d4d4d4",
    "black": "#000000",
    "red": "#cd3131",
    "green": "#0dbc79",
    "yellow": "#e5e510",
    "blue": "#2472c8",
    "magenta": "#bc3fbc",
    "cyan": "#11a8cd",
    "white": "#e5e5e5",
    "brightBlack": "#666666",
    "brightRed": "#f14c4c",
    "brightGreen": "#23d18b",
    "brightYellow": "#f5f543",
    "brightBlue": "#3b8eea",
    "brightMagenta": "#d670d6",
    "brightCyan": "#29b8db",
    "brightWhite": "#ffffff"
  }
}

Examples

Check out the examples/ directory for popular color schemes like Dracula.

License

MIT License - see LICENSE file for details