{"id":30687330,"url":"https://github.com/Saganaki22/ComfyUI-dotWaveform","last_synced_at":"2025-09-02T00:04:00.895Z","repository":{"id":312121880,"uuid":"1046404851","full_name":"Saganaki22/ComfyUI-dotWaveform","owner":"Saganaki22","description":"ComfyUI node that generates animated dotted waveform visualizations from audio input with multiple animation styles including teardrop-shaped bars.","archived":false,"fork":false,"pushed_at":"2025-08-28T21:00:36.000Z","size":40,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-28T23:31:52.087Z","etag":null,"topics":["audio","audio-analysis","audio-processing","audio-visualizer","audiovisual","audiovisualizer","comfyui","comfyui-custom-node","comfyui-nodes","comfyui-workflow","waveform"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Saganaki22.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-28T16:29:59.000Z","updated_at":"2025-08-28T22:27:44.000Z","dependencies_parsed_at":"2025-08-28T23:32:11.901Z","dependency_job_id":"6fe5cee4-70cf-4196-a03e-6adefc7d1e34","html_url":"https://github.com/Saganaki22/ComfyUI-dotWaveform","commit_stats":null,"previous_names":["saganaki22/comfyui-dotwaveform"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Saganaki22/ComfyUI-dotWaveform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Saganaki22%2FComfyUI-dotWaveform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Saganaki22%2FComfyUI-dotWaveform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Saganaki22%2FComfyUI-dotWaveform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Saganaki22%2FComfyUI-dotWaveform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Saganaki22","download_url":"https://codeload.github.com/Saganaki22/ComfyUI-dotWaveform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Saganaki22%2FComfyUI-dotWaveform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273208777,"owners_count":25064204,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-01T02:00:09.058Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","audio-analysis","audio-processing","audio-visualizer","audiovisual","audiovisualizer","comfyui","comfyui-custom-node","comfyui-nodes","comfyui-workflow","waveform"],"created_at":"2025-09-02T00:01:52.989Z","updated_at":"2025-09-02T00:04:00.835Z","avatar_url":"https://github.com/Saganaki22.png","language":"Python","funding_links":[],"categories":["Workflows (3395) sorted by GitHub Stars"],"sub_categories":[],"readme":"![0000_00018](https://github.com/user-attachments/assets/e08d3f3e-23e6-445a-88da-29ee09f6f2b1)\n\n# ComfyUI Dotted Waveform Visualizer 🎵\n\n[![GitHub Stars](https://img.shields.io/github/stars/Saganaki22/ComfyUI-dotWaveform?style=for-the-badge\u0026logo=github)](https://github.com/Saganaki22/ComfyUI-dotWaveform/stargazers)\n[![GitHub Issues](https://img.shields.io/github/issues/Saganaki22/ComfyUI-dotWaveform?style=for-the-badge\u0026logo=github)](https://github.com/Saganaki22/ComfyUI-dotWaveform/issues)\n[![GitHub License](https://img.shields.io/github/license/Saganaki22/ComfyUI-dotWaveform?style=for-the-badge)](https://github.com/Saganaki22/ComfyUI-dotWaveform/blob/main/LICENSE)\n[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue?style=for-the-badge\u0026logo=python)](https://python.org)\n[![ComfyUI](https://img.shields.io/badge/ComfyUI-Compatible-brightgreen?style=for-the-badge)](https://github.com/comfyanonymous/ComfyUI)\n\nA ComfyUI node that generates animated dotted waveform visualizations from audio input with multiple animation styles including teardrop-shaped bars.\n\n\n## ✨ Features\n\n- **Four Animation Styles**: Scrolling, breathing, radial, and bars\n- **Teardrop Bars**: Bell curve shape with sharp edges using exponential decay\n- **Audio Passthrough**: Compatible with VideoHelperSuite Video Combine\n- **HD Output**: Up to 1920x1920 resolution support\n- **Variable Opacity**: Uniform, 3-level, 5-level, or 10-level opacity modes\n- **Preview Mode**: Fast sine wave preview for testing settings\n\n  \u003cimg width=\"1171\" height=\"921\" alt=\"image_2025-08-28_21-54-53\" src=\"https://github.com/user-attachments/assets/16e4cfd2-59e8-4ecd-9e5e-cde78d734bce\" /\u003e\n\n## 📋 Installation\n\n### ComfyUI Manager (Recommended)\n1. Open ComfyUI Manager\n2. Search for \"dotWaveform\"\n3. Click Install\n4. Restart ComfyUI\n\n### Manual Installation\n1. Clone to `ComfyUI/custom_nodes/ComfyUI-dotWaveform/`\n2. Install dependencies: `pip install -r requirements.txt`\n3. Restart ComfyUI\n\n## ⚙️ Parameters\n\n| Parameter | Default | Range | Description |\n|-----------|---------|-------|-------------|\n| **width** | 1280 | 100-1920 | Output width in pixels |\n| **height** | 720 | 100-1920 | Output height in pixels |\n| **size** | 6 | 1-30 | Individual dot/bar size in pixels |\n| **spacing** | 3 | 1-40 | Distance between dot/bar centers |\n| **dot_color** | #00FFFF | Hex | Color of waveform elements |\n| **background_color** | #000000 | Hex | Background color |\n| **animation_style** | scrolling | 4 options | Animation type |\n| **max_height** | 60 | 5-110 | Maximum waveform size as % of image height |\n| **fps** | 10 | 1-60 | Animation frames per second |\n| **max_frames** | 300 | 0-1000 | Frame limit (0 = unlimited) |\n| **opacity_mode** | uniform | 4 levels | Dot opacity variation |\n| **window_size** | 2.0 | 0.1-10.0 | Time window for scrolling (seconds) |\n| **preview_mode** | False | Boolean | Fast sine wave preview |\n\n## 🎨 Animation Styles\n\n**Scrolling**: Waveform scrolls left-to-right following audio timeline with continuous center line\n\n**Breathing**: All dots pulse together with audio amplitude uniformly\n\n**Radial**: Concentric rings expand from center creating ripple effects\n\n**Bars**: Vertical frequency bars with teardrop bell curve shape and 2x enhanced height response\n\n## 🎭 Opacity Modes\n\n- **uniform**: All elements same brightness (fastest)\n- **3_levels**: 0%, 50%, 100% opacity steps\n- **5_levels**: Progressive 0%, 25%, 50%, 75%, 100% opacity\n- **10_levels**: Smoothest gradients with 10 opacity levels\n\n## 🔧 Technical Notes\n\n- **Audio Formats**: All ComfyUI compatible audio formats\n- **Audio Compatibility**: Automatic mono→stereo conversion for VideoHelperSuite\n- **Sample Rates**: Works with 24kHz, and standard rates\n- **Output**: RGB image sequences compatible with video nodes\n\n## 📝 Changelog\n\n### Version 1.0.0 (Initial Release)\n- Four animation styles: scrolling, breathing, radial, and bars\n- Bars mode with teardrop bell curve shape and 2x enhanced height response\n- Audio passthrough compatibility with VideoHelperSuite Video Combine node\n- Automatic mono→stereo conversion and float16→float32 for video integration\n- Multiple opacity modes: uniform, 3_levels, 5_levels, 10_levels\n- HD output support up to 1920x1920 resolution\n- Full color customization with hex color support\n- Preview mode for fast settings testing\n- Sharp-edged teardrop shape using exponential decay mathematics\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n**Made with ❤️ for the ComfyUI community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSaganaki22%2FComfyUI-dotWaveform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSaganaki22%2FComfyUI-dotWaveform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSaganaki22%2FComfyUI-dotWaveform/lists"}