Home

Awesome

dipc

crates.io

<picture> <source media="(prefers-color-scheme: dark)" srcset="images/dipc_dark.png"> <img alt="dipc light icon" src="images/dipc_light.png"> </picture>

doprz' image palette converter

Convert your favorite images and wallpapers with your favorite color palettes/themes

Color Palettes/Themes

Examples

dipc examples

Image Credits

Paul Bill - https://unsplash.com/@hoffman11

Adrien Vajas - https://unsplash.com/@adrien_vj

Filipp Romanovski - https://unsplash.com/@filipp_roman_photography

Installation

Homebrew

brew tap doprz/dipc
brew install dipc

Cargo

cargo install dipc

From Source

To build and install from source, first checkout the tag or branch you want to install, then run

cargo install --path .

This will build and install dipc in your ~/.cargo/bin. Make sure that ~/.cargo/bin is in your $PATH variable.

Usage

Convert your favorite images and wallpapers with your favorite color palettes/themes

Usage: dipc [OPTIONS] <PALETTE> [FILE]...

Arguments:
  <PALETTE>
          The color palette to use:
              - name of a builtin theme
              - path to a theme in JSON
              - a JSON string with the theme (starting with `JSON: {}`)
          Run with --help instead of -h for a list of all builtin themes

          Builtin themes:
              - catppuccin
              - dracula
              - edge
              - everforest
              - gruvbox
              - gruvbox-material
              - nord
              - onedark
              - rose-pine
              - solarized
              - tokyo-night

  [FILE]...
          The image(s) to process

Options:
  -s, --styles <VARIATIONS>
          The color palette variation(s) to use
          Run with --help instead of -h for a list of all possible values

          Possible values:
              - `all` to generate an image for each of the variations
              - `none` if you are using a flat theme without variations
              - or a comma-delimited list of the names of variations it should use

          [default: all]

  -o, --output <PATH>
          Output image(s) name/path as a comma-delimited list

  -d, --dir-output <PATH>
          Output directory name/path

  -m, --method <METHOD>
          CIELAB DeltaE method to use

          [default: de2000]

          Possible values:
          - de2000:  The default DeltaE method
          - de1994g: CIE94 DeltaE implementation, weighted with a tolerance for graphics
          - de1994t: CIE94 DeltaE implementation, weighted with a tolerance for textiles
          - de1976:  The original DeltaE implementation, a basic euclidian distance formula

  -v, --verbose...
          Verbose mode (-v, -vv, -vvv)

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

Convert all images in directory

# Save to current directory
dipc <PALETTE> <INPUT_DIR>/*

# Save to output directory
dipc --dir-output <PATH> <PALETTE> <INPUT_DIR>/*

Convert multiple images

dipc <PALETTE> img0.png img1.png

# Rename files
dipc --output new-img0.png,new-img1.png <PALETTE> img0.png img1.png

Color palette variation(s)/style(s)

dipc --styles Style0 <PALETTE> img.png
dipc --styles Style0,Style1 <PALETTE> img.png

CIELAB DeltaE method

dipc --method <METHOD> <PALETTE> img.png

License

dipc is dual-licensed under the terms of both the MIT License and the Apache License 2.0

SPDX-License-Identifier: MIT OR Apache-2.0