termtint

Terminal color theming based on directory - colorizes iTerm2 tabs and backgrounds based on .termtint config files.

Installation

cargo install termtint

Or build from source:

cargo build --release
cp target/release/termtint ~/.local/bin/  # or somewhere in your PATH

Add to your .zshrc:

eval "$(termtint hook zsh)"

Usage

Create a .termtint file in any directory. When you cd into that directory (or any subdirectory), terminal colors will automatically change.

Config Formats

Hex color (simplest):

#ff5500

Colors can be specified in multiple formats:

• 6-digit hex: #ff5500 or ff5500
• 3-digit hex: #f50
• RGB: rgb(255, 85, 0)
• HSL: hsl(20, 100%, 50%)
• Named colors: red, tomato, dodgerblue, etc.

TOML (more control):

tab = "#00ff00"
background = "#001100"  # optional, defaults to 15% of tab color

Auto (deterministic hash-based color):

auto

Commands

termtint hook zsh       # Output shell hook (add to .zshrc)
termtint apply          # Apply colors for current directory
termtint reset          # Reset colors to defaults
termtint init           # Create .termtint with auto color
termtint init '#ff5500' # Create .termtint with specific color
termtint init '#ff5500' --background '#1a0800'  # With custom background
termtint init -f        # Overwrite existing .termtint

How It Works

1. Shell hook calls termtint apply on every directory change
2. apply searches up from current directory for .termtint
3. If found, parses config and emits iTerm2 escape sequences
4. State is tracked in ~/.cache/termtint/ to avoid redundant updates