Skip to content

    These docs are a work in progress. The software can already be used — download WavePhase.

    Documentation

    Docs for WavePhase v0.9.3 · reviewed 2026-08-10

    A newer app release may have shipped since this review. These pages describe the latest public WavePhase release. If something looks different in your build, check for an app update.

    Getting Started

    Quick Start

    In about five minutes you'll create a fixture, patch it to DMX, and wire the beat to its intensity so it pulses with the music.

    Before you start

    Make sure you've selected an audio input and have music playing into it, so the analysis sources have something to react to (see Installation).

    1. Create a fixture

    1. 1

      Open the fixture library

      Open the fixture editor and create a new fixture definition. Give it a name like Simple PAR.
    2. 2

      Add channels

      Add a channel called Intensity. A fixture definition is just a name plus an ordered list of channels — add as many as your real fixture has (Pan, Tilt, Red, Green, Blue, …).

    2. Patch it to DMX

    Add a Fixture Out node to the signal patch and select your Simple PAR definition. Set its DMX address:

    1. 1

      Universe & start channel

      Choose a universe (e.g. 0) and a start channel (e.g. 1). The fixture occupies consecutive channels from there.
    2. 2

      Protocol & target

      Pick Art-Net and enter the target IP of your node or fixture (or a broadcast/controller address on your lighting network).

    3. Wire the beat to intensity

    1. 1

      Add a source

      Add a Source node and choose a beat-driven value — for example Envelope Peak or a Beat Trigger. Audio sources output F32 values.
    2. 2

      Connect it

      Drag from the source's output pin to the Intensity input on your Fixture Out node. Compatible pins snap together; mismatched types won't connect.
    3. 3

      Watch it react

      With music playing, the intensity now follows the audio and your fixture pulses to the beat.

    Smooth it out

    Want a softer pulse? Insert an Animator or a smoothing/lag node between the source and the fixture to shape the response.

    Where to go next

    That's the core loop: source → nodes → output. From here:

    Was this page helpful?