Muse Collective LTX Timeline V10 (V6 + LTX Director CS merge, WIP)

V10 is the director node at its most ambitious - and the one you should read the licensing section of before you share anything built with it. It's a fork of V2.5 merged with CGlide's "LTX Director CS," which drags in Ghost Mask's Licon MSR reference-guide logic and a pile of pipeline features: LLM-driven segment overrides (now eight of them), single_stage_mode, NAG negative-prompt support, per-segment chunking, and Seed Hunt. It's the kitchen-sink version.

The honest framing from the README: this is WIP, and it ships with a real legal asterisk. The Ghost Mask/MSR code in V10 is ported from CGlide's GPLv3 fork, not clean-room rewritten, so the repo is a mixed MIT/GPLv3 codebase. Fine for private use - GPL obligations only bite on distribution - but you can't publish, sell, or share the repo itself as MIT until that code is rewritten. If you just want to generate video on your own machine, that doesn't affect you. If you're building something to ship, it does.

What V10 adds

The headline features, with the ones you'll actually touch first:

• segment_override_1..8 - the V2.5 override system extended to eight segments. Pairs with MusePromptSplitter, which parses up to eight labeled prompts (and informational durations) out of one LLM text block. This is the "let an LLM direct the whole timeline" pipeline.
• single_stage_mode - skip Stage 2 entirely and sample once, directly, at full target resolution. The tooltip's advice matters: stage1_steps becomes your only step count, so raise it (8 is a draft value meant for the two-stage flow).
• auto_chunk_by_segment - chunk boundaries snap to your timeline segment boundaries: one chunk per segment, never straddling. chunk_duration_seconds and auto_chunk_threshold are ignored while it's on. This fixes a real bug class where a chunk boundary split a segment and the carry-frame overlap corrupted the prompt mapping.
• NAG negative-prompt support - negative_prompt plus nag_scale/nag_alpha/nag_tau with nag_bypass as a hard kill-switch. Requires the comfyui-kjnodes package's LTX2_NAG - a dependency the README doesn't list.
• ghost_anchor_buffer - fixes a confirmed artifact where Ghost Mask (End) built up hallucinated "watermark/archway" overlay content in the last ~6-12 frames of a chunk.
• enable_ambient_pass - kill switch for the LoRA-free ambient audio pass, which the notes identify as the source of a duplicated/echoed-voice artifact in generated-audio mode.
• reference_mode / ref_images / msr_prefix_frames - the character-reference modes, fed through the timeline's character-card panel rather than graph sockets (deliberate).
• automation_start / automation_end / automation_duration - connection-only inputs so an external automation node can drive the render window.
• optional_latent - override the auto-generated empty latent for chunk 1 (ported from CGlide), ignored if the shape doesn't match.

Seed Hunt carries over, as does everything from V2.5.

Installing it

cd ComfyUI/custom_nodes
git clone https://github.com/muse-collective-26/muse-ltx-timeline

Restart, pip install av torchaudio soundfile, LTX 2.3 stack. If you use NAG, install comfyui-kjnodes separately.

Gotchas

• Read V10_NOTES.md in the repo - it's the internal changelog and it's unusually candid about which features fixed real bugs (Ghost Mask anchor artifact, ambient-pass duplicate voice).
• The GPL thing again: private use, fine; distribution, not fine until the ported code is rewritten. That's not FUD, it's the author's own warning in the README.
• V10 loads as a WIP module in a try/except. Missing kjnodes won't kill the pack, but NAG features will be inert or the node may not register.

V10 is what happens when a power user gets to spec a director node: more switches than you'll ever use, but the ones you do use - segment overrides, single-stage mode, NAG - are genuinely good. Just don't build a business on the current license state.