H3 Video Controller
Video timing, fixed native H3 FPS, resolution presets, automatic size alignment and shared metadata for MiniMax H3 workflows.
H3 Video Controller 1.2.3
Author: Aman Dolorain
Controls MiniMax H3 duration, resolution and frame rounding. Produces a native empty joint video/audio latent and timing metadata. Requires ComfyUI with native EmptyMiniMaxH3LatentAV support.
Inputs
- duration_seconds
- fps: native H3 24 FPS (fixed)
- width, height
- resolution_preset
Size rounding is automatic nearest multiple of 32; frame count rounds up to the supported H3 frame grid. Neither rounding dropdown is shown.
H3 timing and size rules are unchanged from 1.0.0: fixed 24 FPS, frame grid 17k+5, dimensions aligned to 32. Use actual_duration_seconds when matching audio to the prepared clip.
Outputs, in order
- latent
- video_info
- frame_count
- fps
- actual_duration_seconds
- width
- height
- summary
Reference workflow
Connect width, height and frame_count to the separate MiniMax H3 Reference to Video connector's width, height and length. Connect the separate prompt STRING, CLIP, VAEs and references directly to that connector. Use the connector's positive and LATENT outputs for reference-conditioned sampling. The controller's latent is an independent empty latent; it does not contain reference conditioning.
Upgrade from 1.0.0
Replace the complete H3VideoController folder and restart ComfyUI, then hard-refresh the browser. Back up your workflow, remove the old H3 controller and add a fresh H3 Video Controller. Reconnect by output name: removing positive shifts output socket indices. The old clip, video_vae, first_frame, last_frame, prompt, prepare_mode, size_rounding and frame_rounding inputs are removed. FPS is shown as fixed 24 because native H3 does not support a different generation FPS. Other controls retain their behavior.
Branding
The internal bottom bar uses the node header color. White ♪ Aman Dolorain text copies the title font and left inset in the Vue frontend, matching the approved VideoControl footer. A classic canvas fallback is included.
Validation
Run python -m unittest discover -s tests -v. Native-source checks are optional with COMFYUI_H3_SOURCE set. Full GPU generation and frontend appearance must be verified in the target ComfyUI installation.
Legacy workflow repair in 1.2.1
The frontend repairs old positional widget values, removes obsolete inputs and duplicate/obsolete output layouts when loading a workflow. Invalid output layouts are disconnected and rebuilt; reconnect these wires by name. This avoids silently retaining wires whose meanings shifted in an earlier update. Back up your workflow before upgrading. Replace the complete folder so web/migration.js is included. Restart ComfyUI, hard-refresh, and reopen the workflow.
Resolution controls in 1.2.2
Selecting a resolution preset updates the visible width and height. Custom preserves the entered dimensions; execution aligns them to the nearest multiple of 32 (minimum 32). Returning to Custom restores the last custom size, saved in node properties. Editing either dimension while a preset is selected switches to Custom. Loaded workflows synchronize the selected preset after legacy migration. Install the complete folder including web/resolution.js.
Registry release 1.2.3
Removes dynamic source execution from an optional development test and excludes development-only files from Registry archives. Runtime behavior is unchanged. See REGISTRY_INSTALL.md for confirmed install-gate findings, external scan-status limitations and release steps.