dipc

doprz' image palette converter

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

Color Palettes/Themes

• catppuccin
• dracula
• edge
• everforest
• gruvbox
• gruvbox-material
• nord
• onedark
• rose-pine
• solarized
• tokyo-night

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

Cargo

cargo install dipc

Homebrew

brew install dipc

Nix

dipc is available as a flake from GitHub or from nixpkgs

# From GitHub
nix run github:doprz/dipc
# From nixpkgs
nix run nixpkgs#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.

Arch Linux (Community Maintained)

For Arch Linux users, dipc is available in the Arch User Repository (AUR)

yay -S dipc

[!WARNING] This is a community-maintained version of dipc and not an official release.

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. Use `-` to read from stdin

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. Use `-` to write to stdout

  -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

Support for stdin/stdout

grim -g "$(slurp)" - | dipc catppuccin - -o - | swappy -f -
cat image.png | dipc gruvbox - -o - > themed.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