README.md

---
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](https://huggingface.co/Lightricks/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.

<Gallery />

## How it works

1. Input your video.
2. Edit or replace its first frame.
3. 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](https://huggingface.co/WepeNerd). It is designed for use with [LTX-2.5 by Lightricks](https://huggingface.co/Lightricks/LTX-2.5) and the [ComfyUI-LTXVideo](https://github.com/Lightricks/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](./LICENSE-2_x). The license governs use, modification, and redistribution of this LoRA when used with LTX-2.x. Please also review the [LTX Acceptable Use Policy](https://static.lightricks.com/legal/ltx-acceptable-use-policy.pdf).