Audio2Blender 0.3.1 (Extension)
⚠️ Privacy & Device Access Disclaimer
By using Audio2Blender, you grant permission for the extension to access audio input devices connected to your computer (e.g. microphones, sound cards, virtual devices). No data is collected, stored, or transmitted. Audio2Blender does not connect to the internet, send data externally, or access any files on your system. All processing happens locally inside Blender, on your machine and in real time.
© 2025 Tommaso Malaisi — Licensed under GNU GPL v3 or later.
Audio2Blender brings real-time audio analysis into Blender, enabling direct use of live audio data inside Geometry Nodes. With this extension, you can analyze both overall volume and frequency spectrum (linear or logarithmic bands) to drive any node parameter or animation directly with sound — ideal for sound-reactive visuals, generative art, or interactive installations.
✨ Features

• Real-time audio sampling using sounddevice.
• Volume analysis (RMS level mapped to 0–1).
• FFT spectrum analysis (linear or logarithmic bands).
• Adjustable number of bands, gain, noise floor, and gating.
• Per-band smoothing with attack and release times.
• Precision/deadband control to reduce unnecessary updates.
• Automatic creation of scene objects and attributes (Volume / FFT).
• Integrated Blender UI panel under Sidebar → Audio2Blender.

🧩 Requirements

• Blender 4.2 or newer

• Python dependencies:

  • sounddevice (bundled in the extension)
  • numpy (included with Blender)

⚙️ Note: All required packages are provided as pre-built wheels inside the audio2bl_modules package. No internet connection is required.

🧤 Installation

Step 1 — Install the Modules

1. Open Blender.
2. Drag and drop audio2bl_modules.zip directly into the Blender window, or install it via Edit → Preferences → Get Extensions → Install from Disk.
3. Confirm installation.

Step 2 — Install Audio2Blender

1. Once audio2bl_modules is installed, repeat the same process for audio2blender.zip.
2. Enable the extension if not automatically activated.
3. Restart Blender if prompted.

🥏 macOS Users

On macOS, Blender must be launched with administrator privileges for Audio2Blender to access audio input devices correctly.

1. Open Terminal.

2. Type the following command and press Enter:

   
   
   /Applications/Blender.app/Contents/MacOS/Blender
   

3. If you use a specific version (e.g. Blender 4.5), include the version number in quotes:

   
   
   "/Applications/Blender 4.5.app/Contents/MacOS/Blender"
   

4. Once Blender is open from Terminal, install the extensions as described above.

💡 You must launch Blender this way each time you want to use Audio2Blender.

🔊 Usage

1. Open 3D Viewport → Sidebar → Audio2Blender.
2. Select your input device and channel.
3. Choose an analysis mode (Volume / FFT Linear / FFT Log).
4. Adjust Gain, Floor, Gate, Smoothing, and Precision as desired.
5. Press Start Audio Sampling.

Objects will automatically appear in your scene:

• Volume → a single float attribute volume.
• FFT → a point cloud with one vertex per band, attribute fft.

You can use these attributes directly in Geometry Nodes or modifiers to drive animations, shaders, or physics with sound.

❌ Uninstall

1. Go to Edit → Preferences → Get Extensions → Audio2Blender.
2. Open the dropdown menu in the top-right corner.
3. Select Uninstall.

If you wish to completely remove dependencies, also uninstall audio2bl_modules.

⚖️ License

This extension is licensed under the GNU General Public License v3 or later (GPL-3.0-or-later). See the included LICENSE file for details.

📄 Third-Party Licenses

Audio2Blender includes or depends on the following open-source components:

• python-sounddevice © 2015–2025 Matthias Geier — MIT License See SOUNDDEVICE_LICENSE.txt

• PortAudio © 1999–2011 Ross Bencina, Phil Burk — MIT License See PORTAUDIO_LICENSE.txt

• cffi © 2013–2024 The PyPy Project — MIT No Attribution (MIT-0) See CFFI_LICENSE.txt

• pycparser © 2008–2022 Eli Bendersky — BSD 3-Clause License See PYCARSER_LICENSE.txt

© 2025 Tommaso Malaisi — Licensed under GNU GPL v3 or later.