XYZ Image Collector (Manual)

XYZ Image Collector (Manual) is the Auto Collector's older, more hands-on sibling. Same trick - accumulate images in memory keyed by collection_id - but instead of firing automatically at a preset count, you flip a mode switch when you're ready. The README pitches it at advanced users who want fine control, and that's a fair description: it trades convenience for the ability to dump the batch on your schedule.

The inputs

• images - your generated image per run.
• collection_id - the store key; use the same ID for all the images you want in one grid.
• mode - the heart of the node, an enum with four states:
  • collect - append this run's image to the collection.
  • output_and_reset - release the whole batch and clear the store.
  • output_only - release the batch but keep it stored (so you can output multiple times).
  • reset_only - wipe the collection without outputting anything.
• expected_count - just for progress tracking; set it to your grid size so the status readout can say "9/9".

How it differs from Auto Collector

Two behaviors worth knowing before you pick between them. First, in collect mode the images output carries the current run's batch for preview, not the accumulated collection - so you can watch what you just made, but the full grid only shows up when you switch to an output mode. Second, expected_count never gates anything: it's purely cosmetic progress reporting, unlike Auto Collector's total_combinations which decides when the sweep is done. Nothing happens until you change the mode yourself.

That's the real tradeoff. The Auto Collector is set-and-forget for a standard sweep. Manual gives you control - collect a few, peek at outputs, collect more, then dump - but it's easy to forget you're in collect mode and wonder where your grid went. If you're a beginner building your first sweep, start with Auto. Reach for this one when you're deliberately curating a set that isn't a clean N×M grid, or when you want to review results before committing them.

Outputs

images (current batch in collect mode, the full stack in output modes), collected_count, is_complete, and status - same shape as the Auto Collector, and it still needs its is_complete wired into XYZ Grid Stitch for the grid to appear on the right run.

Installing

Same pack as everything else here. ComfyUI Manager → search "XYZ Grid", or:

cd ComfyUI/custom_nodes/
git clone https://github.com/psdwizzard/Comfyui-XYZ-stitch.git

Restart ComfyUI. No extra dependencies - it sits under "XYZ Grid" with no requirements.txt and no models to fetch.