# 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.