Update README.md

92857ea verified 1 day ago

4.38 kB

tags:
  - lora
  - ic-lora
  - ltx-2.5
  - video
  - video-editing
  - image-to-video
  - comfyui
base_model: Lightricks/LTX-2.5
base_model_relation: adapter
license: other
license_name: ltx-2-community-license-agreement
license_link: https://github.com/Lightricks/LTX-2/blob/main/LICENSE-2_x
library_name: comfyui
pipeline_tag: video-to-video
widget:
  - text: >-
      Example of replacing an object, adding special effects, and changing the
      lighting all at the same time. The scene reacts to both new light sources.
    output:
      url: Examples/ltx_001.mp4
  - text: >-
      Example of changing the lighting and background of the first frame, and
      the rest of the video is figured out without prompting, even when the
      camera swivels around.
    output:
      url: Examples/ltx_002.mp4
  - text: >-
      Editing the first frame to be on fire, the effect stays consistent
      throughout multiple camera cuts.
    output:
      url: Examples/ltx_003.mp4
  - text: >-
      Example of Ripple understanding that the liquid has been added in the
      first frame, and the liquid inside the glass flows in accordance with the
      original video's movement.
    output:
      url: Examples/ltx_004.mp4
  - text: >-
      Example of archviz/3d clay model texturing with only the untextured video
      and a textured first frame input. Texturing effect ripples through scene
      cuts.
    output:
      url: Examples/ltx_005.mp4
  - text: >-
      Here an interesting effect can be seen: because the edited first frame was
      sharper (notice the dragon details), the entire video has been sharpened.
    output:
      url: Examples/ltx_006.mp4

LTX Ripple

Edit one frame. Ripple the change through the whole video.

LTX Ripple is a First Frame All Frames (FFAF) IC-LoRA for LTX-2.5. It allows you to make LTX as powerful as your favorite image editor, with smart first frame propagation that understands the edit contextually.

Prompt: Example of replacing an object, adding special effects, and changing the lighting all at the same time. The scene reacts to both new light sources.

Prompt: Example of changing the lighting and background of the first frame, and the rest of the video is figured out without prompting, even when the camera swivels around.

Prompt: Editing the first frame to be on fire, the effect stays consistent throughout multiple camera cuts.

Prompt: Example of Ripple understanding that the liquid has been added in the first frame, and the liquid inside the glass flows in accordance with the original video's movement.

Prompt: Example of archviz/3d clay model texturing with only the untextured video and a textured first frame input. Texturing effect ripples through scene cuts.

Prompt: Here an interesting effect can be seen: because the edited first frame was sharper (notice the dragon details), the entire video has been sharpened.

How it works

Input your video.
Edit or replace its first frame.
LTX Ripple will figure out the rest of the video based on your image edit.

You may also give a brief description of what you changed to help it along, but the LoRA can work without even prompting anything.

Useful applications include:

Adding Special Effects
3D model re/texturing
Style Change
Light source / time of day change
Character Attribute Change
Background Change
Weather Change
Archviz Retexturing
Title/Logo Replacement
Object Addition / Removal / Replacement
Sharpening / Blurring

Recommended strength setting: 1.35

Increase the LoRA strength when the edit is not being carried through strongly enough. Decrease it when the output changes content that should remain unchanged.

Prompting

The default prompt used by the workflow is:

Use the reference video for motion, timing, camera movement, composition, and unchanged scene content, while consistently propagating the visual edit established in the first frame throughout the video.

For difficult edits, add a short description of the changed first frame. For example, describe the new lighting, object, material, style, or background that should remain consistent across the video.

Limitations and tips

The first frame is the key control signal, so make the edit clear and coherent before running the video.
Stronger edits may need a higher LoRA strength and a more explicit prompt.
Very large changes, heavy occlusion, fast motion, or content absent from the source video may reduce consistency.
Results depend on the LTX-2.5 checkpoint, resolution, frame count, sampler settings, and available hardware.

Credits

LTX Ripple was created by WepeNerd. It is designed for use with LTX-2.5 by Lightricks and the ComfyUI-LTXVideo ecosystem.

Please review and comply with the licenses and usage terms of LTX-2.5, its model components, ComfyUI, and the custom nodes listed above.

License

LTX Ripple is an LTX-2.x derivative and is distributed under the LTX-2.x Community License Agreement. The license governs use, modification, and redistribution of this LoRA when used with LTX-2.x. Please also review the LTX Acceptable Use Policy.