Skip to main content
Version: 0.1.22

Common workflows

Ready-to-use commands for popular theming scenarios.

Catppuccin Mocha​

tinct generate -i remote-json \
  --remote-json.url "https://raw.githubusercontent.com/catppuccin/palette/main/palette.json" \
  --remote-json.query "colors.mocha" \
  -o all

Catppuccin Latte (light)​

tinct generate -i remote-json \
  --remote-json.url "https://raw.githubusercontent.com/catppuccin/palette/main/palette.json" \
  --remote-json.query "colors.latte" \
  -o all -t light

Dracula​

tinct generate -i file \
  --file.colors "#282a36,#f8f8f2,#bd93f9,#ff79c6,#50fa7b,#f1fa8c,#8be9fd,#ff5555" \
  --file.hints "background=0,foreground=1,accent1=2,accent2=3,success=4,warning=5,info=6,danger=7" \
  -o all -t dark

Nord​

tinct generate -i file \
  --file.colors "#2e3440,#eceff4,#88c0d0,#81a1c1,#a3be8c,#ebcb8b,#5e81ac,#bf616a" \
  --file.hints "background=0,foreground=1,accent1=2,accent2=3,success=4,warning=5,info=6,danger=7" \
  -o all -t dark

Gruvbox Dark​

tinct generate -i file \
  --file.colors "#282828,#ebdbb2,#458588,#b16286,#98971a,#d79921,#689d6a,#cc241d" \
  --file.hints "background=0,foreground=1,accent1=2,accent2=3,success=4,warning=5,info=6,danger=7" \
  -o all -t dark

AI-generated themes​

Google Gemini​

Generate an image and extract colours:

export GOOGLE_API_KEY="your-api-key"

tinct generate -i google-genai \
  --prompt "sunset over rolling hills of tuscany" \
  -o all

Get an API key from Google AI Studio.

OpenRouter​

Use various AI models:

export OPENROUTER_API_KEY="your-api-key"

tinct generate -i openrouter \
  --prompt "cyberpunk city at night with neon lights" \
  --openrouter.model "flux-pro" \
  -o all

Get an API key from OpenRouter.

Ambient lighting​

Extract edge colours for LED strip synchronisation:

tinct generate -i image -p ~/Pictures/wallpaper.jpg \
  --image.extractAmbience \
  --image.ambienceRegions 8 \
  -o all

This extracts colours from 8 positions around the image edges (top, top-right, right, etc.) for monitor bias lighting.

Save and share themes​

Save to markdown​

tinct generate -i image -p ~/Pictures/wallpaper.jpg \
  -o markdown \
  --markdown.name "Mountain Sunset" \
  --markdown.include-thumbnail

Restore from markdown​

tinct generate -i markdown \
  --markdown.path ~/.config/tinct/themes/mountain-sunset.md \
  -o all

Hyprland ecosystem​

Apply theme to full Hyprland setup:

tinct generate -i image -p ~/Pictures/wallpaper.jpg \
  -o hyprland,hyprpaper,hyprlock,waybar,dunst,fuzzel

GNOME ecosystem​

Apply theme to GNOME desktop:

tinct generate -i image -p ~/Pictures/wallpaper.jpg \
  -o gnome-shell,gtk4,libadwaita

Note: Requires the User Themes extension for GNOME Shell.

KDE Plasma ecosystem​

Apply theme to KDE Plasma:

tinct generate -i image -p ~/Pictures/wallpaper.jpg \
  -o kde-plasma,qt5,qt6

After generation:

# Apply the color scheme
plasma-apply-colorscheme TinctDark  # or TinctLight

Terminal-focused​

Just terminals and multiplexers:

tinct generate -i image -p ~/Pictures/wallpaper.jpg \
  -o kitty,alacritty,ghostty,zellij

Extract without generating​

Just see the colour palette:

tinct extract -i image -p ~/Pictures/wallpaper.jpg --preview

Save palette to JSON:

tinct extract -i image -p ~/Pictures/wallpaper.jpg -o palette.json --format json

Next steps​