Turn 8-second MiniMax H3 clips into 1-minute+ films — same face, same voice, synced dialogue, one-shot retakes, one continuous take with no joins, and 2 MP upscaling — all from one ComfyUI node.
🕹️ Try the Interactive Node UI in Your Browser (click through Script, Refs, Timeline, Swap & ⚙ RUN before installing)
📦 GitHub Repository · Hugging Face Mirror
🆕 New in 3.4.0: One Continuous Take (sand_tie)
A whole run of hops renders as ONE video. No joins to see; a take only cuts where you write
anchor: restart.🎬 2:03 one-take music video · 52 s two-person take, street → boardwalk → bench · 65 s walking selfie (upsampled)
Retake one hop and only that hop is redrawn; the rest of the take is kept.
tone_lockkeeps a long take from drifting brighter (0.5 / 0.75 / full).Song-locked takes (
master_audio_file) keep lip sync for the whole song.
🎬 What You Can Do
Simple Mode (Standard MMH3 ref2va / t2va + Realism Boost): Paste standard 6-field MiniMax H3 prompts (passed through verbatim!) or plain prose for single clips (
chains = 1) with the visual REFS rail,realism_boost: on(steps = 6→ 2 base + 10 realism LoRA steps) +audio_refine: on(5 steps), and 2 MP upsampling.Shots Mode (Multi-Hop Chains): One short beat per card (5 s – 15 s each) with camera, framing, pace and join controls.
Visual & Voice Reference Rail (REFS): Up to 9 character/location stills and voice clips right on the node, with @tags and per-hop schedules (no Load Image spaghetti).
Lossless Retake Board (TIMELINE): Every hop is cached. Lock the shots you like, or click ⏵ on Shot 4 to re-roll only Shot 4 while Shots 1–3 load in a second.
Guided SWAP: One-hop character or head swap driven by a reference video's motion & audio (
replace_person,head_swap,face_only,keep_person) with a wardrobe override box and auto-loaded Swap LoRAs.Built-In 2 MP Upsampler: Enlarges the finished film with the H3 latent upscaler and a light 3-step Open-H3-Regenerate-2K redraw. Small, distant faces are redrawn as close-ups so they keep their person.
WRITE (Local AI Writer): Connect LM Studio / llama.cpp to draft shot cards, one-take timelines or music video layouts from a one-sentence brief. STANDARD writes a single checked H3 prompt.
🔗 Three Ways to Join Shots (pin_mech)
motion_context(Default — Built-In): Native latent-slice + audio relay (credit to NikoDemon80). Honest runway withhop_refine: full: ~5–6 clips on Turbo, ~7–8 on non-Turbo before texture changes show. Plan a cut (anchor: "restart") every 4–5 clips.sand_tie(New — One Continuous Take): Each take renders as one video, its hops overlapping windows. Best for long walks, songs and scenes that move through places. Needs a recent ComfyUI (MiniMax H3 context windows) andoverlap0.9 s.hand_tie(Experimental): Renders a low-res preview of the take first and ties every hop to it. Pair withqwen3vl_4b_fp8_scaled.safetensorsinmodels/text_encoders/.
⚡ 60-Second Install
Zero pip dependencies. Needs ComfyUI v0.38.0 or newer. In ComfyUI/custom_nodes/:
git clone https://github.com/sandpies/ComfyUI-Hand-Tie-Clips.git
Restart ComfyUI and hard-refresh your browser (Ctrl+Shift+R).
Drag
workflows/HandTieClips_Starter.jsononto ComfyUI.Drop your character photo onto Row 1 in REFS (e.g.
@maya), write your beats in SCRIPT, and press Queue.
🧩 Recommended Models & Companion Nodes
Turbo DiT: Wuli MiniMax H3 8-Step Turbo + plain
minimax_h3_ref2vaonrefine_model/upsample_ditUpsampler:
minimax_h3_latent_upscaler_3d_bf16.safetensors(models/latent_upscale_models/) +open_h3_regenerate_2k_r256pp_bf16.safetensors(models/loras/)Speed / Attention Nodes: ComfyUI-PlagueKind-Nodes & ComfyUI-KJNodes
💡 The 5 Golden Prompting Rules (H3 runs at CFG 1.0 — every word is additive)
Never name what you want to stop: Don't write "She stops talking" — write "She smiles with her lips closed. Gentle pool water lapping."
Silence must be written as a room tone: An empty soundtrack invents speech. Always name a narrowband sound ("low hum of the refrigerator", "soft breeze").
Don't re-describe the face on Shots 2+: Describe only the new action; the reference rail and join carry her look.
Only words inside the quotes: A laugh or sigh written inside a line is said out loud as a word. Write it outside: she laughs, then says, '…'
Set the final shot's tail to
settleorhold: So the film lands cleanly instead of starting a new gesture on the last frame.
🎞️ One-take tip: in a sand_tie take, every hop opens with the same camera sentence and the action goes on an At mm:ss-mm:ss, timeline. PROMPTING.md has the full rules; WRITE does it for you.
Description
V1.1
Hand Tie Clips 1.1.0
The fix worth updating for: a reference pinned to a later hop tended to be rendered as the shot. The line that tells the encoder what a picture is for was only emitted on hop 1, so a still scheduled onto hop 3 arrived uncited — and a wardrobe plate could be announced as the character's face. Fixed.
- The panel is four tabs now — Script / Refs / Media / Write — with RUN pinned below, instead of one long scrolling column. The Write draft is readable; it used to clip every beat at 110 characters.
- lock and a render range on each shot card. Freeze a take you like and re-render only the hops around it.
- Correct resolutions. H3 is a 768-short-edge model, so the top rung at 16:9 is 1344×768 — the size MiniMax states as native. Eleven aspect ratios across five tiers.
- Reference clips take a description, plus a video input size so a 4K plate isn't decoded at full resolution just to be scaled down.
- Changing one reference re-renders only the hops it rides, not the chain.
V1.01
SMALL BUGFIXES, UPDATE TO 1.01 IF YOU HAVEN'T. (mostly to do with the LM integration and some reference file duplication in the input folder)
Hand Tie Clips v1.0 — talking video that keeps going past one clip.
MiniMax H3 gives you one short clip with sound. This node chains several into one continuous take — same face, same room, dialogue carrying across the joins — from a single queue.
▎ New in 1.0
LM Studio integration
You don't have to write the plan. Describe your scene in a sentence, press Write plan, and it fills in the script and your reference settings, reading the photos you've dropped in rather than guessing from filenames. Treat it as a good first draft — worth a read before you queue, and much faster than starting cold.
Soundtrack input
A music bed. Drop in a track and it sits under the whole chain, ducking automatically under the dialogue. Loop or play once, with fades.
Trim bars on every audio and video input. Drag to choose the section you want. This one matters: H3 encodes your whole voice file no matter how long it is, so a three-minute take is a tax on every second of every clip.
The writer model stays warm between plans and is evicted the moment you queue a render, so it doesn't compete with the sampler for VRAM.
Also fixed: no more invented dialogue over the opening seconds of a clip, non-English lines timed correctly, and reference images keeping the size you set.
Search Hand Tie Clips in ComfyUI Manager.