# ETK LTXV Timeline Image Editor

Standalone visual timeline editor for LTXV/LTX 2.x image guides in ComfyUI.

The editor provides live image and transparent-text composition, layer
locking, font controls, outlines, drop shadows, per-keyframe prompts and guide
strengths, and frame-accurate placement. It emits both composited and original
image batches plus aligned prompt, strength, frame-index, and time lists.

The workflow node key remains `ETKLTXVTimelineImageEditor`. Existing workflows
therefore load without migration, input renaming, output rewiring, or serialized
timeline conversion. The legacy `EternalKernelLiteGraphNodes` package re-exports
this class for Python callers but no longer registers a second backend copy.

The pack owns the editor node, timeline schema, image and text-layer rendering,
connected-image handling, and browser editor. It does not load a model, CLIP,
or VAE.

## Installation

Install `ETK LTXV Timeline Image Editor` from ComfyUI Manager, then restart
ComfyUI. For a manual installation:

```bash
cd ComfyUI/custom_nodes
git clone https://git.hoppingmadgames.com/hmg-comfy/ComfyUI_ETK_LTXV_Timeline_Editor.git
```

No model downloads or additional Python packages are required beyond a current
ComfyUI installation.

## Use

Add **ETK LTXV Timeline Image Editor** from `ETK/Image`. Set the target width,
height, LTX-compatible frame length, and frame rate, then open the editor from
the node. Images can also be supplied through the optional `images` input.

The workflow-facing node key remains `ETKLTXVTimelineImageEditor`; workflows
created with the original node continue to resolve the same node identity.

See the in-app node help for the complete input and output contract.

## Validation

```bash
python3 -m pytest -q tests
node --check web/etk_ltxv_timeline_image_editor.js
find web/ltxv_timeline -name '*.js' -print0 | xargs -0 -n1 node --check
```

Every Registry release tag must also pass the Manager installation gate:

```bash
python3 tools/verify_manager_install.py --source .
```

The gate reads the public repository from `pyproject.toml`, disables ambient
Git credentials, performs Manager's recursive clone into a clean
`custom_nodes` directory, verifies the release commit and version tag, and
compiles every shipped Python and JavaScript source from the clone. The Gitea
tag workflow runs the same command before a release is considered installable.

## License

GNU General Public License v3.0 or later. See [LICENSE](LICENSE).