> 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/nodes-reference/streams/audio.md).

# Audio

<table data-header-hidden><thead><tr><th width="141.6597900390625"></th><th></th></tr></thead><tbody><tr><td><div><figure><img src="https://937151318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F44MuVIHBk5o5yfcGn64w%2Fuploads%2FVyAHIT1kayQvwONs6LIf%2Fimage.png?alt=media&amp;token=11e963a2-1fbd-4ed7-85ee-fae0c4a5b6a9" alt="" width="76"><figcaption></figcaption></figure></div></td><td><p>The Audio node analyzes an audio signal and outputs the average amplitude of a specified frequency range as a <code>number</code>. The audio signal can come from an imported audio asset or from the live microphone input.</p><p>Use the minimum and maximum frequency controls to isolate a specific frequency band, and use the output scale to adjust the range of the resulting value.</p></td></tr></tbody></table>

<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>

### Assets

The Assets dropdown lists the audio assets currently imported into Nodalin. Select an asset to use it as the Audio node’s input.

By default, the Audio node uses the Live Microphone input. A short demo loop is included to help you get started with audio-reactivity. You can also import your own audio files at any time using the Add Audio button. You can also import audio files through the Assets pane as described in the [UI Overview](/nodalin-docs/quick-guide/ui-overview.md#the-assets-pane)

### Frequency Range Selection

The Audio node analyzes the average amplitude within the selected frequency range.

**Common Frequency Ranges:**

* <mark style="color:blue;background-color:blue;">**`Sub`**</mark>: 20-80 Hz (kick drum fundamentals)
* <mark style="color:$primary;">**`Bass`**</mark>: 80-500 Hz (bass guitar, kick drum)
* <mark style="color:orange;">**`Mids`**</mark>: 500-4k Hz (vocals, snare)
* <mark style="color:pink;">**`Highs`**</mark>**:** 4k-20k (hi-hats, cymbals)

The vertical lines in the analyser indicate the currently selected frequency range. Drag the lines to adjust the range, or click on the analyser to select one of the common frequency ranges.

### Output meter

The meter next to the analyser displays the numeric value currently being output by the Audio node.

Use the **Output Scale** dropdown below the meter to control the range of the output value.

You can also set a Gate threshold by dragging the handle near the bottom of the meter. When the detected amplitude falls below the gate threshold, the Audio node outputs zero. This can be useful for creating more pronounced transitions or filtering out quieter sounds.

{% hint style="info" %}
If the Audio node preview shows `...` instead of oscillating bars, no audio is currently being detected within the selected frequency range.
{% endhint %}

<table><thead><tr><th width="154.75">Property name</th><th width="404.7265625">Description</th><th>Compatible datatype</th></tr></thead><tbody><tr><td>minFreq</td><td>Minimum frequency (Hz)</td><td>number</td></tr><tr><td>maxFreq</td><td>Maximum frequency (Hz)</td><td>number</td></tr><tr><td>multiplier</td><td>Multiplier for output value</td><td>number</td></tr><tr><td>gate</td><td>Gate threshold. Output is zero when the detected amplitude is below this value.</td><td>number</td></tr></tbody></table>

### Example Workflows

#### Multi-Band Color Control

1. Create three Audio nodes:
   * Bass: `60-250 Hz` → Red channel
   * Mids: `500-2000 Hz` → Green channel
   * Highs: `4000-10000 Hz` → Blue channel
2. Map each to Color node's Hue, Saturation, or Luminosity
3. Create a spectrum-driven color palette

#### Frequency-Reactive Grid

1. Audio node for bass → Grid `rows`
2. Audio node for mids → Grid `columns`
3. Audio node for highs → Grid `spacingX`
4. Watch the grid morph with the music

#### Audio-Driven Effects Chain

1. Audio (bass) → Blur `radius`
2. Audio (mids) → Bloom `intensity`
3. Audio (highs) → Chromatic `strength`
4. Create dynamic, music-synced post-processing

{% hint style="warning" icon="microphone-stand" %}
For more advanced audio setups, including custom audio routing and using audio sources other than the default microphone input, see our [Live Audio Sync](/nodalin-docs/how-to.../live-audio-sync.md) guide.
{% endhint %}