ComfyUI_AIMZ

ComfyUI_AIMZ

ComfyUI_AIMZ is a versatile suite of essential workflow helpers, quality-of-life improvements, and utility custom nodes for ComfyUI, crafted by AIMZ / CEC Tools.

---

🛠️ Nodes Included

1. AIMZ Audio Silence Pad

Pads an audio sequence with exact silence at the start and end based on video frame counts.

• Replaces 8~10 Nodes: Replaces Int x2, Math Expression x2, Empty Audio x2, and Concatenate Audio x2 into a single, clean node.
• Precision Sync: Automatically computes exact silence durations (pad_frames / fps) matching sample rates (44.1kHz / 48kHz) and channel configurations without any drift.
• Dynamic FPS Override: Automatically reads connected source_fps (e.g. from Get_FPS) with safe fallback to default_fps (24fps).
• None-Safe: If audio is None, passes through None and 0.0 duration cleanly without errors.

2. AIMZ Video Duration Selector

Smart duration and total frame calculator for V2V and R2V pipelines.

• V2V / R2V Mode Switch: One-click toggle between Source Video (V2V) (uses connected source duration) and Custom Seconds (R2V) (uses custom seconds slider).
• MiniMax Frame Alignment: Built-in automatic calculation of MiniMax H3's exact frame padding rule (max(5, round(sec * fps)) + (5 - (max(...) % 17)) % 17), eliminating 4~5 messy math nodes.
• Dynamic FPS Override: Automatically reads connected source_fps (e.g. from Get_FPS) with safe fallback to default_fps (24fps).
• Outputs: total_frames (INT), final_seconds (FLOAT), effective_fps (FLOAT), and raw_frames (INT).

3. AIMZ Selective Group Bypasser

Selectively manages and toggles bypass states for user-chosen groups only.

• Curated Group Control: Instead of cluttering your screen with every single group in the workflow, select specific groups from a dropdown list to manage.
• Sleek 1-Line Modern LED UI: Ultra-compact, left-aligned layout with modern neon LED status dots (● ACTIVE / ○ BYPASS) and inline ghost delete buttons (✕).
• Auto Resizing: Automatically adjusts height based on managed groups.
• State Preservation: Keeps your curated group list and bypass states intact across workflow saves and loads.

4. AIMZ Freeze Frame Pad

Pads video frame sequences with repeated freeze frames at the beginning and/or end (e.g. 15 frames for MiniMax-H3 motion buffer).

• Replaces 5 Nodes: Replaces GetImageFromBatch (start), RepeatImages (start), GetImageFromBatch (end), RepeatImages (end), and ImageBatchMulti into a single, clean node.
• None-Safe: If video is None, passes through None and count=0 cleanly without errors.

5. AIMZ Auto Multiple Pad

Automatically pads images, masks, or video frame batches to be divisible by any chosen multiple (default: 32) with zero quality loss.

• None-Safe Pass-through: If input image/video or mask is None (empty branch/slot), it passes through None and 0 without raising exceptions, enabling seamless dynamic conditional branching.
• Dimensions & Frame Count: Also outputs width, height, and count (frame count), replacing GetImageSizeAndCount with full None-safety!
• Default Settings: Default pad mode is constant with white background.
• Flexible Pad Modes: Supports constant, reflect, replicate, and circular.
• Color Customization: Supports named colors (white, black, gray), hex (#ffffff), and normalized RGB tuples (1,1,1, 0,0,0).
• Mask Synchronization: Accurately pads associated masks with identical offsets.

6. AIMZ Auto Multiple Unpad

Restores padded images or masks back to their original input dimensions using pad_info or manual coordinate offsets.

7. AIMZ Preview Image (None Safe)

A bulletproof replacement for ComfyUI's standard PreviewImage node.

• None-Safe: If the input image is None or an empty branch, it skips cleanly without throwing TypeError: NoneType errors.
• Pass-Through Output: Also outputs the image so you can chain it cleanly in your workflows.

---

📦 Installation

Method 1: ComfyUI Manager (Recommended)

1. Open ComfyUI Manager -> Custom Nodes Manager.
2. Search for comfyui_aimz or AIMZ.
3. Click Install and restart ComfyUI.

Method 2: Install via Git URL

1. In ComfyUI Manager, select Install via Git URL.
2. Enter: https://github.com/AIMZ-GFX/ComfyUI_AIMZ
3. Restart ComfyUI.

Method 3: Manual Clone

cd ComfyUI/custom_nodes
git clone https://github.com/AIMZ-GFX/ComfyUI_AIMZ.git

---

📄 License

MIT License