# pixfix

> Rust CLI and desktop app that normalizes AI-generated pixel art into clean,
> grid-aligned game assets. Detects the pixel grid (including fractional
> pitches like 10.667px), snaps blocks to it, removes anti-aliasing, quantizes
> colors while preserving dithering, and removes backgrounds or chroma keys.
> Built to be driven by scripts and agents: --json output with a stable
> schema, distinct exit codes, deterministic results via --seed, and an
> analyze subcommand that inspects without writing.

Key facts:
- Install: `cargo install pixfix` (binary releases on GitHub).
- Basic use: `pixfix process input.png` writes `input_normalized.png`.
- Inspect first: `pixfix analyze input.png --json`.
- Exit codes: 0 ok, 2 usage/config, 3 input unreadable, 4 processing failed,
  5 output exists, 6 batch partial failure.
- With `--json`, exactly one JSON document goes to stdout; logs and NDJSON
  progress go to stderr.
- Same input + `--seed N` always produces byte-identical output.
- Outputs never overwrite existing files unless `--overwrite` is passed.

## Docs

- [Full plain-text manual](https://lovelaced.github.io/pixfix/llms-full.txt): every command, flag, JSON field, and config key
- [README](https://raw.githubusercontent.com/lovelaced/pixfix/master/README.md): install, examples, CLI reference
- [Source](https://github.com/lovelaced/pixfix): GPL, Rust workspace (CLI library + Tauri desktop app)