如何快速安装lutgen-rs:cargo、Nix、包管理器5分钟上手教程
如何快速安装lutgen-rs:cargo、Nix、包管理器5分钟上手教程
lutgen-rs 是一个用 Rust 编写的高速 LUT(查找表)生成与套色工具,能把流行配色方案转换成 Hald CLUT,并把整套主题色调快速应用到图片和文本文件上。本文带你用 5 分钟完成 lutgen-rs 安装,覆盖 cargo、Nix、系统包管理器与源码构建 4 种方式,新手照做即可。
📦 30 秒认识 lutgen-rs
lutgen-rs 由三个部分组成,按需选择安装即可:
| 组件 | 位置 | 说明 |
|---|---|---|
| lutgen CLI | crates/cli/ | 命令行工具:generate 生成 LUT、apply 给图片套色、extract 从图片提取 LUT、patch 批量替换文本中的颜色、palette 管理配色方案 |
| Lutgen Studio | crates/studio/ | 官方 GUI 图形界面,可编辑调色板并保存 |
| lutgen 库 | crates/lib/ | Rust 核心库,插值算法见 crates/lib/src/interpolation/ |
内置配色方案(Catppuccin、Gruvbox、Nord 等)定义在 crates/palettes/palettes.toml。
🧾 安装前准备:环境要求清单
| 安装方式 | 前置要求 | 适合人群 |
|---|---|---|
| cargo 安装 | Rust 工具链(cargo) | 大多数 Linux / macOS / Windows 用户 |
| Nix 安装 | Nix 包管理器 | NixOS 及 Nix 用户 |
| 系统包管理器 | nixpkgs、Alpine 等发行版 | 发行版用户 |
| 源码构建 | Rust nightly-2025-12-04(见 rust-toolchain.toml) |
想参与开发的程序员 |
💡 只装 CLI 一条命令就够;安装 Studio 需要额外系统库(Linux,以 Ubuntu 为例):libxcb-render0-dev、libxcb-shape0-dev、libxcb-xfixes0-dev、libxkbcommon-dev、libssl-dev、wayland。
🚀 最快安装方式:cargo 一键装 lutgen-cli
从 Rust 官方包仓库 crates.io 直接安装,无需编译源码:
# 安装命令行工具
cargo install lutgen-cli
# (可选)安装 GUI 版本
cargo install lutgen-studio
安装完成后验证一下:
lutgen -V
lutgen palette names | grep gruvbox
💡 如果提示找不到 lutgen 命令,把 ~/.cargo/bin 加入 PATH 即可。
🧊 Nix 安装:免依赖、可复现的完整配置
项目的 flake.nix 同时提供 lutgen 与 lutgen-studio 两个包,运行零配置:
git clone https://gitcode.com/gh_mirrors/lu/lutgen-rs
cd lutgen-rs
# 直接运行 CLI(默认包)
nix run .
# 运行 GUI
nix run .#lutgen-studio
需要长期开发时,用 Nix 开发 shell 自动配好工具链:
nix develop
# 进入 shell 后
cargo run -r --bin lutgen
cargo run -r --bin lutgen-studio
📦 系统包管理器:发行版一键安装步骤
lutgen / lutgen-studio 已被收录进多个发行版仓库,常见命令如下:
# nixpkgs(NixOS 及其他 Nix 用户)
nix profile install nixpkgs#lutgen
# Alpine Linux
sudo apk add lutgen
其他发行版可用系统自带的包搜索工具(如 search、searchpkg、distrobox 社区源等)按名称 lutgen 查询是否可用,安装体验与上面一致。
🛠 源码构建:面向开发者的完整步骤
git clone https://gitcode.com/gh_mirrors/lu/lutgen-rs
cd lutgen-rs
# 方式 A:直接安装 CLI
cargo install --path crates/cli
# 方式 B:安装 Studio
cargo install --path crates/studio
注意:仓库通过 rust-toolchain.toml 锁定了
nightly-2025-12-04工具链,rustup 会自动下载;嫌麻烦就配合上面的nix develop使用。
✅ 安装验证:跑通你的第一条 LUT 命令
# 列出全部内置配色
lutgen palette names
# 把图片一键变成 Catppuccin Mocha 主题
lutgen apply --palette catppuccin-mocha my-image.png
# 生成 Hald CLUT 文件,可导入其他修图软件
lutgen generate -p catppuccin-mocha
生成出来的 Hald CLUT 查找表长这样:
📚 参考资料:项目内文档路径
- 完整子命令文档:docs/pages/cli.md
- 更多用法与使用场景:docs/pages/examples.md
- man 手册页:docs/man/lutgen.1
- Studio GUI 帮助:docs/pages/studio.md
- Nix flake 定义:flake.nix
至此,5 分钟内你已经完成 lutgen-rs 的安装并跑通第一条命令。下一步建议先玩 lutgen apply 给桌面壁纸换个主题色,体验它的「套色」魔法 🎨。


