wan_vace_auto_joiner

WAN VACE Auto Joiner v2.0.0 (ComfyUI Custom Nodes)

Seamlessly join multiple video clips in a folder using WAN VACE and ComfyUI Easy-Use For Loop automation — with one-click solution.

This node set ensures:

• VACE runs exactly N-1 times for N input videos
• Seamless transitions with automatic color/brightness correction
• Audio preservation from original clips
• Finalization runs once, after the loop completes

Nodes appear under: WAN VACE / Auto Joiner

---

🆕 What's New in v2.0.0

Seamless Transitions

VACE can introduce brightness/color shifts at transition boundaries. v2.0.0 automatically corrects this with:

• Temporal Color Smoothing — Gaussian + linear interpolation across transition regions
• Per-Channel Correction — Independent R, G, B adjustment for accurate color matching
• Dynamic Calculation — All correction values computed from your actual source frames (no hardcoded values)

Audio Support

• Automatic Audio Transfer — Extracts and concatenates audio from all source clips
• Direct Video Combine Integration — Standard ComfyUI AUDIO output connects directly to VHS Video Combine
• Fail-Safe Handling — Generates silent audio track when source clips have no audio (prevents workflow errors)

---

Key Features

Feature	Description
✅ One-click batch joining	Process unlimited video clips automatically
✅ Seamless transitions	No visible brightness/color jumps between clips
✅ Audio preservation	Original audio transferred to final output
✅ Loop barrier system	Prevents early exit & race conditions
✅ Clean lifecycle	INIT → PROCESS → FINALIZE
✅ Security	Input sanitization prevents path traversal

---

Requirements

Requirement	Notes
ComfyUI	Base requirement
ComfyUI-Easy-Use	Required for For Loop nodes
WAN VACE workflow	Your existing VACE setup
ffmpeg	Required for audio features (optional)
scipy	Recommended for best smoothing (optional, has numpy fallback)

---

Installation

Option 1 — ComfyUI-Manager (Recommended)

1. Open ComfyUI → Manager
2. Go to Install Custom Nodes
3. Search for Wan Vace Auto Joiner
4. Install and restart ComfyUI

Option 2 — Manual Install

cd ComfyUI/custom_nodes
git clone https://github.com/Rhovanx/wan_vace_auto_joiner.git

Restart ComfyUI.

Optional Dependencies

# For best color smoothing results
pip install scipy

# For audio features (check if already installed)
ffmpeg -version

---

The Three Nodes

Node	Display Name	Location	Purpose
WanVaceAutoJoiner	WAN VACE Auto Joiner	Inside loop	INIT (first iteration) / PROCESS (subsequent)
WanVaceAutoJoinerSave	WAN VACE Auto Joiner – Save	Inside loop	Saves VACE output, acts as loop barrier
WanVaceAutoJoinerFinalize	WAN VACE Auto Joiner – Finalize	After loop	Applies smoothing, outputs frames + audio

---

Finalize Node Options (v2.0.0)

Option	Default	Description
smooth_transitions	✅ True	Enable temporal color smoothing
smooth_window	12	Gaussian sigma (1-30, higher = smoother)
blend_region	25	Context frames before/after VACE (10-50)
transfer_audio	✅ True	Extract audio from source clips
cleanup	❌ False	Delete temp folder after completion

---

Output Connections

WAN VACE Auto Joiner - Finalize
├── batch_images ────→ Video Combine (images)
├── audio ───────────→ Video Combine (audio)
├── frame_rate ──────→ Video Combine (frame_rate)
├── status ──────────→ (optional debug output)
└── is_complete ─────→ (optional boolean flag)

---

Workflow Setup

1️⃣ Prepare Input Directory

Clips must follow this naming format:

clip_00001.mp4
clip_00002.mp4
clip_00003.mp4
...

The prefix (`