IMAGE Flipbook Web Viewer @ vrch.ai
A browser slideshow of your latest frames, fades included
- images
- IMAGES
- URL
The plain Web Viewer shows the current frame and fades between updates. The IMAGE Flipbook Web Viewer is the sibling that keeps a little history: it remembers the last several images and plays them as a looped slideshow in the browser window, complete with crossfade timing. If the base viewer is a live monitor, this one is the highlight reel.
What it is
The core settings mirror the base viewer - images in, channel (1–8) to tag the display, server (default 127.0.0.1:8188, i.e. the ComfyUI server itself, no separate host needed), and ssl for HTTPS setups. What makes it a flipbook is the timing trio: number_of_images (how many frames it keeps, default 4, up to 99), image_display_duration (how long each frame holds, in ms, default 1000), and fade_anim_duration (the crossfade length, default 200). There's also refresh_interval (default 5000 ms) controlling how often it pulls fresh frames from the server. Nudge the display duration down and you get a fast ticker; leave it at 1000 with a long fade and it feels like a calm ambient loop.
Two outputs, and only one usually matters. IMAGES is the images passed straight through - a convenience passthrough if you want to keep feeding the same batch downstream. URL is the viewer's address, which you'll want when show_url is on and you're opening the display on another device.
The popup-window behavior is inherited from the whole viewer family. The node opens a browser window on the machine running the workflow - set window_width and window_height (defaults 1280×960) for the canvas size. save_settings remembers your settings across runs, dev_mode shows the debugging harness, extra_params and url are escape hatches for advanced config. server_messages lets the server inject a message string into the page.
How to install
The README ships a ready example (example_web_viewer_002_image_flipbook_web_viewer.json) so you can see the whole thing wired up in one load. Install it the pack-standard way:
cd ComfyUI/custom_nodes
git clone https://github.com/VrchStudio/comfyui-web-viewer
cd comfyui-web-viewer
pip install -r requirements.txt
restart ComfyUI. Or search "ComfyUI Web Viewer" in ComfyUI Manager. Windows portable users run the pip line with python_embeded\python.exe. No models to download.
Common issues
The two things that bite people here are both timing-related. First, refresh_interval and image_display_duration are separate clocks - if you set the display duration short but the refresh long, the flipbook will feel stuttery because it's replaying stale frames. Second, if you're viewing from a phone or a different device on the network, remember the browser-based viewer needs the same CORS setup as the rest of the pack: launch ComfyUI with --enable-cors-header if you hit a blocked-origin error. Get those two right and you've got a genuinely pretty loop running with almost no effort.
Inputs (16)
| Name | Type | Default | Description |
|---|---|---|---|
| images | IMAGE | — | |
| channel | COMBO | 1 | 8 options: 1, 2, 3, 4, 5, 6, +2 |
| server | STRING | 127.0.0.1:8188 | — |
| ssl | BOOLEAN | false | — |
| number_of_images | INT | 41–99 | — |
| refresh_interval | INT | 50001–10000 | — |
| image_display_duration | INT | 10001–10000 | — |
| fade_anim_duration | INT | 2001–10000 | — |
| server_messages | STRING | — | |
| save_settings | BOOLEAN | false | — |
| window_width | INT | 1280100–10240 | — |
| window_height | INT | 960100–10240 | — |
| show_url | BOOLEAN | false | — |
| dev_mode | BOOLEAN | false | — |
| extra_params | STRING | — | |
| url | STRING | — |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| IMAGES | IMAGE | — |
| URL | STRING | — |