solidlime-Comfyui-Random_Image_Picker/random_image_picker.py

"""
Random Image Picker Node Implementation
"""

import os
import random
from pathlib import Path
from typing import Tuple, List
import folder_paths
from PIL import Image
import numpy as np
import torch


class RandomImagePicker:
    """
    ComfyUI node that loads either a single image or a random image from a folder.
    Supports subfolder scanning and outputs image with resolution information.
    """
    
    @classmethod
    def INPUT_TYPES(cls):
        # Get default input directory from ComfyUI
        try:
            default_path = folder_paths.get_input_directory()
        except:
            default_path = ""
        
        return {
            "required": {
                "image": ("STRING", {
                    "default": default_path, 
                    "multiline": False,
                    "dynamicPrompts": False,
                    "tooltip": "Enter full path to image file (Single mode) or folder (Folder mode). Use 📁 button to help select."
                }),
                "folder_mode": ("BOOLEAN", {
                    "default": False, 
                    "label_on": "Folder", 
                    "label_off": "Single",
                    "tooltip": "Single: Load specific file | Folder: Random from folder"
                }),
                "include_subfolders": ("BOOLEAN", {
                    "default": False, 
                    "label_on": "ON", 
                    "label_off": "OFF",
                    "tooltip": "Include subfolders when scanning in Folder mode"
                }),
                "seed": ("INT", {
                    "default": 0, 
                    "min": 0, 
                    "max": 0xffffffffffffffff,
                    "tooltip": "Random seed for reproducible selection in Folder mode"
                }),
            },
        }
    
    RETURN_TYPES = ("IMAGE", "INT", "INT")
    RETURN_NAMES = ("IMAGE", "width", "height")
    FUNCTION = "load_image"
    CATEGORY = "image"
    OUTPUT_NODE = True
    OUTPUT_IS_LIST = (False, False, False)
    
    @staticmethod
    def get_image_files(directory: str, include_subfolders: bool = False) -> List[str]:
        """
        Get all image files from a directory.
        
        Args:
            directory: Directory path to scan
            include_subfolders: Whether to include subfolders in the scan
            
        Returns:
            List of image file paths
        """
        supported_formats = {'.png', '.jpg', '.jpeg', '.webp', '.bmp', '.gif'}
        image_files = []
        
        if include_subfolders:
            for root, _, files in os.walk(directory):
                for file in files:
                    if Path(file).suffix.lower() in supported_formats:
                        image_files.append(os.path.join(root, file))
        else:
            for file in os.listdir(directory):
                file_path = os.path.join(directory, file)
                if os.path.isfile(file_path) and Path(file).suffix.lower() in supported_formats:
                    image_files.append(file_path)
        
        return image_files
    
    @staticmethod
    def load_image_file(image_path: str) -> Tuple[torch.Tensor, int, int]:
        """
        Load an image file and convert to ComfyUI format.
        
        Args:
            image_path: Path to the image file
            
        Returns:
            Tuple of (image_tensor, width, height)
        """
        img = Image.open(image_path)
        
        # Convert to RGB if needed
        if img.mode != 'RGB':
            img = img.convert('RGB')
        
        # Get dimensions
        width, height = img.size
        
        # Convert to numpy array
        img_array = np.array(img).astype(np.float32) / 255.0
        
        # Convert to torch tensor and add batch dimension
        # ComfyUI expects [batch, height, width, channels]
        img_tensor = torch.from_numpy(img_array)[None,]
        
        return img_tensor, width, height
    
    def load_image(self, image: str, folder_mode: bool, include_subfolders: bool, seed: int):
        """
        Load image based on mode settings.
        
        Args:
            image: File path (single mode) or file path to extract folder from (folder mode)
            folder_mode: True for folder mode, False for single file mode
            include_subfolders: Whether to scan subfolders
            seed: Random seed for folder mode
            
        Returns:
            Tuple of (image_tensor, width, height)
        """
        if not image or not os.path.exists(image):
            raise ValueError(f"Path does not exist: {image}")
        
        if folder_mode:
            # Folder mode: extract folder from file path and pick random image
            if os.path.isfile(image):
                # Extract folder path from file path
                folder_path = os.path.dirname(image)
            elif os.path.isdir(image):
                # Direct folder path
                folder_path = image
            else:
                raise ValueError(f"Invalid path: {image}")
            
            image_files = self.get_image_files(folder_path, include_subfolders)
            
            if not image_files:
                raise ValueError(f"No image files found in directory: {folder_path}")
            
            # Use seed for reproducible random selection
            random.seed(seed)
            selected_image = random.choice(image_files)
            
            print(f"[Random Image Picker] Folder: {folder_path}")
            print(f"[Random Image Picker] Selected: {selected_image}")
            return self.load_image_file(selected_image)
        else:
            # Single file mode
            if not os.path.isfile(image):
                raise ValueError(f"Single file mode enabled but path is not a file: {image}")
            
            print(f"[Random Image Picker] Loading: {image}")
            return self.load_image_file(image)


# Node registration
NODE_CLASS_MAPPINGS = {
    "RandomImagePicker": RandomImagePicker
}

NODE_DISPLAY_NAME_MAPPINGS = {
    "RandomImagePicker": "Random Image Picker"
}