pixel-snap-cli

CLI tool to pixel-snap all PNGs in a folder. Reduces each image to its natural pixel-art resolution using spritefusion-pixel-snapper, then upscales back to the original size with nearest-neighbor interpolation, giving you clean, crisp pixel art at your original dimensions.

Usage

npx @ceyhuncicek/pixel-snap-cli ./my-folder

Or install globally:

npm install -g @ceyhuncicek/pixel-snap-cli
pixel-snap ./my-folder

How it works

1. Finds all *.png files in the given folder
2. Runs the Rust pixel-snapper binary on each (reduces to pixel-art resolution)
3. Upscales results back to original dimensions via Python/Pillow nearest-neighbor
4. Replaces the originals in-place

Platform support

• macOS arm64: pre-built binary included, no setup needed
• Other platforms: builds from source automatically on first run (requires Git; Rust and Pillow are auto-installed if missing)

Requirements

• Node.js 16+
• Python 3 with Pillow (auto-installed if missing)