Repolode
Submit
Hugo-Dz

Hugo-Dz/spritefusion-pixel-snapper

A Rust CLI and WASM tool that snaps messy AI-generated pixel art onto a clean, consistent pixel grid with a fixed palette.

View on GitHubWebsite
Stars
3,287
Forks
205
Open issues
0
Last commit
3 months ago

What is it?

Pixel Snapper fixes pixel art that has inconsistent pixel sizes, drifting grid positions, or colors that don't belong to a strict palette. This is a common problem with images produced by AI models, which generally cannot produce true grid-based pixel art.

The tool snaps pixels onto a uniform grid, lets you choose the number of palette colors (default 16) or supply a custom hex palette, and can override the auto-detected pixel size. It handles single files or whole directories in batch mode. It is available as a standalone native CLI installable via Homebrew or Cargo, and as a WebAssembly module for use in web projects.

The project is written in Rust and released under the MIT license. It is also available as an online tool and a desktop edition from the Sprite Fusion site.

Key features

  • 01Snaps irregular pixels onto a uniform grid.
  • 02Quantizes output to a configurable number of palette colors.
  • 03Accepts a custom hex palette for strict color control.
  • 04Supports batch processing of whole directories.
  • 05Provides a WebAssembly build for browser and JavaScript use.

Use cases

  • Cleaning up AI-generated sprites before using them in a game.
  • Making tilemap or isometric art pixel-consistent.
  • Converting images to a fixed palette for a retro-style project.
  • Batch-normalizing a folder of 2D game assets.

Quick start

  1. 1

    Install the CLI with Homebrew

    brew install Hugo-Dz/tap/spritefusion-pixel-snapper
  2. 2

    Or install with Cargo (requires Rust)

    cargo install spritefusion-pixel-snapper
  3. 3

    Quantize an image to a 16-color palette

    spritefusion-pixel-snapper input.png output.png 16

Things to know

  • Needs a Rust toolchain for the Cargo install route; the Brew route is an alternative.

Topics

#pixel-art#image-processing#game-development#rust#wasm#cli#ai-tools#gamedev

FAQ

What is spritefusion-pixel-snapper?
A Rust CLI and WASM tool that snaps messy AI-generated pixel art onto a clean, consistent pixel grid with a fixed palette. Pixel Snapper fixes pixel art that has inconsistent pixel sizes, drifting grid positions, or colors that don't belong to a strict palette. This is a common problem with images produced by AI models, which generally cannot produce true grid-based pixel art.
Is spritefusion-pixel-snapper free to use? What license does it have?
spritefusion-pixel-snapper is open source under the MIT license. Check the license terms before using it in commercial products.
Is spritefusion-pixel-snapper still maintained?
Updated within 6 months. The last commit to spritefusion-pixel-snapper was on Jul 16, 2026.
What can I use spritefusion-pixel-snapper for?
Cleaning up AI-generated sprites before using them in a game. Making tilemap or isometric art pixel-consistent. Converting images to a fixed palette for a retro-style project. Batch-normalizing a folder of 2D game assets.
How do I install spritefusion-pixel-snapper?
Install the CLI with Homebrew: brew install Hugo-Dz/tap/spritefusion-pixel-snapper Or install with Cargo (requires Rust): cargo install spritefusion-pixel-snapper Quantize an image to a 16-color palette: spritefusion-pixel-snapper input.png output.png 16
Where can I get spritefusion-pixel-snapper?
The source code and installation instructions are on GitHub: https://github.com/Hugo-Dz/spritefusion-pixel-snapper

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects