{"id":31952397,"url":"https://github.com/clonephaze/beatdriver-add-on-for-blender","last_synced_at":"2025-10-14T13:14:15.071Z","repository":{"id":309524777,"uuid":"1035902071","full_name":"Clonephaze/BeatDriver-Add-on-For-blender","owner":"Clonephaze","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-12T11:01:44.000Z","size":134266,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-12T12:01:02.665Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Clonephaze.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-11T09:08:01.000Z","updated_at":"2025-08-12T11:01:47.000Z","dependencies_parsed_at":"2025-08-12T12:01:06.744Z","dependency_job_id":"9ee08a98-79ec-4f91-8891-1d49d7385594","html_url":"https://github.com/Clonephaze/BeatDriver-Add-on-For-blender","commit_stats":null,"previous_names":["clonephaze/beatdriver-add-on-for-blender"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Clonephaze/BeatDriver-Add-on-For-blender","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Clonephaze%2FBeatDriver-Add-on-For-blender","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Clonephaze%2FBeatDriver-Add-on-For-blender/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Clonephaze%2FBeatDriver-Add-on-For-blender/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Clonephaze%2FBeatDriver-Add-on-For-blender/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Clonephaze","download_url":"https://codeload.github.com/Clonephaze/BeatDriver-Add-on-For-blender/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Clonephaze%2FBeatDriver-Add-on-For-blender/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018717,"owners_count":26086606,"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-10-14T02:00:06.444Z","response_time":60,"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":[],"created_at":"2025-10-14T13:14:13.124Z","updated_at":"2025-10-14T13:14:15.066Z","avatar_url":"https://github.com/Clonephaze.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BeatDriver\n\n⚠️ Development Stopped\n\nAs of Blender 5.0, native Audio Analysis Nodes have been added, providing the same functionality that this add-on was designed for—only faster, more reliable, more configurable, and fully integrated.\nBecause of this, BeatDriver is obsolete, and I will no longer be maintaining or updating the project.\n\nThe repository will remain available for archival and educational purposes.\n\n**Turn any audio file into animation-ready data inside Blender — instantly.**\n\nBeatDriver is a Blender add-on that processes audio into normalized float values, auto-configures your scene for synced playback, and applies a ready-to-use Geometry Nodes modifier so your objects react to music in real time.\n\n---\n\n## ✨ Features\n\n- **Multi-band audio analysis** — Outputs normalized float values for:\n  - Sub Bass\n  - Bass\n  - Low Mid\n  - Mid\n  - High Mid\n  - Presence\n  - Brilliance\n- **Beat/onset detection** — Trigger events when transient peaks occur in any band.\n- **Pulse field output** — Generates an intensity spike when a beat happens near a sound event.\n- **Automatic scene setup**:\n  - Imports your chosen audio file into Blender\n  - Adjusts scene settings for perfect audio sync\n  - Adds and wires a Geometry Nodes modifier for animation control\n- **Common audio format support** — MP3, WAV, FLAC, and more.\n\n---\n\n## 📦 Installation\n\n1. Download the latest release `.zip` from [Releases](../../releases).\n2. In Blender, go to:\n   - **Edit \u003e Preferences \u003e Add-ons \u003e Install**\n3. Select the downloaded `.zip` file.\n4. Enable **BeatDriver** in the add-ons list.\n5. You’re ready to roll.\n\n---\n\n## 🚀 Usage\n\n1. **Add an object** in your scene you want to animate.\n2. Go to **BeatDriver Panel** in the *N-Panel*.\n3. Select an audio file (MP3, WAV, FLAC, etc.).\n4. Click **Process Audio**.\n5. BeatDriver will:\n   - Convert the audio into a multi-band dataset\n   - Set up the scene for synced playback\n   - Apply the “Audio CSV Driver” Geometry Nodes group to your selected object\n6. Play the timeline — your object now reacts to the music.\n\n---\n\n## ⚙️ Technical Details\n\n- **Audio Processing**  \n  Uses a Python-based analysis pipeline to extract frequency band RMS levels and onset events per frame.  \n  Data is normalized (0–1) for consistent animation scaling regardless of input volume.\n\n- **Band Mapping**  \n  Default frequency ranges (Hz):  \n  - Sub Bass: 20–60  \n  - Bass: 60–250  \n  - Low Mid: 250–500  \n  - Mid: 500–2000  \n  - High Mid: 2k–4k  \n  - Presence: 4k–6k  \n  - Brilliance: 6k–20k  \n\n- **Beat Detection**  \n  Peaks are detected using an adaptive threshold algorithm across all bands, producing a boolean flag that can be mapped to animation events or triggers.\n\n- **Geometry Nodes Integration**  \n  The included node group uses `Scene Time` → `Sample Index` to pull the correct frame’s data from an internally imported CSV, allowing easy multiplier-based control over animation strength.\n\n---\n\n## 📂 File Structure\n\nBeatDriver/\n├── init.py\n├── audio_processing.py\n├── node_setup.py\n├── utils.py\n├── blender_manifest.toml\n└── README.md\n\n---\n\n## 🖼 Example\n\n![BeatDriver Demo](https://youtu.be/zv0VqOOstxY)  \n\n## 📄 License\n\nGPL-3.0-or-later — See [LICENSE](LICENSE) for details.\n\n---\n\n## 🤝 Contributing\n\n1. Fork the repo\n2. Create a new branch for your feature/fix\n3. Submit a pull request with clear notes on your changes\n\n---\n\n## 🙌 Credits\n\nCreated by **Clonephaze**  \nIf you use BeatDriver in your projects, I’d love to see it! Tag me or share your work.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclonephaze%2Fbeatdriver-add-on-for-blender","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclonephaze%2Fbeatdriver-add-on-for-blender","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclonephaze%2Fbeatdriver-add-on-for-blender/lists"}