Skip to content

Conversation

@drphero
Copy link

@drphero drphero commented Jan 31, 2026

ltxvideo

Unify and organize node categories under Lightricks/LTXV

Summary

This pull request refactors the node category structure to provide a unified, consistent, and functionally-grouped hierarchy for all nodes in the ComfyUI-LTXVideo custom node set.

Motivation

The existing node categories were fragmented and inconsistent, using various prefixes and top-level names such as lightricks/LTXV, ltxtricks, latent, fluxtapoz, and sampling. This inconsistency made it difficult for users to locate specific nodes within the ComfyUI right-click menu.

This change aims to significantly improve the user experience by consolidating all nodes under a clear Lightricks/LTXV root, with logical sub-categories based on their function.

Changes

All nodes have been moved to a new, standardized hierarchy under the Lightricks/LTXV root. The new structure groups nodes by their primary function:

New Category Description Example Nodes
Lightricks/LTXV/Loaders Model, checkpoint, LoRA, and conditioning loaders. LTXVGemmaCLIPModelLoader, LTXICLoRALoaderModelOnly
Lightricks/LTXV/Sampling Samplers and core sampling logic nodes. LTXVBaseSampler, LTXVTiledSampler, LTXFlowEditSamplerNode
Lightricks/LTXV/Conditioning Prompt encoding, enhancement, and conditioning nodes. LTXVGemmaEnhancePrompt, DynamicConditioning, GemmaAPITextEncode
Lightricks/LTXV/Latent Latent manipulation, VAE decoding, and normalization. LTXVTiledVAEDecode, LTXVAdainLatent, DecoderNoise
Lightricks/LTXV/Masking Mask creation and processing nodes. LTXVPreprocessMasks, LTXVSetAudioVideoMaskByTime
Lightricks/LTXV/Model Patches Nodes that modify the core model (e.g., Q8, VAE patchers, attention overrides). LTXVApplySTG, LTXVPatcherVAE, ModifyLTXModelNode
Lightricks/LTXV/Guidance Guiders, advanced guide controls (STG, FlowEdit CFG), and guide application. STGGuiderNode, MultimodalGuiderNode, LTXAddVideoICLoRAGuide
Lightricks/LTXV/Prediction Model sampling prediction nodes. LTXForwardModelSamplingPredNode, LTXReverseModelSamplingPredNode
Lightricks/LTXV/Utility General utility and helper nodes. ImageToCPU, LinearOverlapLatentTransition

Technical Notes

  • Consolidated internal/experimental categories (ltxtricks, fluxtapoz) into the new functional groups.
  • The change was applied to both the standard CATEGORY class attribute and the category field within define_schema methods (e.g., in iclora.py) to ensure full coverage.
  • A total of 68 node categories were modified.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant