Your output gallery is overflowing with generations.
You need to organize them on the fly—even when ComfyUI isn't running.
You want to click once and instantly see which workflow created that stunning image or video, with a visual node summary showing even the source images you started from.
When you launch multiple generations, you want immediate web gallery updates.
You need to delete files, move them between folders, create new ones—all from your browser.
Filter by extension, prefix, or name, and download workflows as JSON.
Whether you're a tech beginner or an advanced user, experience all of this from your PC browser or smartphone—seamlessly on Windows, Linux, or Docker.
Perfect mobile visualization included. ✨
🎨 Beautiful, lightning-fast gallery that remembers the exact workflow behind every single creation
🔍 Instant workflow insights - Node Summary
SmartGallery isn't just another image viewer. It's a time machine for your creativity that automatically links every single file you've ever generated to its exact workflow—whether it's PNG, JPG, MP4, or WebP.
- 🏃♂️ Blazing Fast: SQLite database + smart caching = instant loading even with thousands of files
- 📱 Mobile Perfect: Gorgeous interface that works flawlessly on any device
- 🔍 Node Summary Magic: See model, seed, and key parameters at a glance (supports UI & API formats)
- 🎨 Source Media in Node Summary: View input images, videos, and listen to audio files directly inside the Node Summary. Automatically shows media files referenced in your workflow nodes from the ComfyUI input directory.
- 📁 Smart Organization: Expandable sidebar with real-time search, bi-directional sorting (name/date), and intuitive folder management
- 🖼️ Enhanced Gallery View: Sort thumbnails by date or name with instant toggle between ascending/descending order
- 🔎 Advanced Lightbox: Zoom with mouse wheel, numpad panning, persistent zoom levels, and quick delete functionality
- 📦 Batch Operations: Select multiple files and download as ZIP, or use range selection for bulk actions
- 🆕 Universal Upload Magic: Upload ANY ComfyUI-generated image/video from your PC or phone and instantly discover its workflow!
- 🌍 Community Sharing: Someone shared an amazing creation? Upload it and see exactly how they made it!
- 🔄 Real-time Sync: Silent background checks with visual progress overlay when new files are detected
- 🚨 Smart Diagnostics: Visual alerts for configuration issues and missing dependencies
- ⌨️ Keyboard Shortcuts: Full keyboard navigation with built-in help (press
?) - 🔄 Auto-Update Check: Stay informed about new versions automatically
- 🔧 Standalone Power: Works independently—manage your gallery even when ComfyUI is off
- ⚡ Lightning Setup: Simple configuration with environment variables or direct file editing
- 🐳 Docker Ready: Full containerization support for advanced deployment scenarios
- 🎨 Source Media in Node Summary: View input images, videos, and listen to audio files directly inside the Node Summary. Automatically shows media files referenced in your workflow nodes from the ComfyUI input directory
- 📦 Batch Zip Download: Select multiple files and download them as a single archive with background generation
- 🐳 Full Docker Support: Run in an isolated container with easy deployment (Credits: Martial Michel)
- 🔢 Smart File Counter: Instantly see how many files are currently filtered versus the total folder count
- 📱 Mobile Optimization: Improved UI layout, padding, and controls specifically for mobile devices
- 🔧 Environment Variables: Configure everything via OS variables for easier deployment
- 🗑️ Safe Delete Option (Optional): By default, files are permanently deleted. Configure the variable
DELETE_TOto move them to a specific folder (like/tmpor Trash) instead. - 🚨 Startup Diagnostics: Beautiful console output and visual alerts for configuration errors
- 🎮 Advanced Controls: Range selection (
↔️), Numpad panning, and a visual shortcuts bar (press?) - 🔄 Automatic Update Check: Get notified when a new version is available
- 📋 Enhanced Node Summary: Now supports both ComfyUI UI and API format JSONs
↔️ Range Selection: Select all files between two selections with one click- ⌨️ Keyboard Shortcuts Help: Press
?to see all available shortcuts - 🎮 Advanced Lightbox Controls: Numpad panning, adjustable pan speed, and visual shortcut bar
See CHANGELOG.md for detailed version history.
📱 Perfect mobile experience
git clone https://github.com/biagiomaf/smart-comfyui-gallery
cd smart-comfyui-gallery# Create virtual environment (recommended)
python -m venv venv
# Activate it
# Windows Command Prompt: call venv\Scripts\activate.bat
# Mac/Linux: source venv/bin/activate
# Install dependencies
pip install -r requirements.txtYou have two easy options to configure SmartGallery:
Perfect if you want to keep your settings separate or run multiple configurations.
Windows (Command Prompt):
call venv\Scripts\activate.bat
set "BASE_OUTPUT_PATH=C:/ComfyUI/output"
set "BASE_INPUT_PATH=C:/ComfyUI/input"
set "FFPROBE_MANUAL_PATH=C:/ffmpeg/bin/ffprobe.exe"
set SERVER_PORT=8189
REM Leave MAX_PARALLEL_WORKERS empty to use all CPU cores (recommended)
set "MAX_PARALLEL_WORKERS="
python smartgallery.pyLinux/Mac:
source venv/bin/activate
export BASE_OUTPUT_PATH="$HOME/ComfyUI/output"
export BASE_INPUT_PATH="$HOME/ComfyUI/input"
export FFPROBE_MANUAL_PATH="/usr/bin/ffprobe"
export SERVER_PORT=8189
# Leave MAX_PARALLEL_WORKERS empty to use all CPU cores (recommended)
export MAX_PARALLEL_WORKERS=""
python smartgallery.py💡 Tip: See the complete configuration guide at the top of
smartgallery.pyfor all available settings and detailed examples!
Open smartgallery.py and find the USER CONFIGURATION section. A detailed guide is included at the top of the file. Update just the paths after the commas:
# Find this section and change ONLY the values after the commas:
BASE_OUTPUT_PATH = os.environ.get('BASE_OUTPUT_PATH', 'C:/ComfyUI/output')
BASE_INPUT_PATH = os.environ.get('BASE_INPUT_PATH', 'C:/ComfyUI/input')
FFPROBE_MANUAL_PATH = os.environ.get('FFPROBE_MANUAL_PATH', "C:/ffmpeg/bin/ffprobe.exe")
SERVER_PORT = int(os.environ.get('SERVER_PORT', 8189))💡 Important: Always use forward slashes (
/) even on Windows! If your paths contain spaces, use quotes.
📹 FFmpeg Note: Recommended for extracting workflows from MP4 files. Download from ffmpeg.org if needed. Common locations:
- Windows:
C:/ffmpeg/bin/ffprobe.exeorC:/Program Files/ffmpeg/bin/ffprobe.exe- Linux:
/usr/bin/ffprobeor/usr/local/bin/ffprobe- Mac:
/usr/local/bin/ffprobeor/opt/homebrew/bin/ffprobe
python smartgallery.pyVisit http://127.0.0.1:8189/galleryout and watch the magic happen!
⏱️ First Run: The initial launch scans your files and generates thumbnails. Thanks to parallel processing, this is now incredibly fast (seconds to a few minutes depending on your collection size). After that? Lightning fast! ⚡
Want to run SmartGallery in a containerized environment? We've got you covered!
🎖️ Special Thanks: A huge shout-out to Martial Michel for orchestrating the Docker support and contributing significant improvements to the core application logic.
Note for Windows Users: The standard installation (Steps 1-4 above) is much simpler and works perfectly on Windows! Docker is completely optional and mainly useful for Linux servers or advanced deployment scenarios.
Docker deployment provides isolation, easier deployment, and consistent environments across different systems. However, it requires some familiarity with Docker concepts.
🗄️ Pre-built images
Pre-built images are available on DockerHub at mmartial/smart-comfyui-gallery and Unraid's Community Apps.
Example docker run command:
# Adapt the mounts and WANTED_UID/WANTED_GID variables to match your system
docker run \
--name smartgallery \
-v /comfyui-nvidia/basedir/output:/mnt/output \
-v /comfyui-nvidia/basedir/input:/mnt/input \
-v /comfyui-nvidia/SmartGallery:/mnt/SmartGallery \
-e BASE_OUTPUT_PATH=/mnt/output \
-e BASE_INPUT_PATH=/mnt/input \
-e BASE_SMARTGALLERY_PATH=/mnt/SmartGallery \
-p 8189:8189 \
-e WANTED_UID=`id -u` \
-e WANTED_GID=`id -g` \
mmartial/smart-comfyui-galleryNote: The
id -uandid -gcommands return the user and group IDs of the current user, respectively. This ensures that the container runs with the same permissions as the host user, which is important for file permissions and access to mounted volumes.
A compose.yaml file is provided for ease of use. You can use it to obtain the published image and run the container with the following command after placing it in a directory of your choice and adapting the paths and environment variables to match your system:
docker compose up -dSee the following section's "All available environment variables" for a list of all available environment variables.
📚 Complete Docker Setup Guide →
Our comprehensive Docker guide covers:
- 🏗️ Building the Docker image
- 🚀 Running with Docker Compose (recommended for beginners)
- ⚙️ Using Makefile (For advanced control and automation)
- 🔐 Understanding permissions and volume mapping
- 🛠️ Troubleshooting common Docker issues
- 📋 All available environment variables
Running behind Nginx or Apache? Point your proxy to:
http://127.0.0.1:8189/galleryout
Example Nginx configuration:
location /gallery/ {
proxy_pass http://127.0.0.1:8189/galleryout/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}➡️ Open an Issue - I read every single one!
- Fork the repo
- Create your feature branch (
git checkout -b amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin amazing-feature) - Open a Pull Request
Let's build something incredible together! 🚀
- Check Python version:
python --version(needs 3.9+) - Verify paths: Use forward slashes (
/) even on Windows, and quotes if paths contain spaces - Check startup alerts: SmartGallery now shows visual diagnostics for common issues
- Ensure folder exists: The ComfyUI output folder must exist and be accessible
- For MP4 files: Install FFmpeg and set
FFPROBE_MANUAL_PATHcorrectly (you'll see a startup alert if missing) - Check permissions: Folder must be readable and writable
- Memory issues?: Try reducing
MAX_PARALLEL_WORKERSto limit CPU usage (e.g., set to 4)
- Change
SERVER_PORTto a different number (e.g., 8190, 8191) - Make sure it's different from ComfyUI's port (usually 8188)
Still stuck? Open an issue with details about your setup and any error messages from the startup diagnostics!
SmartGallery is released under the MIT License - see LICENSE for details.
This software is provided "as is" without warranty. Use responsibly and in compliance with applicable laws.
If SmartGallery has transformed your ComfyUI workflow, please give it a ⭐ star!
It takes 2 seconds but means the world to me and helps other creators discover this tool.
See CHANGELOG.md for detailed version history.
Made with ❤️ for the ComfyUI community
