ComfyUI-Licon-MSR

July 13, 2026 · View on GitHub

Latest Bug Fix — New ComfyUI Compatibility

  • Fixed the Value not in list error for the frame_count property on newer ComfyUI frontends.
  • frame_count dropdown values are now serialized using ComfyUI's supported string-based COMBO format and converted back to integers before processing.
  • Existing workflows that store frame_count as an integer remain supported, while newer workflows that submit values such as "25" as strings now work correctly.

A ComfyUI custom node for creating fixed-frame MP4 reference videos from multiple subject images and a background image, designed for LTX 2.3 MSR (Multiple-Subject-Reference) LoRA workflows.

Latest Update

  • Updated frame allocation to align reference images with LTX's 8x temporal VAE compression boundaries.
  • Subject images (1-4) are resized proportionally and always kept complete; unused canvas space is filled with white.
  • The background image is resized proportionally to cover the full canvas and center-cropped when necessary.
  • Added 49, 57, and 65 frame options.

Node

  • Display name: Licon MSR
  • Category: Licon/MSR

Inputs

  • 1: optional image
  • 2: optional image
  • 3: optional image
  • 4: optional image
  • background: required image
  • width: output video width
  • height: output video height
  • frame_count: 17, 25, 33, 41, 49, 57, or 65

Behavior

Images are processed in this fixed order:

1 -> 2 -> 3 -> 4 -> background

Disconnected 1 to 4 inputs are skipped. background is always required and always placed last.

Subject images are proportionally fitted inside the configured dimensions without cropping and centered on a white canvas. The background proportionally covers the full canvas and is center-cropped if its aspect ratio differs. Frames are assigned in LTX-aligned temporal groups, and the node outputs an IMAGE frame sequence for downstream video processing.

Installation

Clone this repository into the ComfyUI custom_nodes directory:

cd ComfyUI/custom_nodes
git clone https://github.com/liconstudio/ComfyUI-Licon-MSR

Install requirements if needed:

pip install -r ComfyUI-Licon-MSR/requirements.txt

Restart ComfyUI after installation.