pixel-snapper 0.1.0

Snap pixels to a perfect grid - designed to fix messy pixel art generated by AI. Based on original work: https://github.com/Hugo-Dz/spritefusion-pixel-snapper/tree/main

Sprite Fusion Pixel Snapper - Python Binding

A Python binding for Pixel Snapper by Hugo Duprez. Snap pixels to a perfect grid - designed to fix messy and inconsistent pixel art generated by AI.

Example

Input	Output

Installation

pip install pixel-snapper

Or build from source with maturin:

pip install maturin
maturin develop --features python

Usage

Library

from pixel_snapper import PixelSnapperConfig, process_image, process_file_cli

# Process image bytes
config = PixelSnapperConfig(k_colors=16, pixel_size_override=8)
output_bytes = process_image(input_bytes, config)

# Process file directly
process_file_cli("input.png", "output.png", config)

CLI

pixel-snapper input.png output.png
pixel-snapper input.png output.png 16
pixel-snapper input.png output.png --pixel-size 8
pixel-snapper sprites/batch_inputs sprites/batch_outputs 16

Batch processing with progress

from pixel_snapper import PixelSnapperConfig, process_batch

def on_event(event):
    print(f"[{event['type']}] {event}")

config = PixelSnapperConfig(k_colors=16)
process_batch("input_dir", "output_dir", config, on_event)

Acknowledgments

This is a Python binding fork of spritefusion-pixel-snapper by Hugo Duprez. All credit for the original Rust implementation goes to the original authors.

License

MIT License - See LICENSE for details.