Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ainvfx-paintaplate

ComfyUI Extension: ainvfx-paintaplate

Repo Name

ainvfx-paintaplate

Author
AInVFX (Account age: 580 days)
Nodes
View all nodes(12)
Latest Updated
2026-11-05
Github Stars
0.03K

How to Install ainvfx-paintaplate

Install this extension via the ComfyUI Manager by searching for ainvfx-paintaplate
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ainvfx-paintaplate in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

ainvfx-paintaplate Description

ainvfx-paintaplate edits short video shots by painting on the first frame, carrying object removal, additions, or lighting changes through the clip while preserving untouched source regions.

ainvfx-paintaplate Introduction

AInVFX Paint a plate

ainvfx-paintaplate is a ComfyUI extension for editing short video shots by painting on their first frame. You can remove an unwanted object, add something new, or change the lighting, then carry that change through the shot.

A plate is the original footage or image sequence you want to work on. Instead of rebuilding the entire plate, Paint a plate combines AI-generated changes with your source material. In its normal, source-format export, untouched pixels remain identical to the plate.

[Watch the Paint a plate demonstration](https://youtu.be/Kt9O3Aw46-g)

Watch the two-minute demonstration on YouTube

What you can do

  • Remove distractions: Paint over an unwanted object and let the extension generate a replacement background.
  • Add new elements: Describe an addition and paint where you want it to appear.
  • Relight footage: Choose a light colour, indicate its direction, and describe a mood such as “warm sunset from the left.”
  • Create fluid effects: Start from a blank plate and turn simple painted shapes into smoke, steam, fire, explosions, dust, fog, or clouds.
  • Review at the plate’s quality: Compare the result against the original using colour-managed viewing, including full-precision EXR comparison.
  • Keep delivery details intact: Normal exports use the plate’s file type, bit depth, frame numbers, colour tags, timecode, audio, and EXR layers.
  • Continue in ComfyUI: Export your scene as an organised ComfyUI workflow if you want to inspect or change the underlying process. The extension provides its own painting and review page, so you do not need to build a node graph for every edit. Behind that interface, each stage runs as a ComfyUI workflow using open-weight models.

How ainvfx-paintaplate Works

Think of the process as making an illustrated instruction on one frame, then asking several specialised tools to apply that instruction throughout the shot.

1. Open and interpret the plate

The extension reads your footage, identifies its format and colour space, and prepares the first frame and a playback movie.

The original plate remains the reference for the final composite—the combination of the source footage and your changes.

2. Describe and paint your change

Your words explain what should happen, while your strokes indicate where it should happen.

For example:

  • To remove an umbrella, choose Erase, paint over it, and name it “red umbrella” when using Whole object.
  • To add fire, choose Paint, mark an open area, and describe the fire.
  • To change the lighting, choose Light, select a colour, and paint where the light comes from. A prompt-writing model uses the frame, your words, and the painted area to produce a more detailed instruction for the image-editing model. You can begin with a short description rather than writing a long technical prompt.

3. Create the edited first frame

FLUX 3 Image Klein edits the first frame. This gives you an early view of the intended change before the complete shot is ready.

The first-frame editing workflow makes a quick pass at 768, followed by a full-size pass.

4. Follow the change through time

Different models handle different jobs:

  • SAM 3.1 identifies objects and follows edited regions through the shot.
  • LTX 2.5 with the in-outpainting IC-LoRA regenerates the regions where objects were erased.
  • LTX 2.5 with Ripple IC-LoRA carries painted additions and lighting changes through the shot. A matte is a mask identifying an edited region. You can think of it as a moving stencil that helps keep the change associated with the correct area.

5. Preview, refine, and composite

The shot renders automatically after the first-frame edit:

  1. A quick preview runs first—Fast, 640 by default.
  2. A full-size pass follows.
  3. The extension creates a full-size composite at the plate’s quality. During LTX generation, a live preview shows how the shot is developing. Once the full-size composite is ready, the viewer plays that result.

6. Export when you are ready

Rendering does not automatically trigger the final export. Press Export to save the result and its matte.

For normal source-format delivery, the extension preserves the plate’s format and associated details. An intentional SDR-to-HDR conversion is an exception: it produces an EXR sequence instead.

Completed jobs are indexed on disk. Repeating the same edit on the same plate can reuse the existing result, including in a later session.

ainvfx-paintaplate Everyday Workflow

Open your source

Open plate provides four source tabs:

| Source | What it is for | | --- | --- | | ComfyUI files | Browse ComfyUI’s input and output folders, including subfolders, for videos, animated images, and image sequences. | | Upload | Send footage or image files from your computer. | | Scenes | Reopen a scene previously saved on the current ComfyUI instance. | | Blank plate | Start a new fluid-effects shot without existing footage. |

Image sequences appear as grouped frame patterns, such as shot.####.exr or ComfyUI_#####_.png, rather than as unrelated individual images.

Click a plate once to inspect its size, frame count, format, and colour space. Double-click to open it.

Make an edit

  1. Type a short description.
  2. Select Paint, Erase, or Light.
  3. Paint on the first frame.
  4. Press Generate or Enter.
  5. Review the preview and the final composite.
  6. Adjust the edit in History if needed.
  7. Press Export when you are satisfied.

Revise an existing edit

Select an edit in History to bring back its words and painted instructions. You can then:

  • Add more strokes.
  • Rub out strokes.
  • Rewrite its description.
  • Use undo and redo at the top of History. Later edits that depend on the changed edit are updated accordingly.

Save scene keeps the plate, its colour space, and every edit on the current ComfyUI instance.

ainvfx-paintaplate Features

Paint: add new content

Paint adds the content you describe where you paint.

The generated change can extend slightly around your strokes. This allows an addition to interact with its surroundings—for example, fire can illuminate nearby surfaces rather than looking like an isolated cutout.

Example: Paint an area of open ground and describe “small orange flames with drifting smoke.”

For more reliable results, place additions in open space. An addition painted across a foreground object can break up during the shot.

Erase: remove objects

Erase removes the object beneath your stroke and regenerates the area it occupied.

Enable Whole object when you want SAM 3.1 to identify the complete object rather than relying only on the painted region. Naming the object helps, especially for thin or ambiguous subjects.

Example: “Floodlight pole” can identify a thin pole more effectively than “floodlight.”

When Whole object is enabled, your stroke can cross the background: the object identification uses both the stroke and its name.

Important: A cast shadow outside the identified object remains. Remove it with another erase stroke and turn Whole object off for that stroke.

Light: change illumination

Light relights the shot.

  1. Choose a light colour from the swatches.
  2. Paint where the light comes from.
  3. Optionally describe the intended lighting. Useful descriptions include:
  • “Night time”
  • “Warm sunset from the left” Relighting uses the plate’s original values under a smooth lighting ratio. This helps retain existing HDR values instead of replacing them with ordinary SDR content.

Object tracking and moving mattes

SAM 3.1 follows edits through the shot. The Follow Matte processing keeps generated content inside its tracked matte.

This is important because an object or camera may move after the first frame. The edit needs to follow that movement rather than remain fixed at the original screen position.

Render inspection and comparison

The Render panel lists the stages of a render, including the first-frame edit, preview passes, full-size passes, HDR conversion, and composites.

  • Click a finished step: View that pass across the shot.
  • Click it again or press Esc: Return to the latest result.
  • Ctrl+click, or Cmd+click on Mac: Place a pass on the left side of the comparison wipe.
  • F6: Use the wipe comparison.
  • W: Toggle the X-ray view, which tints areas where the displayed edits change the plate. This lets you identify whether a problem began in the first-frame edit, tracking, video generation, or compositing.

For EXR plates, the final wipe compares the result’s EXR frames against the plate’s own EXR frames at full precision—not merely two compressed preview movies.

Colour-managed viewing

The viewer follows OpenRV-style colour controls and uses OpenColorIO, often shortened to OCIO, to interpret and display image colours consistently.

Right-click the frame and open OCIO:

| Control | Purpose | | --- | --- | | File Color Space | Sets how the plate’s colour values are interpreted. The viewer updates immediately, and edits are regenerated in that space. | | Look | Changes the viewing look. | | Displays | Selects the display treatment used by the viewer. | | Change Config | Selects the OCIO configuration. |

The plate’s colour space is read from the file when it opens. The default OCIO configuration comes from the $OCIO setting, if present; otherwise, the extension uses OCIO’s built-in ACES studio configuration.

Viewing controls include exposure, contrast, gamma, saturation, hue, and individual channels. They help you inspect your result under different viewing conditions.

Fluid shots from painted keyframes

A fluid shot starts from Blank plate, not existing footage.

  1. Open a blank plate.
  2. Paint simple, flat-colour shapes on frame 0.
  3. Paint the last frame to indicate the later arrangement.
  4. Describe the fluid effect.
  5. Press Generate. Examples of useful painted guides include:
  • Light grey for smoke.
  • White for steam.
  • Orange and yellow for fire.
  • Flat areas indicating sky and ground. ainvfx-fluid turns these guides into a moving shot. The generated shot then becomes the plate for subsequent edits.

With no source plate open, the page starts with a blank plate by default. Its initial settings are 960 × 512, 121 frames, and 25 fps. When SDR-to-HDR support is present, the default uses the 16-bit setting for half-float EXR output.

Add ?blank=0 to the page address to start without automatically opening a blank plate.

HDR generation and delivery

SDR holds a more limited brightness range. HDR can retain values above ordinary white, giving you more room to adjust highlights during colour grading.

The optional SDR-to-HDR models extend newly generated content into scene-linear HDR values. HDR Match then aligns that content with the plate’s exposure using measurements from untouched midtones, separately for each colour channel.

There are two main cases:

| Plate type | Behaviour | | --- | --- | | A plate whose format or colour encoding supports values above 1.0 | New content automatically receives SDR-to-HDR processing before the full-size composite, when the models are available. Export stays in the plate’s format. | | An SDR plate or integer sequence without that extended range | You can deliberately convert it through the Deliver panel. The bit-depth pass asks first, then produces half-float EXR in ACES2065-1. | Extended-range sources include float EXR, float TIFF or DPX, PQ or HLG HDR video, log video, 10-bit Cineon DPX, and camera-log TIFF.

Additional details:

  • SDR-to-HDR processing is active whenever its model files are available.
  • Add ?hdr=0 to the page address to disable it.
  • Without those models, other editing features still work; an EXR render finishes with the SDR-generated shot.
  • A render containing a light edit omits this conversion because relighting retains the plate’s existing values through a lighting ratio.
  • For a blank plate, choosing 16-bit half float routes the fluid shot through SDR-to-HDR processing before reopening it as an EXR plate. Generated shot frames follow the plate’s bit-depth path: 8-bit PNG for an 8-bit plate, 16-bit PNG for a 10-, 12-, or 16-bit plate, and half-float EXR for floating-point plates.

For image sequences, the 8-bit playback, review, and SDR-to-HDR movies use ACEScct log values for colour-managed viewing. The full-precision frames remain the reference for final inspection.

Export and workflow handoff

Export writes the final result and its matte, then downloads them together in a ZIP file. You can also include the review movie or regenerated shot by selecting them in the dialog.

The same dialog offers ComfyUI graph, which saves the whole scene as a ComfyUI workflow. Its numbered sections follow the processing order and include explanatory README notes describing each section’s inputs and outputs.

A fluid shot without further edits exports the shot itself, including:

  • Half-float EXR frames if it received SDR-to-HDR processing.
  • A ProRes 4444 version.
  • Its preview movie.

Responsive controls and saved layout

  • Stop beside Generate, or Esc, stops generation while keeping finished work.
  • Enter resumes from where processing stopped.
  • Cancel or Esc stops a plate that is opening.
  • The × beside the plate name closes the plate, stops its renders, and releases its frames from browser memory.
  • Drag the divider beside History or the top edge of the log to resize those panels.
  • Double-click a divider to restore its original size.
  • Panel sizes are remembered for your next session. Models load while you look at the page, reducing the wait before the first edit. On cards with at least 60 GB of VRAM, the startup workflow also warms LTX 2.5. ## ainvfx-paintaplate Models The extension uses a coordinated set of models rather than one model for every task. Most are supporting parts of the workflow, not alternative artistic presets.

An IC-LoRA is a specialised add-on that guides the main video model toward a particular job, such as removing objects or generating fluid motion.

Main creative models

| Model | What it does | When it matters | | --- | --- | --- | | FLUX 3 Image Klein | Edits the first frame from your strokes and description. | Establishes the appearance of additions, removals, and lighting changes. | | Qwen 3.5 9B prompt upsampler, supplied with Klein | Expands your short instruction using the frame and painted region. | Helps turn a few words into the kind of detailed caption Klein expects. | | LTX 2.5 | Generates the edited shot over time. | Provides the main video-generation backbone. | | Lightricks in-outpainting IC-LoRA | Regenerates erased regions. | Used for object removal and background reconstruction. | | WepeNerd Ripple IC-LoRA | Carries painted edits and lighting through the shot. | Used for additions and relighting. | | SAM 3.1 | Identifies objects and follows edited regions. | Supports Whole object selection and moving mattes. | | ainvfx-fluid | Turns flat painted keyframes into fluid effects. | Optional; used for blank-plate smoke, steam, fire, explosions, dust, fog, and clouds. | | LTX 2.5 SDR-to-HDR IC-LoRA | Extends generated content into HDR values. | Optional; used for HDR integration and deliberate HDR delivery. |

For example, adding fire to existing footage uses the first-frame editor and the shot-propagation workflow. Creating an entirely new fire shot from two painted guides uses ainvfx-fluid.

Supporting model files

These files handle text understanding, image/video encoding, and previews:

| Component | File | Approximate size | | --- | --- | --- | | Klein image model | flux3-image-klein-int8-convrot.safetensors | 5.8 GB | | Klein text encoder | qwen3vl_4b_int8_convrot.safetensors | 4.9 GB | | Klein prompt upsampler | qwen3.5_9b_flux3_prompt_upsampler_w4a8.safetensors | 6.7 GB | | FLUX image encoder/decoder | flux2-vae.safetensors | 0.3 GB | | LTX video model | ltx-2.5-22b-distilled-transformer-comfy-int8-convrot.safetensors | 21.5 GB | | LTX text encoder | gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot.safetensors | 15.4 GB | | LTX video encoder/decoder | ltx-2.5-video-vae-conv-bf16.safetensors | 1.5 GB | | LTX audio encoder/decoder | ltx-2.5-audio-vae-bf16.safetensors | 0.4 GB | | In-outpainting add-on | ltx-2.3-22b-ic-lora-in-outpainting-0.9.safetensors | 1.3 GB | | Ripple add-on | LTX25_Ripple_v11.safetensors | 0.7 GB | | SAM object model | sam3.1_multiplex_fp16.safetensors | 1.7 GB | | Tiny preview decoder | taeltx2_3.safetensors | 0.02 GB | | Optional fluid add-on | ainvfx-fluid.safetensors | 0.65 GB | | Optional SDR-to-HDR add-on | ltx-2.5-22b-ic-lora-sdr-to-hdr-1.0.safetensors | 1.31 GB | | Optional HDR scene embeddings | ltx-2.5-22b-ic-lora-sdr-to-hdr-scene-emb.safetensors | 12.6 MB |

A VAE, or encoder/decoder, translates between ordinary images or video and the compact representation used by the AI model.

The tiny preview decoder comes from TAEHV, with the listed file available through Kijai’s LTX2.3 collection. It makes intermediate previews faster and less memory-intensive, but does not match a full-size decoder’s quality. Judge fine detail on the completed composite, not the live sampling preview.

Scope note: ComfyUI-LTXVideo also documents dubbing, text-to-audio, depth/edge control, and creative upscaling workflows. Those are capabilities of the broader dependency, not documented Paint a plate interface features.

ainvfx-paintaplate Performance and Limits

Hardware expectations

The author recommends and has tested NVIDIA GPUs with at least 32 GB of VRAM. VRAM is the GPU’s working memory; these models require substantially more than a typical image-editing application.

The core model downloads total approximately 60 GB, separate from storage needed for plates, generated frames, and cached jobs.

| Workload | Guidance from the author | | --- | --- | | Up to 1920 × 1088 and 121 frames | Every step completed on a tested 32 GB card, though more slowly than on a 96 GB card. | | Plates above 2K | A 96 GB card is currently needed for practical operation, according to the author. | | Above-2K plate on a card below 48 GB | The page displays a warning. | | Smaller GPU or Mac | The author recommends running the workload remotely on Runpod. |

The source documentation reports these examples from testing:

  • RTX 5090: An erase render took 657 seconds and a paint render took 832 seconds at the tested 1920 × 1088, 121-frame workload.
  • RTX PRO 6000: A 3840 × 2160 MP4 of 121 frames took 341 seconds to erase and 367 seconds to paint.
  • The same 4K plate’s first erase was still running after 30 minutes on the RTX 5090. These are examples, not guaranteed render times. On a 32 GB card, ComfyUI streams the portions of LTX 2.5 that do not fit in GPU memory, slowing the process.

Creative and workflow limits

  • Standard edits are painted on the first frame.
  • Shots are limited to 121 frames.
  • The documented edit limit is 1920 pixels on the long side. Larger source plates can be reviewed and composited at their own quality; this does not mean every AI-editing stage runs natively at the plate’s resolution.
  • Shadows outside an erased object require a separate erase stroke.
  • Very thin objects often need a precise name for Whole object selection.
  • Erasing a head tends to regenerate a head. To replace one, paint the new head over the old one.
  • Additions crossing foreground objects can break up during motion.
  • The colour picker can sample anywhere on screen in Chrome and Edge. In Firefox and Safari, it samples only within the frame.

Troubleshooting ainvfx-paintaplate

Part of an erased object remains

  1. Select the erase edit in History.
  2. Enable Whole object.
  3. Give the object a specific name.
  4. Refine the stroke and regenerate. For narrow subjects, use a precise phrase such as “floodlight pole” rather than “floodlight.”

The object disappeared, but its shadow remains

This is a documented limitation: the shadow may lie outside the object’s matte.

  1. Create a second erase stroke over the shadow.
  2. Turn Whole object off.
  3. Generate again.

An erased object returns during the shot

The author notes that an erased object can return if its name reaches the shot-generation prompt. The interface avoids naming erased objects in that prompt.

If you are working with an exported or modified ComfyUI graph:

  1. Inspect the shot-generation prompt.
  2. Check whether it names the object you removed.
  3. Remove that reference before running the shot again.

An addition breaks up behind or across another object

  1. Inspect where the addition was painted on the first frame.
  2. Check whether it crosses a foreground object.
  3. Revise the edit so the addition occupies open space.
  4. Regenerate and review the complete shot.

Erasing a head produces another head

Use Paint to create the replacement over the existing head instead of erasing it first. The documented erase behaviour tends to reconstruct a head in that region.

The live preview looks blurry or unfinished

  1. Wait for the full-size render to complete.
  2. Select the latest full-size composite.
  3. Inspect the completed frames before judging detail. Live sampling uses a lightweight preview decoder. Its speed comes with lower image quality than the final decoding path.

The render is taking a long time

  1. Check your GPU’s VRAM.
  2. Check the plate’s resolution and frame count.
  3. Compare the workload with the tested limits above.
  4. For plates above 2K, use the author’s recommended 96 GB GPU class.
  5. If you need to stop, press Stop or Esc. Finished work is retained; Enter continues. A fast first-frame edit does not imply a fast full-shot render. They use different models and have different memory demands.

The image has unexpected colours

  1. Right-click the frame and open OCIO.
  2. Check File Color Space against the source plate.
  3. Check Look, Displays, and the selected OCIO configuration.
  4. Press Shift+Home to reset viewing colour adjustments.
  5. For EXR footage, use the completed full-precision comparison rather than judging only a playback movie. Changing File Color Space also causes the edits to be made again in the newly selected space.

New content lacks the HDR range you expected

  1. Confirm that the optional SDR-to-HDR models are available.
  2. Check that the page address does not contain ?hdr=0.
  3. Determine whether the source is already an extended-range plate or an SDR plate.
  4. For SDR sources, use the intentional conversion in Deliver.
  5. Review the result using the full-precision viewer and appropriate colour settings. A light-edit render omits the SDR-to-HDR stage by design.

You are unsure which render stage caused a fault

  1. Open Render.
  2. Click the first-frame result.
  3. Inspect later passes in order.
  4. Ctrl+click a pass—or Cmd+click on Mac—to place it on the comparison wipe.
  5. Use F6 for comparison and W to highlight changed areas.
  6. Press Esc to return to the latest result.

Frequently asked questions

Do I need to paint every frame? No. Normal edits begin on the first frame, then the models track and propagate them. Fluid shots use painted first and last keyframes.

Does generation immediately save the final export? No. Press Export when you are ready to write the deliverable and download it.

Will every pixel be regenerated? The final composite is designed to preserve untouched source pixels. Paint can affect a small surrounding area to integrate an addition, and deliberate HDR conversion changes the delivery path.

Can I reopen my work later? Yes. Save scene stores the plate, colour space, and edits on the current ComfyUI instance. Open it again through Scenes.

Can I use the scene in the regular ComfyUI graph interface? Yes. Choose ComfyUI graph in the Export dialog.

Where are the keyboard shortcuts? Press ?. The right-click menu also lists actions and their keys.

Why does Shift+Esc not stop generation? The extension does not use it. In Chrome on Windows and Linux, that shortcut opens the browser’s Task Manager. Use Esc or Stop instead.

Does closing a plate release browser memory? Yes. Use the × beside the plate name to close it, stop its renders, and release its frames.

ainvfx-paintaplate Keyboard Reference

| Key | Action | | --- | --- | | Enter | Generate or continue stopped processing | | Esc | Cancel or stop, depending on the current interaction; also return from a selected render pass | | F6 | Comparison wipe | | W | X-ray view of changed regions | | I | Colour picker | | Shift+E | Exposure | | K | Contrast | | Y | Gamma | | Shift+S | Saturation | | H | Hue | | Shift+Home | Reset all viewing colour adjustments | | ? | Show keyboard help |

Playback and viewing controls follow OpenRV-style conventions. Use the in-page shortcut help for the complete list.

Learn More about ainvfx-paintaplate

Start with visual examples

Explore workflows and documentation

Learn about the underlying video tools

  • ComfyUI-LTXVideo — the supporting LTX custom-node collection and example workflows.
  • LTX open-source ComfyUI documentation (https://docs.ltx.video/open-source-model/integration-tools/comfy-ui) — further explanations of LTX workflows.
  • LTX community Discord — a community resource for the underlying LTX tools.
  • TAEHV documentation — explains the fast preview decoder and its quality-versus-speed trade-off.

Explore fluid generation

ainvfx-paintaplate Licences and Usage

The extension’s code is licensed under Apache 2.0. Its models retain their own licences, so review the relevant model cards before using them in your projects.

Key points from the author’s documentation:

  • LTX 2.5 and its IC-LoRAs, including Ripple, in-outpainting, and ainvfx-fluid, use the LTX-2.x Community License. The author notes a paid-licence requirement from USD 10 million in annual revenue; consult the current licence for its exact terms.
  • SAM 3.1 uses the SAM License.
  • The tiny decoder from madebyollin/taehv uses the MIT License.
  • Black Forest Labs’ prompt-upsampling system text included in web/upsampler.json uses Apache 2.0.
  • The synthetic Paint a plate test dataset uses CC BY 4.0. Open weights do not mean every model has the same permissions. Check the applicable licence before commercial delivery or redistribution.

ainvfx-paintaplate Related Nodes

RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

ainvfx-paintaplate detailed guide | ComfyUI