lutgen
| Crates.io | lutgen |
| lib.rs | lutgen |
| version | |
| source | src |
| created_at | 2023-05-13 03:07:22.810876+00 |
| updated_at | 2025-04-16 02:02:27.966239+00 |
| description | A blazingly fast interpolated LUT utility for arbitrary and popular color palettes. |
| homepage | https://github.com/ozwaldorf/lutgen-rs |
| repository | https://github.com/ozwaldorf/lutgen-rs |
| max_upload_size | |
| id | 863503 |
| Cargo.toml error: | TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include` |
| size | 0 |
(ozwaldorf)
documentation
https://docs.rs/lutgen
README
lutgen-rs
A blazingly fast interpolated LUT utility for arbitrary and popular color palettes. Theme any image to your desktop colorscheme!
Example Output
Hald Cluts
Catppuccin Mocha
Gruvbox Dark
Nord
Color Corrections
Original Image
Catppuccin Mocha
Gruvbox Dark
Nord
CLI
Installation
Source
git clone https://github.com/ozwaldorf/lutgen-rs
cd lutgen-rs
cargo install --path .
Nix flake
A nix flake is available and can be run easily with:
nix run github:ozwaldorf/lutgen-rs
Cache is provided via https://garnix.io
Documentation
Detailed cli documentation is available at docs/README.md.
Examples
Correcting an image
# Builtin palette
lutgen apply -p catppuccin-mocha docs/example-image.jpg -o mocha_version.jpg
# Custom colors
lutgen apply docs/example-image.jpg -- "#ABCDEF" ffffff 000000
# Custom palette file with whitespace separated hex colors (linux example shown)
echo "fff 555 000 abcdef deadbe" > ~/.config/lutgen/my-palette-name
lutgen apply docs/example-image.jpg -p my-palette-name
# Multiple images
lutgen apply image1.png image2.png *.jpg -p catppuccin-mocha
# Using an external LUT
lutgen apply --hald-clut mocha_lut.png docs/example-image.jpg
Generating a standalone LUT for external or manual usage
# Builtin palette
lutgen generate -p catppuccin-mocha -o mocha_lut.png
# Custom colors
lutgen generate -o custom.png -- "#ABCDEF" ffffff 000000
# Custom palette file with whitespace separated hex colors (linux example shown)
echo "fff 555 000 abcdef deadbe" > ~/.config/lutgen/my-palette-name
lutgen generate -p my-palette-name
Preview palletes
# Preview all palettes
lutgen palette all
# Copy a palette to the custom palette dir for modifying and overriding
lutgen palette carburetor > ~/.config/lutgen/carburetor
# Finding a palette name with grep
lutgen palette names | grep 'gruvbox'
Correcting videos (using ffmpeg):
ffmpeg -i input.mkv -i hald_clut.png -filter_complex '[0][1] haldclut' output.mp4
Zsh Completions:
lutgen --bpaf-complete-style-zsh > _lutgen
sudo mv _lutgen /usr/local/share/zsh/site-functions/
Library
See the latest documentation on docs.rs
Planned features
- Interpolation for more accuracy when correcting with low level luts (<16)
- Hardware acceleration for applying luts to images
Sources
- Hald Cluts: https://www.quelsolaar.com/technology/clut.html
- Editing with Hald Cluts: https://im.snibgo.com/edithald.htm
- Sparse Hald Cluts: https://im.snibgo.com/sphaldcl.htm
- RBF Interpolation: https://en.wikipedia.org/wiki/Radial_basis_function_interpolation
- Shepard's method: https://en.wikipedia.org/wiki/Inverse_distance_weighting
- Oklab Colorspace: https://bottosson.github.io/posts/oklab/
Special Thanks
- Gingeh for the initial inspiration and imagemagick approach
- The Catppuccin Org for continual feedback and support along the way
- Stonks3141 for maintaining the Alpine Linux package
- All the nixpkgs maintainers