> For the complete documentation index, see [llms.txt](https://codalin.gitbook.io/nodalin-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codalin.gitbook.io/nodalin-docs/how-to.../live-audio-sync.md).

# Live Audio Sync

### How to Sync with Audio

This guide goes in depth into using live audio input in Nodalin, including selecting audio input devices and configuring custom audio routing. If you want to work with audio files such as MP3 or WAV, you can simply import them into Nodalin by dragging and dropping the file onto the app. Imported audio assets can then be selected directly from the Assets dropdown of an Audio node.

Nodalin supports real-time audio input through the Web Audio API, allowing you to create audio-reactive visuals that respond to music, voice, or any other live sound source.

### Quick Start

#### 1. Enable Audio Access

1. Click the **Audio icon** in the toolbar 

<div align="left" data-with-frame="true"><figure><img src="https://937151318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44MuVIHBk5o5yfcGn64w%2Fuploads%2F7koypuP8WhnszBYw279z%2Fimage.png?alt=media&amp;token=c267b2c5-615e-4d1c-a38a-4f0ec1a10cf1" alt="" width="59"><figcaption></figcaption></figure></div>

1. Grant microphone permission in your browser when prompted.

<div data-with-frame="true"><figure><img src="https://937151318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44MuVIHBk5o5yfcGn64w%2Fuploads%2FfeLw6zgQjc5wDPSTIDTF%2Fimage.png?alt=media&amp;token=be5bc9e8-90f1-409f-8c29-111ea7a2bd12" alt=""><figcaption><p>How <strong>Google Chrome</strong> asks for audio access "microphone" permission</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://937151318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44MuVIHBk5o5yfcGn64w%2Fuploads%2Flk6krcgub8JFLEK8VPz6%2Fimage.png?alt=media&amp;token=9aa166ba-3f69-4a10-abc1-eec54d971bfa" alt=""><figcaption><p>How the <strong>Arc browser</strong> asks for audio access "microphone" permission</p></figcaption></figure></div>

### **Manually Granting Permissions**

If the permission prompt did not appear, you can manually grant audio and MIDI permissions from the site’s settings.

**Chrome and Chromium-based browsers**

<div data-with-frame="true"><figure><img src="https://937151318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44MuVIHBk5o5yfcGn64w%2Fuploads%2FRLyLJ2uPx6Tgr6eQXHXy%2Fchrome_persmissions-ezgif.com-video-to-gif-converter.gif?alt=media&amp;token=0ffb504e-8719-426a-8387-5f0a106a683b" alt="" width="563"><figcaption><p>Granding permissions on Chrome</p></figcaption></figure></div>

**Firefox**

<div data-with-frame="true"><figure><img src="https://937151318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44MuVIHBk5o5yfcGn64w%2Fuploads%2FaCLeUeDZPttTTISkkggf%2Fff_permissions-ezgif.com-video-to-gif-converter.gif?alt=media&amp;token=3880838e-3328-4c11-81fa-5ccbdc4f01df" alt="" width="563"><figcaption><p>In <strong>Firefox</strong>, enabling MIDI and Audio permissions is easy — if you know where to look...</p></figcaption></figure></div>

Once enabled, Nodalin will automatically detect and list the available audio input devices.

#### 2. Select Your Audio Input

1. Open Audio Settings from the toolbar.
2. Your available audio input devices will appear in the list.
3. Select the device you want to use by clicking its radio button.
4. The Audio Analyser will display a real-time frequency spectrum of the selected input.

<figure><img src="https://937151318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44MuVIHBk5o5yfcGn64w%2Fuploads%2FHhti86GiCvYxFEf0Bz1N%2Fimage.png?alt=media&amp;token=4a9868a8-f477-4ce4-ace4-7bc2edf0acdc" alt="" width="308"><figcaption></figcaption></figure>

#### 3. Use Audio Nodes

1. Add an Audio node from the Streams category.
2. Configure the frequency range.
3. Use the Output Scale to adjust the range of the output value.
4. Connect the Audio node to any compatible property input.

<div data-with-frame="true"><figure><img src="https://937151318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44MuVIHBk5o5yfcGn64w%2Fuploads%2FzHz19R4z0usCXrZ78eMU%2Faudionode.gif?alt=media&amp;token=5affc991-1d10-4ae2-806d-ce38b22464b2" alt=""><figcaption></figcaption></figure></div>

### On your next session

After you have configured an audio input in Nodalin, the next time you open or reload the app, you will see a dialog asking you to activate your previously selected audio device.

This step is ***required by your browser*** as a security measure. It ensures that audio input is not activated without your explicit permission, even if you have already granted microphone access.

<figure><img src="https://937151318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44MuVIHBk5o5yfcGn64w%2Fuploads%2F4aFSxkuPIwK4PvEPc7hV%2Fimage.png?alt=media&amp;token=3e765099-4722-42af-98c4-0420bd4f2216" alt="" width="375"><figcaption></figcaption></figure>