https://github.com/ozwaldorf/lutgen-rs
Blazingly fast interpolated LUT generator and applicator for arbitrary and popular color palettes.
https://github.com/ozwaldorf/lutgen-rs
cli color-grading colorscheme hald-clut linux-desktop rice rust theming wallpaper
Last synced: 2 months ago
JSON representation
Blazingly fast interpolated LUT generator and applicator for arbitrary and popular color palettes.
- Host: GitHub
- URL: https://github.com/ozwaldorf/lutgen-rs
- Owner: ozwaldorf
- License: mit
- Created: 2023-05-13T01:25:59.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-06T23:54:05.000Z (over 1 year ago)
- Last Synced: 2025-04-06T17:03:28.840Z (about 1 year ago)
- Topics: cli, color-grading, colorscheme, hald-clut, linux-desktop, rice, rust, theming, wallpaper
- Language: Rust
- Homepage: https://docs.rs/lutgen
- Size: 31.2 MB
- Stars: 356
- Watchers: 2
- Forks: 10
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
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
## Lutgen CLI
### Package Repositories
[](https://repology.org/project/lutgen/versions)
### Install from source
```bash
git clone https://github.com/ozwaldorf/lutgen-rs
cd lutgen-rs
cargo install --path crates/cli
```
### Crates.io
```bash
cargo install lutgen-cli
```
### Documentation
Detailed documentation, examples, and more are available on [The Lutgen Wiki](https://ozwaldorf.github.io/lutgen-rs)
## Lutgen Studio
### Package Repositories
[](https://repology.org/project/lutgen-studio/versions)
### Required Dependencies
(For this example, Ubuntu packages are listed)
- libxcb-render0-dev
- libxcb-shape0-dev
- libxcb-xfixes0-dev
- libxkbcommon-dev
- libssl-dev
- wayland
### Install from source
```bash
git clone https://github.com/ozwaldorf/lutgen-rs
cd lutgen-rs
cargo install --path crates/studio
```
### Crates.io
```bash
cargo install lutgen-studio
```
## Rust Library
See the latest rust documentation on [docs.rs/lutgen](https://docs.rs/lutgen)
## Nix flake
A nix flake is available providing both lutgen and lutgen-studio packages.
The flake can be easily run via:
```bash
nix run github:ozwaldorf/lutgen-rs
nix run github:ozwaldorf/lutgen-rs#lutgen-studio
```
Cache is provided via https://garnix.io
### Development Shell
A development environment is also provided in the flake:
```bash
git clone https://github.com/ozwaldorf/lutgen-rs
cd lutgen-rs
nix develop
# inside dev shell
cargo run -r --bin lutgen
cargo run -r --bin lutgen-studio
```
## 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](https://github.com/Gingeh) for the initial inspiration and imagemagick approach
- [The Catppuccin Org](https://github.com/catppuccin) for continual feedback and support along the way
- [Stonks3141](https://github.com/Stonks3141) for maintaining the Alpine Linux package
- All the nixpkgs maintainers