Nodes/Comfyui_Hunyuan3D/TTP_GIFViewer
ComfyUI Node

TTP_GIFViewer

The display-only node that ends a Hunyuan3D run

By TTPlanetPig·Created 2 years ago·Updated 2 years ago· 31
TTP_GIFViewer
      gif_file_path

      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 the gif_file_path output 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.

      CategoryImage/Visualize

      Inputs (1)

      NameTypeDefaultDescription
      gif_file_pathSTRING

      Outputs (0)

      No outputs