tint

name	tint
description	Use this skill when the user wants to recolor an image using a terminal color theme palette (Catppuccin, Gruvbox, Everforest, Tokyonight, etc.).

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 version
• tint _ _ — 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-open to prevent the default viewer from opening the result
• The -i and -t flags are required for recoloring
• Output path defaults to <input_filename>_themed_<theme-flavor>.<input_format>