ASMR Viewport
Official Documentation

Welcome to ASMR Viewport, a custom Blender add-on that introduces sophisticated, tactile auditory feedback to your 3D workflow. This guide covers installation, configuration, and troubleshooting to help you get the most out of your immersive workspace.

🛠️ Installation Guide

1. Download the latest asmr_viewport.py file (or zip package) from your purchase or release page.

2. Open Blender (v3.0 or newer).

3. Navigate to Edit > Preferences > Add-ons.

4. Click on the Install button in the top right corner.

5. Select the downloaded file and click Install Add-on.

6. Search for ASMR Viewport in the add-on list and enable the checkbox to activate it.

7. Open the N-Panel (Sidebar) in the 3D Viewport by pressing N, and locate the ASMR Viewport tab to configure your settings.

⚙️ Settings & Configuration Guide

You can customize your audio feedback preferences under Edit > Preferences > Add-ons > ASMR Viewport or directly from the 3D Viewport sidebar panel.

Global Controls

• Master Volume: Controls the overall loudness of all generated or custom audio cues (Default: 0.08).

• Use Custom Audio Files: Toggle this on to replace synthesized sounds with your own .wav or .mp3 files for individual actions.

Event Settings & Frequencies

Each action can be independently enabled or disabled and customized with a specific base pitch (Hz) or custom file:

• Save Project: Triggers when saving your .blend file.

• Undo / Redo: Provides subtle feedback when stepping backward or forward through history.

• Select Objects: Plays a crisp cue when changing object selections in the viewport.

• Move / Rotate / Scale End: Confirmation thud when completing a transformation (LMB, Enter, Space).

• Cancel Transform: Distinct audio cue when aborting a transformation via RMB or ESC.

• Gear Snap Step: The core mechanical click played during unit-based snapping.

Snap Step Sizes

Configure the threshold intervals at which the gear snap sound triggers during active transformations:

• Move Step (m): Distance interval for Grab (G), default 1.0m.

• Rotate Step (deg): Angle interval for Rotate (R), default 15.0°.

• Scale Step: Factor interval for Scale (S), default 0.2.

• Pitch Step Inc (%): Pitch shift increase per step increment, giving a rising or falling pitch feedback as you scale numbers up or down.