What Is ColorSmith? HueForge's New Free Plugin, Explained

Your favorite photo probably holds a thousand times more colors than you have filaments.

The picture you're about to drop into HueForge might carry half a million distinct shades, and you're going to represent it with six spools. ColorSmith is a new free plugin that closes that gap before you ever touch a slider. It shipped quietly, it costs nothing, and y'all, I'm stoked about this one.

What you need

HueForge 0.9.4.3 or newer, on Windows, macOS or Linux. A HueForge store account for the free download. No prior plugin experience. This one installs by dragging a file.

The problem it exists to solve

Look at a photo of a parrot. You'd say red, green, yellow, blue, white, maybe a brown and a couple of grays. Nine colors, tops.

That image holds 190,418 distinct colors. The developer measured it. And that's a small one. He says most images online run 300,000 or more. Some go past a million and a half.

Here's why that matters for us. HueForge is a limited-color system. You're blending a handful of filaments across layers to stand in for the image's colors. When an image carries 400,000 shades and you carry eight filaments, you're matching against colors you can't even see.

ColorSmith writes the shopping list: which colors are worth spending a filament on, before you shop.

What it looks like inside HueForge

This is the part that surprised me. ColorSmith isn't a separate window. There's a ColorSmith button on the mode toolbar, next to the HueForge button. Press it and the main window becomes the plugin, your image already loaded.

Look at the bottom of that panel. 787,949 source colors, reduced to 39 total: 32 color and 7 gray. Output on the left, source on the right. The chosen swatches sit between them, one chip per kept color.

That gray count is doing quiet work, by the way. JPEG compression leaves a haze of near-gray pixels around every edge, and that haze eats swatches. ColorSmith sorts colored pixels and gray pixels into separate groups before it reduces either one. Your real grays get their own swatches. The compression haze never steals a swatch from a color you wanted.

Ten tools for fixing the first pass

Automatic color reduction has been around forever. This one is different: the automatic pass is a starting point you can fix by hand.

You get ten tools for fixing what that first pass got wrong:

Number of Colors — slide the count up or down.

Merge Swatches — fold two swatches into one.

Split Colors — break one swatch into separate pixel groups you can adjust independently.

Extract Pixels — pick a patch and give it a swatch of its own.

Preserve a Color — keep a small, important color from being absorbed into a bigger one.

Change a Color — recolor a swatch in place.

Local Claim — move one region's pixels to a neighboring swatch, and leave the rest of that color alone.

Refine Gradient — add shades where a smooth fade came back as visible steps.

Recover a Missed Color — find and display a color the automatic pass dropped.

Clean Swatch Edges — fold the blurry pixels along an edge into the swatch beside them.

There's also masking, through Mask Region and Mask by Lasso. Draw a loop around a sky or a face and leave it out of the count. That part comes back as one flat color, or with its original pixels.

Ten tools is a lot to read in a list, and it's okay if none of them stuck. You don't have to learn them up front. Run the automatic pass, look at what it got wrong, then come back to the list. Every tool has its own tutorial built into the plugin, on a sample image, so you can try one without risking your own project.

Two ways to use the result

Apply Image sends the reduced image into HueForge as your working image. Your color matching now happens against 39 colors instead of 787,949. That's the image-prep discipline I teach in Module 2 of HueForge Mastery: set the color budget before HueForge sees the picture, not after.

The Palette dock leaves your image completely alone. Press Palette on the toolbar and a ColorSmith Palette tab opens beside your Filament Library. The colors are sorted by hue, grays last.

That second one is the option most of y'all are going to miss. You get the shopping list without changing a single pixel of your image. If you like your photo exactly as it is and only want its color list, that's the door.

One thing the dock does not do: pick your filaments. It hands HueForge the color. Choosing what to print it in is still your call.

And your file on disk is never at risk either way. Straight from the FAQ: "ColorSmith works on a copy. Apply Image replaces HueForge's working image; the file on disk is untouched."

Where it struggles, in the developer's own words

I appreciate that he leads with this instead of burying it.

Smooth fades are the weak spot. His own list of the hardest images: "Large smooth skies, fog, studio backgrounds, and long skin-tone gradients." A big open sky needs a lot of colors. Cut it down and it breaks into stripes.

His fix isn't more tools. It's masking the sky and bringing it back as one flat color. About a minute of work, and it beats fighting the sky.

Every result gets a 0-100 quality score, and ColorSmith uses it to pick the color count. But the developer says plainly that the score "doesn't realize how much this version differs to a human eye." Treat it as a rough hint, not a grade. Your eyes still outrank it.

You don't have to pay for the update

Some of you may be thinking, "Victor, I'm not on the newest HueForge, so this isn't for me." And I get it. That's a fair assumption after the paid-update conversation this summer.

But check your version first. ColorSmith needs 0.9.4.3 or newer, and 0.9.4.3 is free to every owner. The store says it flat out: "Regardless of Maintenance Window, everyone can download 0.9.4.3 without any maintenance payments."

So if you're sitting on 0.9.4.0, 0.9.4.1 or 0.9.4.2, you're one free update away. Not one payment away. That's a really, really important difference.

Worth saying clearly: when ColorSmith was announced in August, the minimum was described as any 0.9.4 build. It moved up to 0.9.4.3 by the time it shipped. If you read that announcement and filed it away, the detail changed on you.

Price and install

Nothing, and I mean nothing. Add it to your cart at the ColorSmith plugin page and check out. "No payment details are asked for on a $0 order." Checking out puts it in your account Downloads, next to HueForge. That's where updates show up later.

Download the zip, then drag the zip onto HueForge while it's running. "It is signed, so it installs without a prompt."

One thing is not free: a paid standalone ColorSmith app is planned as a separate product. It hasn't shipped. It has no announced price. Anyone quoting you one is guessing.

If something goes sideways

If your sky came back in stripes, Refine Gradient won't carry a big sky. Mask it and return it as one flat swatch.

If a small color you cared about vanished, say an eye or a logo or one bright accent, use Preserve a Color before the automatic pass. Or Recover a Missed Color after it.

If your edges look chewed up, those are blurry edge pixels stuck between two swatches. Clean Swatch Edges folds them into the neighbor.

So should y'all install it?

It's free, it's from the person who writes HueForge, and it runs inside the window you already have open. The version number is the only thing that stops you, and fixing that is a free download.

ColorSmith won't make your print better on its own. It gives you a color count you can think about. Drop one image in and watch the number fall from hundreds of thousands to a few dozen.

I'd love to see what y'all get out of it. Come drop a before-and-after in Discord.

Want to watch me work through image prep on camera? I covered it in HueForge For Beginners Episode 7. The full workflow is Module 2 of HueForge Mastery, inside HueForge Pro.

Take care. — Vic