A ComfyUI custom node for video preview on multiple physical monitors
Preview videos, image sequences, and images with interactive on-screen controls, snapshots, and generation tracking
See the demo: https://www.youtube.com/watch?v=1574Y_pF5Ec
The Monitor Interface
In/Out Marking System. Set Range Instantly - Press I for IN point, O for OUT point at current frame, reset with P; or use the "In" - "Reset" - "Out" circle buttons
"First Frame is" and Speed FPS dropup menu. Select what number to represent as first frame in the timeline. Type your fps speed or choose it from presets.
Generations cycling menu - Display your creative history instantly to the monitor. Rename generations as you go.
Wipe Compare by pushing the gen squares buttons 1 time on the target and divide the screen, you can even zoom and pan while on wipe mode. As soon as you click and hold, the yellow wipe interface devider dissapears and you see a clean wipe that you can move side to side. As soon as you release the left click, the yellow wipe devider interface comes back right where your pointer is. Deactivate wipe with W shortcut.
SBS Compare by pushing the gen squares buttons 2 times on the target and divide the screen side by side. You can even zoom and pan while on sbs mode and mirror both sides transformations windowed on each side. Deactivate sbs with W shortcut.
ClearCache. "Deletion confirmation" and "Explore" buttons.
Take Snapshots of your creative process anytime. Whatever is on screen at that moment will be saved to a webp file with your comfyui workflow injected in it. Share the webp or open it later in comfy and continue working from there. The Snapshots and Generations work orchestrated together maintaining naming sync. Explore the dir and grab your history work and continue creating.
VISION module with all the controls you need for inspection and visualization. The first thing you see are the Gain, Gamma snd Saturation sliders; and then the buttons on the right.
The Node
-
Future versions: We´ll work on a more advance, fast and less consuming RAM and GPU engine.
Note: If PVM consumes more resources than you are willing to accept, consider waiting for future updates.
-
Long term development is a 3D system in the monitor to visualize 3D geometry and gaussian splats
Intuitive Timeline Scrubbing - Click and drag anywhere above the timeline for precise frame control
Frame-Perfect Navigation - Step through frames with keyboard arrows (← →)
Smart Playback Modes - Forward, Backward, and Ping-Pong playback with single-click switching
Instant Play/Pause - Spacebar toggles playback instantly, right from your keyboard home row
One-Click Fullscreen - Press 5 to enter true fullscreen mode, ESC or 5 again to exit
Smart Fit Modes - Instant switching using numbers 1:1 (1), Fit (2), Width (3), Height (4), and Fullscreen (5). Press again and you retun to Fit
Keyboard-Optimized Shortcuts - All controls under your left hand without looking at the keyboard
Multi-Monitor Ready - Display on any monitor with automatic resolution detection
Set Range Instantly - Press I for IN point, O for OUT point at current frame
Visual Timeline Feedback - Blue highlighted areas with red marker lines show your selection
Smart Playback Bounds - All playback modes respect your marked range automatically
Quick Reset - Press P to instantly reset to full media length
Dynamic Real-Time Interface - All controls moved from static nodes to interactive monitor
Intuitive Zoom & Pan - Mouse wheel zooms anchored to cursor, right-click drag pans
Instant Fit Modes - Click buttons or use number keys 12345 for instant view adjustments
Live Visual Feedback - Buttons light up with color-coded active states
Cross-Session Preservation - Your creative generations survive ComfyUI restarts and system reboots
Unlimited Version History - Store every iteration of your work without worrying about limits during sessions
Rename any Generation instantly to keep your creative sessions organized and highlight the moments that inspired you!
Instant Time Travel - Dropup menu with keyboard navigation (↑ ↓ ENTER) to revisit any point in your creative journey Visual Generation Gallery - Hover and click to instantly resurrect any previous creation
Take Snapshots of your creative process anytime. Whatever is on screen at that moment will be saved to a webp image with your comfyui workflow injected in it. The Snapshots and Generations work orchestrated together maintaining naming sync. PreviewVideoMonitor saves snapshos data inside its own default folder custom_nodes/PreviewVideoMonitorPro/, but you can change this to your own custom directory directly from the node with one click, super easy, and giving you full control over where Snaps are kept.
GPU-Accelerated Processing - Automatic CUDA detection with OpenCV & PyTorch backend fallbacks
Smart Caching System - Dynamic frame caching with memory management
Real-Time Resolution Handling - Automatic scaling with maintained aspect ratios
Custom FPS Control - Playback at your exact desired framerate
Live Frame Counter - Real-time display with custom starting frame numbers
Resolution Overlay - Always-visible original media resolution
Color-Coded Interface - Intuitive button states with meaningful color schemes
Professional Timeline - Extended scrubbing area for easy frame selection
The Vision module transforms your monitor into a technical inspection lab for AI-generated imagery.
Isolate RGB channels to detect hidden artifacts, use the live vectorscope to analyze color distribution,
and stress-test your generations with diagnostic controls that reveal edge cases normal viewing might miss.
Combined with masking capabilities and frame-accurate analysis, Vision gives you forensic-grade tools to
evaluate what the AI actually generated—not just what it appears to show.
Multi-Format Support - Videos, image sequences, tensors, and all ComfyUI video formats
Flexible Input Sources - Direct files, node outputs, or generated content
Seamless Workflow Integration - Works alongside your existing ComfyUI pipelines
Cross-Platform Ready - Windows, Linux, macOS with automatic fallback handling
Space = Play/Pause
← → = Frame stepping, keep hold and scrubb at 30fps fast
I/O = Set IN/OUT points P = Reset in out to full length
1-5 = Fit modes (1:1, Fit, Width, Height, Fullscreen)
ESC = Exit fullscreen
Shift+q = Close entire monitor interface
ENTER = Toggle generations menu and also once in it triggers change generation name
Cycling the RGB channels: Use "r" "g" and "b" shortcuts to see the red green and blue channels in the monitor
PreviewVideoMonitor is an advanced video/image viewer with powerful caching and workflow-saving features. However, it is not designed to be your primary file management system. Key Points:
Always use Save nodes (e.g., Save Image, Save Video, etc.) to permanently store your final work in your regular working directory or custom pipelines. PreviewVideoMonitor should currently be treated as a volatile preview system — ideal for creative sessions and quick iterations, but not for long-term storage. PreviewVideoMonitor can save files to disk, its internal session data and cached files are stored inside its own default folder custom_nodes/PreviewVideoMonitorPro/, but you can change this to your own custom working directory directly from the node, super easy, and giving you full control over where files are kept. This internal storage may be cleared by users (or accidentally by you) or changed between sessions or updates, so do not rely on it for keeping your work 100% safe.
The cache and display engine it´s still in it´s early design phases and is still not at peak efficiency. If PVM consumes more resources than you are willing to accept, consider waiting for future versions.
As reference, it´s absolutly not recomended to use a GPU under 12GB VRAM, also take a "rtx nvidia 3060" as the minimum processing power base you would need. Is also recommended to have a CPU of at least 8 cores horse power.
V3.3 and V3.2 (deprecated) This is the first release of PVM with user interactive interface and on-screen controls.
V2.0 (deprecated) Major update fixing smooth playback problems and the core engine rendering the frames.
V1.0 (deprecated) This was the main bridge comfyui-pygame tool with basic functions to send the media to a secondary physical screen.
☕︎ Please support, just $1 can make a real difference ☕︎
https://buymeacoffee.com/cratetools
⭐Can’t or don’t feel like donating? No worries at all! Just giving the repo a Star helps others discover it
Share this tool with anyone you think would enjoy it!
Report any bugs you come across
Contribute improvements
🐍 Special Thanks to PyGame - Preview Image Monitor relies on the powerful Pygame library to handle cross-platform window creation, display management, and image rendering. We extend our sincere thanks to the Pygame developers and contributors for their invaluable work. https://github.com/pygame
PLEASE READ THE LICENSE FILE
Please note that at the moment this tool is developed and tested over Windows 10 We can confirm the tool works well after installing it from ComfyUI Manager on both ComfyUI Desktop and Portable with automatic dependecies intallation
