# NF Preview Selector

A floating dialog-based image review and selection system for ComfyUI.

## Features

- **Floating Dialog Interface**: Non-intrusive dialog window instead of full-screen overlay
- **Drag & Drop Positioning**: Move the review window anywhere on screen
- **Multi-Selection**: Click images to select/deselect multiple images
- **Timeout Support**: Configurable timeout with visual countdown
- **Multiple Modes**: Review mode, pass-through, take first/last
- **Latent Support**: Optional latent passthrough for efficiency
- **Memory**: Window position and settings are remembered

## Usage

1. Add the "NF Preview Selector" node to your workflow
2. Connect image input (and optionally latent input)
3. Choose a mode:
   - **review_and_select**: Opens floating dialog for manual selection
   - **pass_through**: Passes all images without review
   - **take_first**: Automatically selects first image
   - **take_last**: Automatically selects last image
4. Set timeout value (10-300 seconds)

## Dialog Interface

When in review mode, a floating dialog will appear showing:
- Grid of images to review
- Click images to select/deselect (green border indicates selection)
- Selection counter
- Countdown timer
- Confirm/Cancel buttons

## Settings

Access via ComfyUI Settings menu:
- **Dialog maximum width**: Determines the maximum width of the dialog in pixels. (Max 1800px)
- **Remember window position**: Saves dialog position between uses


## Outputs

- **selected_images**: IMAGE batch of selected images
- **selected_latents**: LATENT batch of corresponding latents (if input provided)
- **selection_indices**: STRING of selected indices (e.g., "0,2,4")

## Installation

1. Run git pull in the directory "ComfyUI/custom_nodes/".
 ```git pull https://github.com/NyaFuP/ComfyUI_Preview_Selector.git```
3. Restart ComfyUI
4. The "NF Preview Selector" node will appear in the "image/review" category

## Technical Details

- Built with modern JavaScript ES6 modules
- CSS-styled floating window system
- WebSocket communication with ComfyUI backend
- Supports both image and latent workflows
- Minimal dependencies (uses ComfyUI's built-in APIs)


## Credits

This custom node was implemented with reference to [cg-image-filter](https://github.com/chrisgoringe/cg-image-filter).