Linux downloads: Chromiator 0.3.0 preview provides x86_64 AppImage and Flatpak packages, source, license notices, and checksums. This is a pre-alpha release; see the release notes for installation instructions, verification scope, and compatibility limits. See distribution details for package evidence.
Chromiator is an artist-directed perceptual color-space partitioning and remapping application for Linux. It uses editable Voronoi sites in color space to simplify, segment, recolor, and blend an image's color structure while preserving its spatial structure.
Use it for limited-palette artwork, grayscale studies, graphic posters, print-like color reduction, or softly blended recoloring. You control which Source colors define the regions and which Target colors replace them. Regions are determined by color similarity, not by a pixel's location on the canvas.
Chromiator uses native GTK4 widgets and runs on Linux, with Fedora and GNOME/Wayland as its primary environment. It requires GTK 4.12 or newer and a recent stable Rust toolchain to build from source. No GPU compute setup is needed.
On Fedora, install the build prerequisites:
sudo dnf install gcc git cargo rust gtk4-devel pkgconf-pkg-configDownload and build the application:
git clone https://github.com/ricperry/Chromiator.git
cd Chromiator
cargo build --release --locked
./target/release/chromiatorOptionally install the executable for your user:
install -Dm755 target/release/chromiator ~/.local/bin/chromiatorRun chromiator when ~/.local/bin is on your PATH, or open a file directly:
chromiator --open /path/to/artwork.png
chromiator --open /path/to/project.chromiator- Open an image, browse an existing project, or try the Spectrum Example from the welcome screen.
- Choose a preset for a starting point, or edit the automatically created sites.
- Select a site and change its Target swatch to recolor the colors it represents.
- Adjust Matching, Influence, and Transition width to control the result.
- Compare Source and Result, save a project to keep editing, or export an image.
A new image starts with up to six sites chosen from its visible colors. Nearby dominant shades share a site, while compact, distinct highlights and accents can keep their own. Each site attaches to a real source pixel, and its Target starts at that sampled color. Transparent pixels and isolated single-pixel noise do not add sites on normal-sized images.
Source displays the original image. Result displays the processed image. Split displays Result on the left and Source on the right; drag the divider to reveal either side. Hide the adjustments panel when you want more canvas space. With adjustments hidden, Save, Undo, and Redo move into the Document menu so the window can shrink to its 600 px compact minimum; showing the panel restores the toolbar controls and the wider workspace minimum.
Click visible artwork to create a site from that color. A Source sample attaches to the original image; a Result sample uses the processed color and is detached. Clicking an existing site marker selects it. To sample the original image, expose it with Source or Split first.
The + button in Color sites opens the picker for a detached Source color. A new site's Target initially matches its Source. Canceling the picker adds nothing.
Expand a site to edit its controls:
| Setting | What it does |
|---|---|
| Source | The color used to determine which image colors belong to this site. Editing it directly detaches the site from the image. |
| Target | The replacement color. Editing or moving Source does not change Target. |
| Arrow between swatches | Explicitly assigns the Source color to Target. |
| Influence | Expands or contracts the site's reach in color space. Higher values attract more colors; this is not a spatial brush radius. |
| Source position | Moves an attached sample within the original image. |
| Footprint | Samples a point or averages a 3 x 3 or 5 x 5 neighborhood in the original image. |
| Lock | Protects the site's local settings and prevents its deletion. |
Source and Target pickers support perceptual color controls as well as RGB values and hexadecimal input. Changes are committed when you select a color; Cancel leaves the original value alone.
| Setting | What it does |
|---|---|
| Matching | Chooses the color-distance model for assigning pixels to sites. Perceptual (OKLab) is a useful starting point; RGB and HSV produce different partitions. |
| Smoothing σ (source px) | Smooths the input before color mapping. Zero preserves fine detail; higher values favor broader structures. Values run from 0 to 10,000 source pixels; above 10, a fast Gaussian approximation is blended in. |
| Transition width | At 0%, each pixel takes its winning site's Target color. Increasing the width blends competitive sites across color-space boundaries. This is not an image blur. |
| Blend space | Mixes Target colors in Oklab or Linear RGB, independently of Matching. Available when Transition width is greater than zero. |
These settings are grouped under Color mapping, collapsed by default to leave more room for Color sites. Expand the group to edit them; point to a control for its explanation.
Blending can produce more output colors than the number of Target swatches. Hard transitions are useful for strict palette reduction; wider transitions are useful for smooth recoloring. Smoothing σ is measured in original source-image pixels. Both the initial and scheduled previews process the full source before the result is reduced to fit the 1600-pixel preview limit. A PNG8 export reduced with the same sampling therefore matches the preview's displayed pixels.
The built-in library offers nineteen starting points:
| Character | Presets |
|---|---|
| Graphic and colorful | Ink & Paper, Desert Dusk, Blueprint, Arcade Four, Night Neon, Teal and Tangerine, Primary Print |
| Muted and organic | Moss and Clay, Soft Pastel, Watercolor |
| Tonal and monochrome | Graphite, Sepia Press, Smudged Graphite |
| Reduced-ink looks | Mimeograph, Photocopy, Carbon Copy, Old Newsprint, Two-Color Press, Risograph |
Presets are editable recipes, not separate processing modes. Some deliberately discard subtle color information; others use smoothing and soft transitions. Print-inspired names describe the palette and reduction style, not simulated paper texture, halftones, or physical ink behavior.
Choose Presets → Select Preset... to browse built-in and personal looks.
Select a look and choose Apply to replace the processing settings; Cancel
leaves the current settings unchanged. The change is one undoable edit. Choose
Presets → Load Preset... to apply a current .chromiator project's
processing recipe or a current preset .json file without replacing the open
artwork or project. Presets → Save Preset... stores the current processing
settings for reuse; it does not include source artwork or image-marker
positions. Built-ins are not overwritten when you save a personal preset.
Personal presets live in $XDG_DATA_HOME/chromiator/presets, normally
~/.local/share/chromiator/presets. The Select Preset dialog can open the
personal preset folder or refresh its list after external changes. The app
reports invalid preset files without preventing valid presets from loading.
Save Project writes a .chromiator file containing the original artwork and
editable processing settings. Save Project As... creates another project file.
Recent projects appear on the welcome screen.
Open PNG, JPEG, TIFF, WebP, BMP, or still GIF images. SVG and animated GIF input are not supported. Embedded RGB color profiles are interpreted on import; the working image uses floating-point linear sRGB with transparency preserved.
Export the full-resolution result without editor markers:
| Format | Use |
|---|---|
| PNG 8-bit | Everyday sharing and viewing. |
| PNG 16-bit | Higher-precision integer output for further editing. |
| OpenEXR 32-bit float | Linear-sRGB floating-point output for compatible creative tools. |
Exporting an image does not replace saving an editable project. Project and
preset formats are still pre-alpha and may change; keep original artwork and
backups. Older unsupported formats and the former project extension are not
automatically migrated. Application data is stored under
$XDG_DATA_HOME/chromiator, normally ~/.local/share/chromiator.
| Shortcut | Action |
|---|---|
| Ctrl+O | Open artwork or a project. |
| Ctrl+S | Save project. |
| Ctrl+Shift+S | Save project as. |
| Ctrl+Shift+E | Export image. |
| Tab / Shift+Tab | Move between controls. |
| F6 / Shift+F6 | Move between the canvas, mapping controls, and site list. |
| Alt+M / S / T / B | Focus Matching, Smoothing, Transition width, or Blend space. |
| Alt+I / P / F | Focus Influence, Source position, or Footprint in an expanded site. |
| Alt+C / H | Focus Color model or Hex in a color picker. |
Undo and Redo are available in the toolbar. Controls expose accessible names and state through GTK's accessibility interfaces.
Chromiator is free software under the GNU General Public License, version 3 or any later version. See LICENSE.md for the unmodified license text and THIRD_PARTY_NOTICES.md for library and color-science credits. Third-party components retain their respective licenses.
If you find Chromiator useful, you can support development with an optional tip on Ko-fi.
For artwork and design products, visit Silent But Digital Designs.