https://github.com/Saganaki22/ComfyUI-dotWaveform
ComfyUI node that generates animated dotted waveform visualizations from audio input with multiple animation styles including teardrop-shaped bars.
https://github.com/Saganaki22/ComfyUI-dotWaveform
audio audio-analysis audio-processing audio-visualizer audiovisual audiovisualizer comfyui comfyui-custom-node comfyui-nodes comfyui-workflow waveform
Last synced: 10 months ago
JSON representation
ComfyUI node that generates animated dotted waveform visualizations from audio input with multiple animation styles including teardrop-shaped bars.
- Host: GitHub
- URL: https://github.com/Saganaki22/ComfyUI-dotWaveform
- Owner: Saganaki22
- License: mit
- Created: 2025-08-28T16:29:59.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-28T21:00:36.000Z (10 months ago)
- Last Synced: 2025-08-28T23:31:52.087Z (10 months ago)
- Topics: audio, audio-analysis, audio-processing, audio-visualizer, audiovisual, audiovisualizer, comfyui, comfyui-custom-node, comfyui-nodes, comfyui-workflow, waveform
- Language: Python
- Homepage:
- Size: 39.1 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-comfyui - **dotWaveform**
README
# ComfyUI Dotted Waveform Visualizer 🎵
[](https://github.com/Saganaki22/ComfyUI-dotWaveform/stargazers)
[](https://github.com/Saganaki22/ComfyUI-dotWaveform/issues)
[](https://github.com/Saganaki22/ComfyUI-dotWaveform/blob/main/LICENSE)
[](https://python.org)
[](https://github.com/comfyanonymous/ComfyUI)
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
## 📋 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](LICENSE) file for details.
---
**Made with ❤️ for the ComfyUI community**