ComfyUI Node
Dotted Waveform Visualizer
Creates animated dotted waveform visualizations from audio input with customizable appearance, colors, and animation styles
Dotted Waveform Visualizer
- audio
- images
- audio
- fps_output
◄width1280►
◄height720►
◄size6►
◄spacing3►
◄dot_color#00FFFF►
◄background_color#000000►
◄animation_style▾►
◄max_height60►
◄fps10►
◄max_frames300►
◄opacity_modeuniform►
◄gradient_enabledfalse►
◄gradient_stops[]►
◄amplitude_boost1.0►
◄advanced_modefalse►
◄window_size2.0►
◄preview_modefalse►
Categoryaudio/visualization
Inputs (18)
| Name | Type | Default | Description |
|---|---|---|---|
| audio | AUDIO | Audio file to create waveform visualization from | |
| width | INT | 1280100–1920 | Output image width in pixels. Default 1280 (landscape HD). Max 1920 for Full HD. |
| height | INT | 720100–1920 | Output image height in pixels. Default 720 (landscape HD). Max 1920 for square/portrait. |
| size | INT | 61–30 | Size of individual dots/bars in pixels. Larger size = bolder appearance. Range: 1-30px. |
| spacing | INT | 31–40 | Distance between dot/bar centers. Smaller values = denser waveform. Range: 1-40px. |
| dot_color | STRING | #00FFFF | Hex color for waveform dots. Examples: #00FFFF (cyan), #FF0000 (red), #00FF00 (green), #FFFFFF (white) |
| background_color | STRING | #000000 | Hex color for background. Examples: #000000 (black), #FFFFFF (white), #333333 (dark gray) |
| animation_style | COMBO | Choose animation style. SCROLLING: Continuous waveform. BREATHING: Pulsing dots. RADIAL: Expanding rings. BARS: Frequency bars. WAVE: Sine wave patterns. SPECTRUM: FFT frequency analyzer. CIRCULAR: Rotating circle. | |
| max_height | INT | 605–150 | Maximum waveform size as % of image height. Higher = taller waveforms. Affects all animation styles including radial radius. |
| fps | INT | 101–60 | Animation speed in frames per second. Higher FPS = smoother but larger file size. Range: 1-60 FPS. |
| max_frames | INT | 3000–1000 | Frame limit to prevent hangs on long audio. 0 = unlimited. 300 frames ≈ 30 seconds at 10 FPS. |
| opacity_mode | COMBO | uniform | UNIFORM: All dots same brightness (fastest). 3_LEVELS: 0%/50%/100% opacity. 5_LEVELS: More variation. 10_LEVELS: Smoothest gradients (densest look). |
| gradient_enabledopt | BOOLEAN | false | — |
| gradient_stopsopt | STRING | [] | — |
| amplitude_boostopt | FLOAT | 1.00.5–5 | — |
| advanced_modeopt | BOOLEAN | false | — |
| window_sizeopt | FLOAT | 2.00.1–10 | SCROLLING ONLY: Time window in seconds. How much audio timeline visible at once. Smaller = more detailed, larger = more overview. |
| preview_modeopt | BOOLEAN | false | Toggle ON for fast preview with sine wave pattern (no audio processing). Toggle OFF for normal audio-based animation. |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| images | IMAGE | Generated waveform animation frames as image sequence |
| audio | AUDIO | Original audio data passed through unchanged |
| fps_output | FLOAT | Actual frames per second value used for the animation |