tint Plugin
Palette-based image recoloring CLI. Recolor images using popular terminal color themes like Catppuccin, Gruvbox, Everforest, and Tokyonight.
Commands
Image Processing
tint image recolor— Recolor an image using a terminal color theme
Theme Management
tint theme list— List all available themes and their flavors
Utility
tint self version— Print tint versiontint _ _— Passthrough to tint CLI
Usage Examples
- "Recolor my wallpaper with the Catppuccin theme"
- "Apply the Gruvbox palette to this image"
- "List all available color themes"
- "Recolor an image with a darker luminosity"
Installation
go install github.com/ashish0kumar/tint@latest
Examples
# Recolor using Catppuccin (default flavor)
tint image recolor -i input.jpg -t catppuccin
# Recolor with a specific flavor
tint image recolor -i image.png -t catppuccin-latte
# Recolor and save to a specific path
tint image recolor -i wallpaper.jpg -t gruvbox -o gruvbox-wallpaper.jpg
# Make the image slightly brighter
tint image recolor -i photo.jpeg -t gruvbox --luminosity 1.2
# Use Everforest theme with smoother gradients
tint image recolor -i bg.png -t everforest --nearest 50
# Tokyonight with stronger interpolation
tint image recolor -i wallpaper.png -t tokyonight --power 3.5
# List all themes and flavors
tint theme list
Key Features
- Palette-based image recoloring using terminal themes
- Support for popular themes: Catppuccin, Gruvbox, Everforest, Tokyonight
- Theme flavors (e.g. catppuccin-latte, catppuccin-mocha)
- Luminosity adjustment (darker or brighter)
- Interpolation control via nearest colors count
- Shepard's Method power adjustment for gradient smoothing
- JPEG and PNG input support
- JPEG and PNG output support
- Automatic output filename generation
Notes
- Processing large images (e.g. 50MP, ~7071x7071) can use significant RAM (over 500 MiB)
- Ensure your system has enough free memory before processing large images
- Use
--not-opento prevent the default viewer from opening the result - The
-iand-tflags are required for recoloring - Output path defaults to
<input_filename>_themed_<theme-flavor>.<input_format>