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.

    Nodes & Signals

    External I/O

    WavePhase doesn't live in isolation. Bring values in from OSC, MIDI, DMX, timecode, and an HTTP/MCP API — and send OSC and DMX back out — so it fits into any rig or software setup.

    Inputs

    OSC In

    Receive OSC over UDP and latch the latest value matching an address pattern and argument index. Great for control from visual software, a DAW, phones, or anything else that speaks OSC.

    MIDI In

    Learn a CC fader or a note/button from a USB or virtual MIDI device and map it to a float, int, or bool.

    DMX In

    Read a channel from incoming Art-Net (UDP 6454) as a F32 0..1 or raw I32 0–255 — take control from a console.

    Timecode In

    Follow SMPTE timecode via MTC, Art-Net, or OSC. Outputs seconds, a timecode string, and a running flag for timeline-accurate shows.

    API In

    An HTTP REST + MCP endpoint. JSON body fields appear on typed outputs, so other apps and agents can drive the patch.

    MIDI learn

    The fastest way to bind a physical control: add a MIDI In node, put it in learn mode, then move the fader or press the button you want. WavePhase captures the message and maps it automatically.

    Hands-on control

    MIDI faders are perfect for a live master dimmer, manual color, or a "panic" blackout — wire them alongside your music-reactive signals for the best of both.

    Outputs

    • OSC Out — send OSC messages (float, int, string, or a trigger shape) to other software and hardware.
    • DMX Out — send a single DMX channel via Art-Net or sACN.
    • Fixture Out — send a full multi-channel fixture (see Patching).
    • Web Control — a browser-based control surface (covered in Controlling Fixtures).

    Using WavePhase as a hub

    Because it receives OSC, MIDI, and DMX — and sends OSC and DMX — WavePhase can sit in the middle of a rig: take audio analysis in, blend it with console or DAW control, and fan the result out to lights, media servers, and other software — all from one patch.

    Default OSC port

    OSC input listens on a configurable UDP port (commonly 8001). Set the address pattern on the OSC In node to match what your sender is emitting.

    Driving a patch from software? See the lighting control API.

    Was this page helpful?