> ## Documentation Index
> Fetch the complete documentation index at: https://xrlive.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Audio Reactivity

> Set controls to react to the beat of your audio feed

Audio reactivity lets certain controls move on their own in time with your audio feed — the value pulses with the beat instead of you adjusting it by hand.

<Frame caption="Enabling audio reactivity on a visual's controls">
  <video controls className="w-full aspect-video rounded-xl" src="https://storage.googleapis.com/xr-live-resources/documentation/audio-reactivity.mp4" />
</Frame>

<Note>
  Only **Slider** and **Color Picker** controls support audio reactivity. Other control types — buttons, checkboxes, dropdowns, and text inputs — don't react to audio.
</Note>

## Setting it up

<Steps>
  <Step title="Select your audio input">
    Open the menu in the top-right corner of the launcher and choose **Audio**. In the dialog, turn on **Audio Input** and pick your input device from the dropdown — a microphone, a capture device, or **\[system default]**.

    <Frame caption="Choosing the audio input device">
      <img src="https://mintcdn.com/xrlive/SzlIWgr9kyMl-3wN/images/launcher/visuals/audio-input.png?fit=max&auto=format&n=SzlIWgr9kyMl-3wN&q=85&s=672ca9d78a83682e5690fa2b7b283c60" alt="Audio input device selection" width="1594" height="958" data-path="images/launcher/visuals/audio-input.png" />
    </Frame>
  </Step>

  <Step title="Open a visual">
    Open the visual you want to drive with audio. Its controls appear in the **Properties** panel of the operator dashboard.
  </Step>

  <Step title="Enable reactivity on a slider">
    Each slider has a **wave icon** beside it. Click it to turn audio reactivity on — the icon highlights and a reactivity panel expands with a live level meter, a frequency band selector (**B / M / H**), and **min / max** filters for the audio wave. The slider now pulses with the audio instead of staying fixed.

    <Frame caption="A slider with audio reactivity enabled">
      <img src="https://mintcdn.com/xrlive/SzlIWgr9kyMl-3wN/images/launcher/visuals/audio-reactive-slider.png?fit=max&auto=format&n=SzlIWgr9kyMl-3wN&q=85&s=1ac2e68a8debb431b9593e3b6d21ec9f" alt="Slider with audio reactivity enabled" width="1602" height="956" data-path="images/launcher/visuals/audio-reactive-slider.png" />
    </Frame>
  </Step>

  <Step title="Enable reactivity on a color picker">
    Expand the **Color** control to reveal its **Hue**, **Saturation**, **Value**, and **Alpha** channels. Each channel has its own wave icon — click it to make that channel react. Enabling it on **Hue**, for example, sweeps the color through the spectrum on every beat.

    <Frame caption="A color picker channel set to react to audio">
      <img src="https://mintcdn.com/xrlive/SzlIWgr9kyMl-3wN/images/launcher/visuals/audio-reactive-color.png?fit=max&auto=format&n=SzlIWgr9kyMl-3wN&q=85&s=a12ad6b53422a0c1bc2a6b3d5fb5c26d" alt="Color picker with an audio-reactive channel" width="1602" height="956" data-path="images/launcher/visuals/audio-reactive-color.png" />
    </Frame>
  </Step>
</Steps>

## Reactivity settings

When reactivity is on, each control exposes the same set of options:

* **Level meter** — a live readout of the audio in the selected frequency band, so you can see the control responding.
* **Frequency band (B / M / H)** — selects which part of the audio drives the control: **bass**, **mid**, or **high**.
* **Min / Max** — these values act as a filter on the audio wave, setting the lower and upper bounds of the signal the control responds to.

<Tip>
  Audio-reactive controls don't need to be touched during a show — once configured, they run on their own. Save the configured state as a preset so you can recall it instantly. See [Presets](/launcher/visuals/presets).
</Tip>

→ For a full breakdown of every control type, see [Operator Controls](/launcher/visuals/operator-controls).