How mbadolato/iterm2-color-schemes works
This repository is a catalog of terminal color schemes, with conversion into terminal/editor formats and tools for previewing schemes. The main workflow is to supply an iTerm color file or YAML scheme, then generate output from templates; users can also preview schemes interactively. README documents many format ports, while the excerpts chiefly show the generator and preview implementation, so format-specific internals are represented only at the directory level. The license and screenshot utilities are supporting catalog capabilities, not the main runtime path.
Main entry points: gen.py Theme generator · cli.py Preview command · __main__.py Screenshot generator · schemes Theme sources
Components 16
Scheme catalog
- Theme sources
schemes - YAML themes
yaml
Theme conversion
- Theme generator
tools/gen.py - Format templates
tools/templates - Terminal format ports
alacritty
Theme preview
- Preview command
tools/preview_theme/cli.py - Theme loader
tools/preview_theme/loader.py - ANSI preview renderer
tools/preview_theme/render.py - Color formatting
tools/preview_theme/colors.py - Terminal controls
tools/preview_theme/terminal.py
Catalog support
- License validation
tools/check_licenses.py - Theme screenshots
screenshots - Screenshot generator
tools/screenshot_gen/__main__.py - Image renderer
tools/screenshot_gen/renderer.py - Screenshot helpers
tools/screenshot_gen/helpers.py
Other components
- Theme user
Connections 17
- Theme user → Theme sources: selects scheme
README.md - Theme user → YAML themes: authors scheme
README.md - Theme sources → Theme generator: converts schemes
README.md - YAML themes → Theme generator: converts themes
README.md - Theme generator → Format templates: renders templates
README.md - Theme generator → Terminal format ports: generates formats
README.md - Theme generator → License validation: checks licenses
tools/gen.py - Theme user → Preview command: previews themes
README.md - Preview command → Theme loader: resolves themes
tools/preview_theme/cli.py - Preview command → ANSI preview renderer: renders preview
tools/preview_theme/cli.py - Preview command → Terminal controls: reads controls
tools/preview_theme/cli.py - Theme loader → Theme generator: loads theme data
tools/preview_theme/loader.py - ANSI preview renderer → Color formatting: formats colors
tools/preview_theme/render.py - Screenshot generator → Image renderer: renders images
tools/screenshot_gen/__main__.py - Screenshot generator → Screenshot helpers: reads scheme data
tools/screenshot_gen/__main__.py - Image renderer → Screenshot helpers: uses font charset
tools/screenshot_gen/renderer.py - Screenshot generator → Theme screenshots: writes screenshots