ComfyUI Dotted Waveform Visualizer 🎵

A ComfyUI node that generates animated dotted waveform visualizations from audio input with multiple animation styles including teardrop-shaped bars.

✨ Features

• Four Animation Styles: Scrolling, breathing, radial, and bars

• Teardrop Bars: Bell curve shape with sharp edges using exponential decay

• Audio Passthrough: Compatible with VideoHelperSuite Video Combine

• HD Output: Up to 1920x1920 resolution support

• Variable Opacity: Uniform, 3-level, 5-level, or 10-level opacity modes

• Preview Mode: Fast sine wave preview for testing settings

  <img width="1171" height="921" alt="image_2025-08-28_21-54-53" src="https://github.com/user-attachments/assets/16e4cfd2-59e8-4ecd-9e5e-cde78d734bce" />

📋 Installation

ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Search for "dotWaveform"
3. Click Install
4. Restart ComfyUI

Manual Installation

1. Clone to ComfyUI/custom_nodes/ComfyUI-dotWaveform/
2. Install dependencies: pip install -r requirements.txt
3. Restart ComfyUI

⚙️ Parameters

| Parameter | Default | Range | Description | |-----------|---------|-------|-------------| | width | 1280 | 100-1920 | Output width in pixels | | height | 720 | 100-1920 | Output height in pixels | | size | 6 | 1-30 | Individual dot/bar size in pixels | | spacing | 3 | 1-40 | Distance between dot/bar centers | | dot_color | #00FFFF | Hex | Color of waveform elements | | background_color | #000000 | Hex | Background color | | animation_style | scrolling | 4 options | Animation type | | max_height | 60 | 5-110 | Maximum waveform size as % of image height | | fps | 10 | 1-60 | Animation frames per second | | max_frames | 300 | 0-1000 | Frame limit (0 = unlimited) | | opacity_mode | uniform | 4 levels | Dot opacity variation | | window_size | 2.0 | 0.1-10.0 | Time window for scrolling (seconds) | | preview_mode | False | Boolean | Fast sine wave preview |

🎨 Animation Styles

Scrolling: Waveform scrolls left-to-right following audio timeline with continuous center line

Breathing: All dots pulse together with audio amplitude uniformly

Radial: Concentric rings expand from center creating ripple effects

Bars: Vertical frequency bars with teardrop bell curve shape and 2x enhanced height response

🎭 Opacity Modes

• uniform: All elements same brightness (fastest)
• 3_levels: 0%, 50%, 100% opacity steps
• 5_levels: Progressive 0%, 25%, 50%, 75%, 100% opacity
• 10_levels: Smoothest gradients with 10 opacity levels

🔧 Technical Notes

• Audio Formats: All ComfyUI compatible audio formats
• Audio Compatibility: Automatic mono→stereo conversion for VideoHelperSuite
• Sample Rates: Works with 24kHz, and standard rates
• Output: RGB image sequences compatible with video nodes

📝 Changelog

Version 1.0.0 (Initial Release)

• Four animation styles: scrolling, breathing, radial, and bars
• Bars mode with teardrop bell curve shape and 2x enhanced height response
• Audio passthrough compatibility with VideoHelperSuite Video Combine node
• Automatic mono→stereo conversion and float16→float32 for video integration
• Multiple opacity modes: uniform, 3_levels, 5_levels, 10_levels
• HD output support up to 1920x1920 resolution
• Full color customization with hex color support
• Preview mode for fast settings testing
• Sharp-edged teardrop shape using exponential decay mathematics

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ for the ComfyUI community