Vito Sansevero
9be3cc3397
The Local Image Loader can browse folders visually, but only output a picked image. Add a third output, folder: the path of the folder the gallery shows, or the picked image's folder until the user browses. Browsing is enough, so a training dataset can be found by its thumbnails and passed to a node that reads a whole folder. The gallery stores the shown folder through set_node_selection (type "folder"), which accepts only directories inside the allowed roots; load_media checks the stored folder against the roots again.
5.1 KiB
Local Image Loader
Overview
The Local Image Loader node provides a visual gallery interface for browsing and selecting images, videos, and audio files from your local filesystem directly within ComfyUI. This streamlined version focuses on essential functionality without the complexity of tagging or metadata management.
Features
- Visual Gallery Browser: Browse local directories with thumbnail previews
- Multi-Media Support: Load images, videos, and audio files
- Directory Navigation: Navigate through folders with ease
- Sorting Options: Sort by name, date, or file size
- Saved Paths: Save frequently used directory paths for quick access
- Pagination: Handle large directories with paginated display
- Lightbox Preview: Full-size preview with zoom and pan capabilities
Node Inputs
Required Inputs
None - The node uses a visual interface for file selection
Hidden Inputs
unique_id: Automatically assigned node identifier
Node Outputs
| Output | Type | Description |
|---|---|---|
image |
IMAGE | The selected image as a tensor |
info |
STRING | JSON metadata about the selected image |
folder |
STRING | The folder the gallery is showing, or the selected image's folder |
Browse to a folder and queue: folder passes its path on without selecting an image, for nodes that read a whole folder, such as a dataset captioner.
Usage
Basic Workflow
- Add the Node: Search for "Local Image Loader" in the node menu
- Browse Directory: Enter a directory path or use saved paths
- Select Media: Click on thumbnails to select files
- Connect Outputs: Use the outputs in your workflow
Interface Controls
Path Management
- Directory Input: Enter or paste a directory path
- Saved Paths Dropdown: Quick access to saved directories
- Save Path Button (💾): Save current directory to favorites
- Browse Button (📁): Load the entered directory
View Options
- Videos Checkbox: Show/hide video files
- Audio Checkbox: Show/hide audio files
- Sort By: Choose between Name, Date, or Size
- Sort Order: Ascending (↑) or Descending (↓)
- Refresh Button (🔄): Reload current directory
Gallery Display
- Thumbnail Grid: Visual preview of files
- Blue Border: Selected items are highlighted
- Folder Icons: Navigate into subdirectories
- Video Overlay: Visual indicator for video files
- Pagination: Navigate through pages of results
File Support
Supported Image Formats
.jpg,.jpeg.png.bmp.gif.webp
Supported Video Formats
.mp4.webm.mov.mkv.avi
Supported Audio Formats
.mp3.wav.ogg.flac
Image Metadata
When an image is selected, the node extracts and returns metadata including:
- Basic Info: Filename, width, height, format, mode
- Embedded Parameters: Generation parameters if present
- Workflow Data: Embedded ComfyUI workflow if present
- Prompt Data: Embedded prompt information if present
Examples
Loading an Image for Processing
Local Image Loader → Load Image → Image Processing Node
↓
[info] → Display Text (to show metadata)
Setting Up a Multi-Media Workflow
Local Image Loader → [image] → Image Preview
↓
[video_path] → Video Player Node
↓
[audio_path] → Audio Player Node
Tips and Best Practices
- Save Frequently Used Paths: Use the save button to bookmark directories you use often
- Use Sorting: Sort by date to find recent files quickly
- Keyboard Navigation: Press Enter in the path field to load a directory
- Performance: For directories with thousands of files, use pagination to navigate efficiently
- Thumbnail Generation: Thumbnails are generated on-demand and cached for performance
Differences from Original
This version simplifies the original ComfyUI_Local_Image_Gallery by removing:
- Tag filtering and management
- Rating system
- Global tag search
- Metadata editing capabilities
These features were removed to focus on the core functionality of browsing and selecting files, making the tool simpler and more straightforward to use.
Troubleshooting
Common Issues
Directory Not Loading
- Verify the path exists and you have read permissions
- Check for special characters in the path
- Try using absolute paths instead of relative ones
Thumbnails Not Showing
- Ensure the files are in supported formats
- Check if the images are corrupted
- Try refreshing the gallery
Large Directories Slow to Load
- Use sorting and pagination to manage large folders
- Consider organizing files into subdirectories
- Enable only the media types you need (images, videos, audio)
Technical Details
The node creates a visual widget that runs in the ComfyUI interface and communicates with the backend through API endpoints to:
- List directory contents
- Generate thumbnails
- Save user preferences
- Handle file selection
All file operations are performed server-side for security, with proper path validation to prevent directory traversal attacks.