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

Lutgen CLI

Package Repositories

Install from source

git clone https://github.com/ozwaldorf/lutgen-rs
cd lutgen-rs
cargo install --path crates/cli

Crates.io

cargo install lutgen-cli

Documentation

Detailed documentation, examples, and more are available on The Lutgen Wiki

Lutgen Web

An interactive WebGL app is available at lut.sh/app, supporting every built-in palette with live previews.

Built from web/:

cd web
npm install
npm run dev

Note

Lutgen Web replaces lutgen-studio, the previous desktop GUI, which is no longer built or maintained. Existing studio releases remain published on crates.io and in distro repositories.

Rust Library

See the latest rust documentation on docs.rs/lutgen

Nix flake

A nix flake is available providing the lutgen package. The flake can be easily run via:

nix run github:ozwaldorf/lutgen-rs

Cache is provided via https://garnix.io

Development Shell

A development environment is also provided in the flake:

git clone https://github.com/ozwaldorf/lutgen-rs
cd lutgen-rs
nix develop

# inside dev shell
cargo run -r --bin lutgen

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