ltx-director

Edit the hidden timeline_data JSON widget of the LTXDirector node in ComfyUI workflows.

715|111|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/artokun/comfyui-mcp --skill ltx-director
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ltx-director
Source: https://github.com/artokun/comfyui-mcp/tree/main/plugin/skills/ltx-director
Command: npx skills add https://github.com/artokun/comfyui-mcp --skill ltx-director

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The LTXDirector timeline editor node in ComfyUI exposes Add Image, Add Text, and Add Audio buttons as raw DOM elements that agents and MCP tools cannot click, making timeline editing appear impossible. This Skill shows how to drive the node through its hidden timeline_data JSON string widget instead.

Core Features & Use Cases

  • Hidden Widget Control: Read, parse, mutate, and write back the timeline_data JSON string via set_input operations instead of clicking DOM buttons.
  • Segment Authoring: Add, move, retime, or remove text, image, audio, and motion segments with the verified schema, including the imageB64 /api/view URL pattern and track gate flags.
  • Edge-Case Guardrails: Keep normalStartFrame, normalDurationFrames, duration_frames, and segment_lengths in sync, enable track gates, and wire guide_data to LTXDirectorGuide.
  • Use Case: Upload an image to the ComfyUI input directory, append an image segment pointing at it, enable the main track, and validate the workflow so the LTX 2.3 Director graph renders the new timeline.

Quick Start

Ask the agent to add a new text segment to the LTXDirector node in the current ComfyUI workflow and re-time the existing audio segment.

Frequently Asked Questions about ltx-director

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add segments to the LTXDirector node in ComfyUI programmatically?

Read the hidden timeline_data widget, JSON.parse it, append a segment object with id, start, length, and type fields, then write it back as a string via set_input. Never hand-splice the string, and re-read afterward to confirm it round-trips.

Why can't an agent click the Add Image or Add Text buttons in LTXDirector?

Those buttons are raw DOM elements with JavaScript handlers, not node inputs, so MCP and panel tools that drive the LiteGraph node model cannot invoke them. The only control surface is the hidden timeline_data JSON widget.

Why does my LTXDirector audio segment not play after adding it?

Audio segments are ignored while audioTrackEnabled is false in timeline_data. Set the track gate to true in the same edit, and ensure normalDurationFrames matches the duration_frames and segment_lengths widgets.

How do I attach an image to an LTXDirector image segment?

Upload the file to ComfyUI's input directory first, then set imageFile to "<subfolder>/<name>.png" and imageB64 to a /api/view URL pointing at that file. Despite its name, imageB64 holds a URL, not base64 data.

Is editing timeline_data directly supported by the WhatDreamsCost pack?

No, the widget tooltip says it is auto-managed and should not be edited by hand. Well-formed JSON loads fine, but malformed blobs break the editor, so round-trip and re-read after writing and treat this as unofficial.