Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/doprz/dipc
Convert your favorite images and wallpapers with your favorite color palettes/themes
https://github.com/doprz/dipc
cli color-palette color-scheme hacktoberfest hacktoberfest2023 image-converter image-processing rust
Last synced: 13 days ago
JSON representation
Convert your favorite images and wallpapers with your favorite color palettes/themes
- Host: GitHub
- URL: https://github.com/doprz/dipc
- Owner: doprz
- License: apache-2.0
- Created: 2023-04-15T22:24:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-08-10T07:30:16.000Z (over 1 year ago)
- Last Synced: 2024-04-22T13:31:38.612Z (8 months ago)
- Topics: cli, color-palette, color-scheme, hacktoberfest, hacktoberfest2023, image-converter, image-processing, rust
- Language: Rust
- Homepage:
- Size: 5.89 MB
- Stars: 160
- Watchers: 3
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-rust - doprz/dipc
- awesome-rust - doprz/dipc - Convert your favorite images and wallpapers with your favorite color palettes/themes [](https://crates.io/crates/dipc) (Applications)
- fucking-awesome-rust - doprz/dipc - Convert your favorite images and wallpapers with your favorite color palettes/themes [](https://crates.io/crates/dipc) (Applications)
README
# dipc
[](https://crates.io/crates/dipc)
[](https://formulae.brew.sh/formula/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](https://unsplash.com/@hoffman11)
Adrien Vajas - [https://unsplash.com/@adrien_vj](https://unsplash.com/@adrien_vj)
Filipp Romanovski - [https://unsplash.com/@filipp_roman_photography](https://unsplash.com/@filipp_roman_photography)
## Installation
### Homebrew
```sh
brew install dipc
```
### Cargo
```sh
cargo install dipc
```
### From Source
To build and install from source, first checkout the tag or branch you want to install, then run
```sh
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] [FILE]...
Arguments:
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
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
Output image(s) name/path as a comma-delimited list
-d, --dir-output
Output directory name/path
-m, --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
```sh
# Save to current directory
dipc /*
# Save to output directory
dipc --dir-output /*
```
### Convert multiple images
```sh
dipc img0.png img1.png
# Rename files
dipc --output new-img0.png,new-img1.png img0.png img1.png
```
### Color palette variation(s)/style(s)
```sh
dipc --styles Style0 img.png
dipc --styles Style0,Style1 img.png
```
### CIELAB DeltaE method
```sh
dipc --method 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