TTP_GIFViewer
The display-only node that ends a Hunyuan3D run
TTP_GIFViewer is the last node in the Comfyui_Hunyuan3D workflow, and it does exactly one thing: it takes the gif_file_path string that Hunyuan3DNode produces and shows that GIF in the ComfyUI UI. That's it. No outputs, no processing, nothing to configure beyond one path. It exists because after the author wrapped Tencent's Hunyuan3D pipeline into a single node, there was no neat way to look at the generated turntable - and this is their answer.
It's a display node, the same shape as PreviewImage but fed a file path instead of an image tensor. Think of it as the "show me the result" step at the end of the 3D run, wired to the gif_file_path output of Hunyuan3DNode (which is only populated when you enable do_render_gif on that node).
How it works
The implementation is gloriously minimal. It takes gif_file_path (a STRING input), splits it into a filename and a subfolder relative to your ComfyUI output directory, and returns that as a standard ui.images result so the frontend renders it like any preview. The author's shipped workflow routes the path through a ShowText|pysssss node before it reaches GifImageViewerNode, but you can wire Hunyuan3DNode's gif_file_path straight in.
The one input
gif_file_path- a STRING holding the path to a.gif. Default is empty, and it's a forced-input widget, so you'll always wire it rather than type it. Hook it to thegif_file_pathoutput of Hunyuan3DNode, or any string path to a GIF.
What to expect
Set expectations before you get here. The README is candid: the author wrote "I can't write frontend code," and the GIF doesn't reliably animate in the UI - you may get a static frame rather than a spinning turntable. If that's a dealbreaker, the rendered output.gif is still sitting in ComfyUI/output/3D_output/<number>/; open it in any player. That's the fallback the README suggests for everything, honestly.
The other limitation is path handling. The node resolves the path relative to ComfyUI's output folder, so a path to some random location outside output/ won't preview. Keep the GIF in the pack's own 3D_output folder and it works.
Installing
Same as the rest of the pack: ComfyUI Manager, search Comfyui_Hunyuan3D, or
cd ComfyUI/custom_nodes
git clone https://github.com/TTPlanetPig/Comfyui_Hunyuan3D
Nothing extra to download - this node is pure display logic. If it ever fails, it's almost always because the path isn't resolvable from the output directory, not because the node broke.
It's the humblest node in the pack, but it's the one that lets you see the payoff of a multi-minute Hunyuan3D run without leaving ComfyUI. Wire it last, and your workflow feels complete.
Inputs (1)
| Name | Type | Default | Description |
|---|---|---|---|
| gif_file_path | STRING | — |
Outputs (0)
No outputs