ComfyUI-CutomNodes/README.md

ComfyUI Custom Nodes

A collection of custom nodes for ComfyUI, focusing on audio manipulation and processing.

Nodes

Audio Repeat (with Crossfade)

Repeats an audio clip multiple times with optional crossfading between repetitions.

Features:

• Repeat audio clips any number of times (1-500)
• Configurable crossfade duration between repetitions
• MP3 and WAV output support
• Adjustable MP3 quality settings
• Direct file output to specified path

Inputs:

• audio (AUDIO): Input audio to repeat
• repeat_count (INT): Number of times to repeat (default: 20, range: 1-500)
• output_audio_path (STRING): Path where the output file will be saved
• overwrite (BOOLEAN, optional): Whether to overwrite existing files (default: True)
• mp3_quality (INT, optional): MP3 encoding quality (default: 0, range: 0-9, lower is better)
• crossfade_seconds (FLOAT, optional): Duration of crossfade between repetitions (default: 0.15s, range: 0.0-5.0s)

Outputs:

• audio_out (AUDIO): The repeated audio as a ComfyUI AUDIO object
• output_audio_path (STRING): Path to the saved output file

Requirements

• ComfyUI
• FFmpeg (must be available in PATH)
• NumPy

Installation

1. Clone or download this repository to your ComfyUI custom_nodes folder:

   cd ComfyUI/custom_nodes
   git clone <repository-url> ComfyUI-CustomNodes
   

2. Restart ComfyUI

3. The nodes will appear in the "audio" category

Usage

The Audio Repeat node is useful for:

• Creating looping audio backgrounds
• Extending short audio clips
• Creating seamless audio loops with crossfades
• Batch processing audio files

Technical Details

• Supports multiple audio input formats through FFmpeg
• Internally normalizes audio to consistent channel/frame format
• Uses FFmpeg's acrossfade filter for smooth transitions
• Handles mono and multichannel audio
• Outputs at 44.1kHz sample rate by default

License

This project is provided as-is for use with ComfyUI.