67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
|
# 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.
|