ComfyUI Extension: ComfyUI-spritefusion-pixel-snapper

Authored by x0x0b

Created

Updated

0 stars

ComfyUI custom node port of Sprite Fusion Pixel Snapper that snaps pixel art to a clean grid and quantized palette.

Custom Nodes (0)

    README

    Sprite Fusion Pixel Snapper for ComfyUI

    Sprite Fusion Pixel Snapper for ComfyUI icon

    This custom node is a Python port of the Sprite Fusion Pixel Snapper tool that fixes messy AI-generated pixel art by snapping it to a clean grid and quantized palette.

    Install

    Place this folder inside ComfyUI/custom_nodes/ and restart ComfyUI.

    Node

    • Name: Sprite Fusion Pixel Snapper
    • Category: image/transform

    Inputs

    • image – ComfyUI IMAGE tensor.
    • k_colors (int) – Palette size (default 16).
    • k_seed (int) – RNG seed for palette init (default 42).
    • output_scale (int) – Optional integer upscaling after snapping (nearest-neighbor, default 1, max 16).

    Advanced parameters mirror the original Rust defaults and can be tweaked: max_kmeans_iterations, peak_threshold_multiplier, peak_distance_filter, walker_search_window_ratio, walker_min_search_window, walker_strength_threshold, min_cuts_per_axis, fallback_target_segments, max_step_ratio.

    Output

    • IMAGE – pixel-snapped result, one frame per input frame.

    Credits

    • Upstream repository: https://github.com/Hugo-Dz/spritefusion-pixel-snapper

    License