The compose step previously built the timeline at the manifest resolution while staging segments are written at the (hidden) half-res sampling size, so ffmpeg's overlay pasted the smaller segments into the top-left quarter of a black full-res canvas and the combine's restore gate saw frames already at the manifest size and never fired. - compose_h3_project_video now probes the timeline segments and composes at the size they all share (_uniform_probed_size; manifest dims remain the fallback for mixed/unknown sizes) - restore_project_video_resolution (utils/rtx_vsr.py) fast-probes the composed file, and when it differs from the manifest decodes once, upscales (RTX VSR, Lanczos fallback, exact size) and rebuilds the video so VIDEO, images, audio and fps all carry the editor-selected resolution; any failure keeps the original video - the restore lives in the base combine so MoxieCombine (images slot) and the legacy GetVideoComponents wiring are both covered; the duplicated images gate in MoxieCombine is gone
21 KiB
21 KiB
Changelog
[Unreleased]
⚡ Improvements
- MultiTrack Project / Moxie Project Video Combine: Single-pass projects now condition and sample at half the editor-selected resolution internally. The project timeline is composed at the segments' own size, and Moxie Project Video Combine restores the exact editor-selected resolution in pixel space before any output leaves the node (RTX Video Super Resolution via the optional
nvidia-vfxpackage when available, with an automatic Lanczos fallback otherwise) — so both theVIDEOoutput and theimages/audio/fpsoutputs carry the full editor resolution regardless of template wiring. The editor resolution therefore stays the final output resolution while the sampling chain runs smaller and faster. Dual-pass, SelfLift, and passthrough modes are unchanged. - Moxie Multimedia Loader: The
lora_namecombo now defaults to the bundled turbo LoRA (MM3step.safetensors) so a fresh clone of the pack works out of the box, with anoneentry to disable LoRA. Previously the default was a"<no files found>"placeholder, which silently skipped LoRA application even when a LoRA was bundled. - Moxie Preview Override: The
tiny_vaecombo now lists files from the node pack's ownmodels/vae_approxfolder first (shippingMM-preview.safetensorsfor MiniMax H3 previews as the default), falling back to ComfyUI's standardmodels/vae_approxdirectory. The folder is rescanned on every schema refresh, so newly dropped files appear without restarting ComfyUI. - Moxie Multimedia Loader: Locked the loader to the MiniMax H3 model set. The
clip_typedropdown (which previously exposed every CLIP recipe in ComfyUI) was removed; the H3 Qwen3-VL text encoder is now always loaded with theminimaxCLIP recipe. Any older ComfyUI build withoutCLIPType.MINIMAXraises a clear startup error instead of silently loading the wrong encoder. - Moxie Multimedia Loader / Moxie MultiTrack Project: Removed the legacy
FAST_MODEL_LOADER(model_loader) bundle. The loader now outputs exactlymodel,clip,video_vae, andaudio_vae(with the attention backend and LoRA already applied to the model), and the Moxie MultiTrack Project takes those four outputs as required direct inputs instead of a bundled loader.Moxie Preview Overridelikewise dropped itsmodel_loaderpass-through slots and now patches themodelinput directly. The genericeasy multitrackProjectnode keeps itsmodel_loaderinput for non-Moxie workflows.
[1.3.3] - 2026-09-25
✨ New Features
- Multi-Image Loader: Added the
easy multiImagesLoadernode, supporting loading up to 25 images.
🐛 Bug Fixes
- MultiTrack Project: Fixed TE being executed an extra time in
Dualmode. - MultiTrack Editor: When a single segment covers the entire task window, crop and resize it directly instead of recomputing through the reference path, fixing #84. The media loading timeout in this path is set to 60 seconds.
- MultiTrack Editor: [Motion transfer & subject replacement] When the source video frame rate differs from the editor frame rate, smart-split segments now split using the editor frame rate, and when paused or stepping frame-by-frame the requested frame is returned via ffmpeg's
fpsfilter as the preview image. - MultiTrack Project: [Motion transfer & subject replacement] Locked videos now use uniform temporal resampling. Previously, when the locked duration did not conform to the
17k+5frame pattern, the value was rounded up and padded to fit the current frame count, which caused some frames to freeze early. Resampling now uses a uniform temporal distribution so added frames are spread evenly across the timeline rather than clustered at the tail, eliminating the freeze. - Audio Lock: Fixed redundant repeated encoding/loading when locking audio across multiple segments of long videos. Due to the multitrack project design, all audio locks are processed before the reference video generation node, so when video is present, ffmpeg is used to extract and cache the audio. Videos without audio and muted tracks no longer lock audio or repeat audio probing, while their video timeline timing remains unchanged. The
audioinput oneasy minimaxH3AudioLockis now optional; leaving it disconnected passes the latent through unchanged instead of erroring.
[1.3.2] - 2026-09-20
⚡ Improvements
- MultiTrack Project: Optimized project media, segment media, TaskOutput, and per-segment H3 conditioning caching to avoid media reloads and repeated first-pass conditioning encodes when re-executing without parameter changes.
- H3 Conditioning Cache: Store up to five recently used segment caches in ComfyUI's temporary directory, reset the pool when its project, model, or upstream media cache scope changes, rebuild zero-filled initial AV latents from compact metadata, and report a per-category tensor size breakdown after each write.
- MultiTrack Project: Enhanced action continuity in context mode and optimized lip-sync when audio is locked.
- MultiTrack Editor: Added the ability to freely drag and adjust the width ratio between the image item area and the prompt area within segments. Optimized the UI display of user prompt highlight tags.
- MultiTrack Project: Added
selfliftoption tosampling_mode, adapted from comfyui-SelfLift - Character Swap Context: Switched to
drive_controlapproach instead of the previous noise-based method. Testing showsdrive_controlis more stable and preserves more motion details. Although it may appear slightly less sharp visually than the noise approach, it is better suited for preserving source motion during character replacement and motion transfer.
🐛 Bug Fixes
- Context: Fixed context loading latent preferring the previous segment's selected latent instead of the most recently generated latent by timestamp.
- Video Reference: Fixed video reference frame alignment. Previous version had frame loss in motion transfer scenarios when timeline was locked, causing reference to fall back to image.
- MultiTrack Editor: When segment A has a gap with segment B, adjusting segment A's duration should first fill the gap duration before propagating changes to subsequent segments.
- MultiTrack Editor: Fixed some UI interaction compatibility issues with Node2.0, improving the overall operational experience.
[1.3.1] - 2026-09-07
✨ New Features
- MultiTrack Prompt Enhance to Project: Added
easy multiTrackPromptEnhanceToProjectnode, which supports directly applying the MultiTrack Prompt Enhancer's output to the MultiTrack Project. - Character Swap Context: Added the
context_swapcontinuity mode for MiniMax H3 task segments. It preserves motion continuity while weakening the previous character's appearance with disposable tapered latent noise. - Dual-Pass Swap Continuity: Apply swap noise independently to the low-resolution first-pass context and the high-resolution second-pass context. Audio remains untouched, and only clean trimmed/re-encoded context latents are saved for later segments.
- Video-Track Audio Lock: Lock a video track segment as the timeline constraint for MiniMax H3 generation, ensuring the output duration matches the video; once locked, the audio is synchronized and locked as well. To replace the audio lock, you can lock another audio track as the new audio source while keeping the video track unchanged for the visual. (Mainly used for motion transfer and character replacement.)
- Minimax Prompt Override: Added the
easy minimaxPromptOverridenode, which supports assembling prompts and other parameters into the multitrack editor's prompt_override, suitable for explicit passing in.
⚡ Improvements
- Character Swap Context (drive_control): Switched from the previous noise-based approach to
drive_control. Testing shows drive_control is more stable and preserves more motion details. Although it may appear slightly less sharp visually than the noise approach, it is better suited for preserving source motion in character replacement and motion transfer scenarios. - MultiTrack Project Media Preparation: Consolidated task-scoped image, audio, video, shared-media, and locked-audio preparation so project expansion loads and forwards only the media required by each segment.
- Clear Redundant Subgraph Cache: Fixed an issue where execution_cache in multi-track project subgraphs was unnecessarily storing video objects, causing additional memory accumulation.
🐛 Bug Fixes
- Responsive Width Preservation: Fixed an issue where all custom easymedia components would shrink in width after clicking the ComfyUI properties panel.
- Frame-Accurate Video Trimming: Normalize source frame rates before trimming merged video inputs to keep segment boundaries aligned with the project timeline.
The tapered context-noise approach used by Character Swap Context is adapted from MacroSony/minimax-h3-chained-character-swap.
[1.3.0] - 2026-09-03
✨ New Features
- MultiTrack Project: Currently adapted for MiniMax, mainly used to simplify the pipeline. It handles multi-track loop segment encoding, sampling, and decoding/saving, supports specifying segment start position and maximum generation count.
- MultiTrack Project Video Combine: Preview uncombined segment outputs, supports automatic and manual combining.
⚡ MiniMax H3 Optimizations
- Motion Context & Resampling: Optimized the pairing of the original
MotionContextwith resampling. In the current default sampling configuration:mediumproduces smoother results, whilelightcannot sample sufficiently in the first sampling due to sigma separation. - Motion Context Latent Memory: Keep only the 22-frame high-resolution audio/video context tail on CPU between segments and in completed project artifacts, while retaining the complete low-resolution first-pass checkpoint for deferred second-pass runs.
- Multi-Track Editor (Audio Track): Added
Lock Audiofeature, only applicable under MultiTrack Project. When generating video, audio will no longer regenerate, but instead schedules video frame output based on this audio. - Multi-Track Editor (Audio Track): Added
Reuse Audio- all segments can reuse this audio (previously required cloning to each segment), supports up to 15 seconds without being truncated by segments. - Multi-Track Editor (Shared Media): Images, audio clips, and video clips can be marked as shared references when context segments need to reuse the same media. Shared images are placed before each task's local images; shared audio uses up to the first 15 seconds of its source.
- Multi-Track Editor (Task Track): When multi-selecting task segments, you can uniformly adjust task mode, transition mode, and reference image size.
- Multi-Track Editor (Task Track): New feature added.
- Multi-Track Editor: Adjusted many texts for better understanding.
- Multi-Track Task Output: Adjusted minimum value of task_index to -1. When -1, it can output all track complete media information like the previous Multi-Track Editor. (Due to the previous optimization, the Multi-Track Editor cannot directly output complete content)
- Multi-Track Editor: Defer file and URL media loading when no slot resources are referenced; task output nodes now materialize only the media they need, reduce unnecessary media resource overhead in long-form video tasks. (Now you just need to connect
TRACKS_INFO; theimage,video, andaudiooutput by the multi-track editor will all beNonein Slot-less resource mode.)
🐛 Bug Fixes
- Multi-Track Slot Media: Added video slot selection and fixed image, audio, and video slot discovery and downstream delivery through
TRACKS_INFO, including sparse lists that skip empty inputs and graphs whose link ID is0.
[1.2.1] - 2026-08-22
✨ New Features
- Multi-Track Editor: Added right-click context menu to clone audio segments and video segments
🐛 Bug Fixes
- Multi-Track Task Output: Fixed that segments without audio/video in
MiniMaxformat should output as None
[1.2.0] - 2026-08-21
✨ New Features
- Compare Video: Added
Side-by-side Comparemode, support for directly selecting media for comparison, andWatch Output Historymode - Media Selector: Added support for multi-selecting image items and selecting all images in current path
- Multi-Track Prompt Enhancer: Added this node, supports prompt enhancement for models like h3-context-ir, supports local model usage
- Multi-Track Prompt Enhancer to Project: Added
easy multiTrackPromptEnhanceToProjectnode, supports directly applying the output of the multi-track prompt enhancer to the multi-track project - Multi-Track Editor: Added user prompt A/B output, supports selecting different user prompt outputs
- Multi-Track Editor: Added user prompt reference functionality, supports referencing resources via
<Picture 1>,<Audio 1>,<Video 1>,@图片1and similar methods, supports multi-element combinations
🐛 Bug Fixes
- Multi-Track Editor: When two adjacent task segments are connected, modifying the front segment's duration should increase the total duration
- Media Selector: Fixed breadcrumbs should support recursive subdirectories
- Media Selector: Fixed image re-selection issue
[1.1.4] - 2026-08-05
✨ Features
- MultiTrack Editor: Add
MiniMaxvideo format - MiniMax H3: Add
easy minimaxH3ToVideofor text-to-video, reference-to-video, and first/last-frame conditioning - Media List Utilities: Add
easy splitAudiosandeasy splitVideosto split media lists into independent outputs - MultiTrack Editor: Video, audio, and subtitle tracks support dragging the left-side icon to adjust sorting; each track type is limited to a maximum of 3 tracks
🐛 Bug Fixes
- Multitrack Editor: Fixed an issue where, in
MiniMaxformat, theMultitrack EditorandMultitrack Task Outputwould output empty clips when neither the video track nor the audio track contained any clips. - MultiTrack Editor: Fix
TRACK_INFOoutput when duration is less than 5 seconds — total duration should be the actual total duration of task segments, not the default 5 seconds - MultiTrack Editor: Task track segments support free placement while preserving gaps; new task segments can be added directly between segments to fill gaps
- MultiTrack Editor: Fix issue where dragging to trim from segment edge hot zone caused the trim frame to shift based on mouse position or canvas zoom level
- MultiTrack Editor: Fix incorrect time ruler click position calculation after canvas zoom, causing playhead positioning and toolbar left/right trim time offset issues
- MultiTrack Task Output:
MiniMaxformat trims audio/video from the next task segment's start point to the media track segment's actual end; the last task trims from its own start to the media's effective end, without outputting trailing black frames or silent audio - MultiTrack Info Output: Total duration is calculated as the sum of task segment durations, automatically skipping gaps between task segments
- MultiTrack Editor: Fix node height recalculation when adding or removing tracks — should recalculate node height instead of adapting to the preview area height
[1.1.3] - 2026-07-30
✨ Features
- MultiTrack Editor: Add task markers, allowing multiple task segments to be used as one loop task
- MultiTrack Editor: Add track overview, allowing segments to be expanded to view prompts and reference images
- MultiTrack Editor: Support importing SRT files to subtitle track
- MultiTrack Audio Output: Add cropped audio output mode, outputting cropped audio clips and starting frame number for easier S2V usage
- LTX Workflow Simplification: Add
easy ltxMultiTrackEncodeand multiple simplified LTX workflow nodes
🐛 Bug Fixes
- MultiTrack Task Output: Should output empty system prompt when prompt format is
defaultorpromptRelay - MultiTrack Editor: Fix issue where only the first audio was output when inputting audio list in App mode
- MultiTrack Editor: Fix issue where segments cannot be added at the beginning or between segments on audio and subtitle tracks
[1.1.2] - 2026-07-12
✨ Features
- MultiTrack to S2V Output: Outputs cropped audio clips and starting frame number for easier S2V usage
🐛 Bug Fixes
- Media Selector: Fix issue where media selector did not stay in subdirectory after reopening when subdirectory was selected last time
- LTXV Reference Video: Optimizing the Use of
LTXVMakeRefVideo - MultiTrack Editor: Fixed inconsistent left-side crop behavior compared to standard editing tools
- MultiTrack Editor: Fixed incorrect waveform display after cropping audio clips
[1.1.1] - 2026-07-11
🐛 Bug Fixes
- MultiTrack Editor: Added empty state prompt message, removed 720 panorama feature from image items, added single image preview
- Merge Videos From Paths: Optimize video processing and add audio option
- Compare Video: Fix mute issue by default, and add option to save video to reduce the need for extra video save nodes
[1.1.0] — 2026-07-09
✨ Features
- MultiTrack Editor: Add initial version of multitrack editor with supporting nodes, supporting multitrack video, audio editing, segment editing and preview
- Media Selector: Add directory store cache for media selector to solve the problem of frequent fetching of list data from backend
- Split Image: Support image list or image batch type image splitting, applicable to
Bernini multi-referencescenario - Merge Videos From Paths: Add
frame_countto support clipping
🐛 Bug Fixes
- MultiTrack Editor、TimelineEditor: Fixed the default width and height when creating nodes
- Media Selector: Fix resource sorting should be by
name,creation time,folder first - Media Selector: Fix issues where keyword is not cleared when entering subdirectory after searching
[1.0.4] — 2026-06-16
✨ Features
- Save Video: Add
hide&saveoption to hide output video node output while saving video - Timeline Editor (App Mode): Add
[0-5s]time range parsing support forprompt_override - Timeline Editor (UI Mode): Sub-track supports
drag and drop to import images
🐛 Bug Fixes
- Timeline Editor (UI Mode): Fix the issue where sub-track image should proportionally adjust duration when segment duration is modified in main track
- Timeline Editor (UI Mode): Fix incorrect audio preview display after importing audio subdirectory
[1.0.3] — 2026-06-06
✨ Features
- Bernini Temporary Solution: Add
Bernini conditioningandBernini Model Patchnodes as a temporary solution before ComfyUI official Bernini support - LTXV Reference Video: Add new node for multi-reference Lora model
🐛 Bug Fixes
- Timeline Editor (UI Mode): Fix
node heightbeing reset to default whencanvas refreshandresolution optionare switched - Timeline Editor (UI Mode): Fix issue where segment content cannot be edited in some cases under
overall editingprompt mode - Timeline Editor (UI Mode): Fix adaptive node and track height issues, add
clone segmentin right-click menu forwan2.1 berniniandLTX2.3 R2Vusage
[1.0.2] — 2026-05-31
🐛 Bug Fixes
- Timeline Editor (App Mode): Fix issue where segments should evenly distribute default duration when
prompt_overrideis not strictly in prompt format - Timeline Editor (App Mode): Fix issue where only one audio segment is used to fill the entire timeline - need to filter out empty audio first
- Timeline Editor (UI Mode): Fix resource output and sorting errors when a single segment contains different formats
[1.0.1] — 2026-05-27
✨ Features
- Workflow: Add wan2.2 loop segment example workflow
- Frontend: Add
+button when segment is selected to add segments before or after, and fix some known bugs
🐛 Bug Fixes
- Fix incorrect image links imported from output and subdirectory, causing images and outputs to be filtered out in editor
[1.0.0] — 2026-05-25
💥 BREAKING CHANGES
Duration & Frame Rateinput only takes effect onblur(must press enter or click outside input box to confirm changes)Duration Inputstep change: step is4when format is frame count,1when format is seconds- Segment duration editing no longer affects other segments - if total duration exceeds main track after modification, main track will automatically adapt to the sum of all segments
✨ Features
- Timeline Editor: Track auto-adapt height, image and audio segments require double-click to enter media selection interface to avoid accidental triggering
- Timeline Editor: Add dynamic parameter injection settings, support prompt template format + multimedia input for timeline editor usage