Skip to content

jmylchreest/tinct

Repository files navigation

Tinct

An extensible colour palette generator and theme manager for unified theming across your entire environment

Generate colour palettes from images, AI, remote themes, or manual specifications. Apply them consistently to terminals, desktop environments, window managers, and external devices.

Go Version License Documentation

Installation

Arch Linux (AUR):

yay -S tinct-bin

From Go:

go install github.com/jmylchreest/tinct/cmd/tinct@latest

From source:

git clone https://github.com/jmylchreest/tinct.git
cd tinct && go build -o tinct ./cmd/tinct

Quick start

# Extract and preview colours from an image
tinct extract -i image -p ~/Pictures/wallpaper.jpg

# Apply theme to all configured applications
tinct generate -i image -p ~/Pictures/wallpaper.jpg -o all

# Use a popular theme (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

Features

  • Multiple input sources - Images, AI generation, remote themes (JSON/CSS), manual specification
  • 25+ applications - Terminals, desktops, window managers, bars, editors
  • Smart categorisation - Auto-assigns semantic colours with WCAG contrast checking
  • Plugin architecture - Extend with custom inputs/outputs in any language
  • Theme portability - Save and share complete themes as markdown files

Supported applications

Category Applications
Terminals Alacritty, Ghostty, Kitty, Konsole, Ptyxis
Desktop GNOME Shell, KDE Plasma, GTK3/4, Libadwaita, Qt5/6
Hyprland Hyprland, Hyprpaper, Hyprlock
Bars & Launchers Waybar, Dunst, SwayOSD, Fuzzel, Walker, Wofi
Editors Neovim, Zellij

Documentation

Full documentation is available at jmylchreest.github.io/tinct

Contributing

Contributions welcome! See the documentation for development guides.

License

MIT License - see LICENSE

About

A plugin based theme/templating tool inspired by PyWal and Mutugen, with multiple input mechanisms.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages