Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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 hald-clut linux-desktop rice rust theming wallpaper
Last synced: 5 days 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 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-06T01:26:44.000Z (6 days ago)
- Last Synced: 2024-07-06T12:08:34.840Z (5 days ago)
- Topics: cli, color-grading, hald-clut, linux-desktop, rice, rust, theming, wallpaper
- Language: Rust
- Homepage: https://docs.rs/lutgen
- Size: 25.6 MB
- Stars: 246
- Watchers: 2
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Lists
- awesome-stars - ozwaldorf/lutgen-rs - Blazingly fast interpolated LUT generator and applicator for arbitrary and popular color palettes. (Rust)
README
lutgen-rs
A blazingly fast interpolated LUT generator and applicator 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
## Usage
> Note: The binary usages are fairly stable, but any release that does make any breaking changes as such, are bumped to 0.X.0
### CLI
[](https://repology.org/project/lutgen/versions)
#### Source
```bash
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:
```bash
nix run github:ozwaldorf/lutgen-rs
```
Cache is provided via https://garnix.io
#### Helptext
```text
Usage: lutgen
Commands:
generate Generate a hald clut for external or manual usage
apply Correct an image using a hald clut, either generating it, or loading it externally
patch Generate a patch for rgb colors inside text files
palette Print palette colors and names
completions Generate shell completions
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version
```
#### Examples
Correcting an image
```bash
# 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
lutgen apply docs/example-image.jpg -- $(cat palette.txt)
# 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
```bash
# 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 hex codes
lutgen generate -o custom.png -- $(cat palette.txt)
```
Palletes
```bash
# Preview all palettes
lutgen palette
# Copy a palette to a file for tweaking
lutgen palette carburetor > carburetor.txt
# Finding a palette name with grep
lutgen palette --name-only | grep 'gruvbox'
```
Correcting videos (using ffmpeg):
```bash
ffmpeg -i input.mkv -i hald_clut.png -filter_complex '[0][1] haldclut' output.mp4
```
Zsh Completions
```bash
lutgen completions zsh > _lutgen
sudo mv _lutgen /usr/local/share/zsh/site-functions/
```
### Library
See the latest documentation on [docs.rs](https://docs.rs/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
- [Stonks3141](https://github.com/Stonks3141) for maintaining the Alpine Linux package
- All the nixpkgs maintainers