Hopping Mad Games
77 lines
2.8 KiB
Markdown
77 lines
2.8 KiB
Markdown
# 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.
|
|
|
|
Registry publishing is supported only through the gated release command:
|
|
|
|
```bash
|
|
python3 -m tools.publish_registry_release \
|
|
--changelog "Describe this release"
|
|
```
|
|
|
|
It runs the Manager installation gate and Registry validation before invoking
|
|
publication. The API key is read interactively and sent to `comfy` over
|
|
standard input; it is never placed in process arguments or environment
|
|
variables. Direct `comfy node publish` calls bypass the required release gate.
|
|
|
|
## License
|
|
|
|
GNU General Public License v3.0 or later. See [LICENSE](LICENSE).
|