solidlime
a990101377
Features: - Added OUTPUT_NODE for real-time image preview - Implemented Browse button with JavaScript widget - Enhanced path input with placeholder and default value - Updated README with new feature documentation Changes: - random_image_picker.py: Added OUTPUT_NODE, improved INPUT_TYPES - web/random_image_picker.js: New custom widget for file/folder selection - README.md: Updated documentation with new features - .gitignore: Added web directory ignore patterns
117 lines
3.2 KiB
Markdown
117 lines
3.2 KiB
Markdown
# Random Image Picker - ComfyUI Custom Node
|
|
|
|
A ComfyUI custom node that provides flexible image loading with support for both single file and random folder selection.
|
|
|
|
## Features
|
|
|
|
- **Single Image Mode**: Load a specific image file
|
|
- **Folder Mode**: Randomly select an image from a folder
|
|
- **Subfolder Support**: Option to include subfolders in the search
|
|
- **Resolution Output**: Automatically outputs image width and height
|
|
- **Reproducible Random**: Seed control for consistent random selection
|
|
- **🆕 Image Preview**: Real-time preview of loaded images in the UI
|
|
- **🆕 File Browser**: Convenient "Browse..." button for file/folder selection
|
|
|
|
## Installation
|
|
|
|
1. Clone or download this repository to your ComfyUI custom nodes directory:
|
|
```bash
|
|
cd ComfyUI/custom_nodes
|
|
git clone <repository-url> Comfyui-Random_Image_Picker
|
|
```
|
|
|
|
2. Restart ComfyUI
|
|
|
|
3. The node will appear in the "image" category as "Random Image Picker"
|
|
|
|
## Usage Tips
|
|
|
|
- **Using the Browse Button**: Click "Browse..." to open your system's file/folder selector
|
|
- Note: Due to browser security limitations, you may need to manually enter the full path
|
|
- **Default Path**: The input field defaults to your ComfyUI input directory
|
|
- **Path Format**: Use forward slashes `/` or double backslashes `\\` on Windows
|
|
- **Preview**: The loaded image automatically appears in the node's preview area
|
|
|
|
## Usage
|
|
|
|
### Node Inputs
|
|
|
|
- **path** (STRING):
|
|
- In Single mode: Full path to an image file
|
|
- In Folder mode: Full path to a folder containing images
|
|
- 🆕 **Browse Button**: Click "Browse..." to select files/folders using your file explorer
|
|
- Default: ComfyUI input directory
|
|
|
|
- **folder_mode** (BOOLEAN):
|
|
- `OFF` (Single): Load the specified image file
|
|
- `ON` (Folder): Randomly select an image from the folder
|
|
- Note: The browse dialog changes based on this setting
|
|
|
|
- **include_subfolders** (BOOLEAN):
|
|
- `OFF`: Only scan the specified folder
|
|
- `ON`: Include all subfolders in the search
|
|
|
|
- **seed** (INT):
|
|
- Random seed for reproducible image selection in Folder mode
|
|
- Range: 0 to 18446744073709551615
|
|
|
|
### Node Outputs
|
|
|
|
- **IMAGE**: The loaded image in ComfyUI tensor format (with real-time preview)
|
|
- **width** (INT): Image width in pixels
|
|
- **height** (INT): Image height in pixels
|
|
|
|
### Supported Image Formats
|
|
|
|
- PNG (.png)
|
|
- JPEG (.jpg, .jpeg)
|
|
- WebP (.webp)
|
|
- BMP (.bmp)
|
|
- GIF (.gif)
|
|
|
|
## Examples
|
|
|
|
### Single Image Mode
|
|
```
|
|
path: D:/images/photo.png
|
|
folder_mode: OFF
|
|
include_subfolders: OFF
|
|
seed: 0
|
|
```
|
|
Loads the specific image at `D:/images/photo.png`
|
|
|
|
### Random Folder Mode
|
|
```
|
|
path: D:/images/
|
|
folder_mode: ON
|
|
include_subfolders: OFF
|
|
seed: 42
|
|
```
|
|
Randomly selects one image from `D:/images/` (excluding subfolders)
|
|
|
|
### Random with Subfolders
|
|
```
|
|
path: D:/images/
|
|
folder_mode: ON
|
|
include_subfolders: ON
|
|
seed: 42
|
|
```
|
|
Randomly selects one image from `D:/images/` and all its subfolders
|
|
|
|
## Technical Details
|
|
|
|
- Images are converted to RGB format
|
|
- Output tensor format: `[batch, height, width, channels]`
|
|
- Pixel values normalized to 0.0-1.0 range
|
|
- Uses PyTorch tensors for ComfyUI compatibility
|
|
- Real-time preview in ComfyUI UI (OUTPUT_NODE enabled)
|
|
- Custom JavaScript widget for enhanced file selection
|
|
|
|
## License
|
|
|
|
MIT License
|
|
|
|
## Author
|
|
|
|
Created for ComfyUI
|