@xeyossr/tint
v0.1.2
Published
🎨 A terminal tool that modifies image colors according to your selected palette, optimizing your visual experience.
Maintainers
Readme
TINT (Terminal Image Normalizer & Tinter)
TINT (Terminal Image Normalizer & Tinter) replaces the colors of an image with the closest matches from a palette you choose. This lets you easily adapt any image to fit your desired color scheme. It’s built with Node.js and is very easy to use.
TINT comes with several built-in palettes, but you can also provide your own. See #Usage below for more information.
[!NOTE] TINT is still in pre-release. If you find any bugs, please report them by opening an issue.
Demo Gallery
| Original | Catppuccin Latte | Catppuccin Mocha | Dracula |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
|
|
|
|
|
| Everforest | Gruvbox | Kanagawa | Rose Pine |
| ----------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
|
|
|
|
|
Installation
To install TINT, npm must be installed on your system.
sudo npm install -g @xeyossr/tintUsage
Usage: tint [options]
Options:
-i, --input <path> input image path
-o, --output <path> output image path
-t, --theme <name> theme name
-p, --palette <palette> custom palette (path to JSON file or flat RGB list)
--update update TINT to the latest version
-h, --help display help for command# Apply a theme to an image
tint -i input.png -o output.png -t "Catppuccin Mocha"
# Use a custom palette (from a file)
tint -i input.jpg -o output.png -p ./my-palette.json
# Use a custom palette (inline RGB list)
tint -i pic.webp -o recolored.png -p "[255,0,0, 0,255,0, 0,0,255]"
# Update to the latest version
tint --updateThemes
Available themes:
- Catppuccin Frappe
- Catppuccin Latte
- Catppuccin Macchiato
- Catppuccin Mocha
- Dracula
- Everforest
- Gruvbox
- Kanagawa
- Nord
- Rose Pine
- Rose Pine Dawn
- Rose Pine Moon
- Solarized
- Tokyo NightIssues
If you encounter a bug or have a suggestion, please report it via Issues.
License
This project is licensed under the GPL-3.0 License.
