OpenFollow Preview

Manual / Tracking

Hardware Inputs

Hardware Inputs feeds MIDI controllers and fader-style controls into OpenFollow. Once configured here, those signals drive OSC Transmitters transmitters via the MIDI message / Fader on change triggers and matching placeholders.

Everything lives under Input → MIDI: MIDI Patches, the virtual fader bus, and the read-only marker faders. Pair this chapter with Gamepad, Keyboard & OSC for the operator-facing marker inputs.

MIDI Patches

A patch is a stable, integer-ID'd slot you assign a connected MIDI device to – the same idea as a QLab MIDI patch. The patch ID is the foreign key everything else references (OSC Output triggers, virtual fader sources), not the OS port name or the optional alias. IDs are assigned sequentially on Add and stay put across reboots and device swaps.

Adding a patch

  1. Connect the MIDI controller (USB or USB-MIDI to 5-pin DIN).
  2. Click Add new MIDI Patch. The patch gets the next free ID.
  3. Pick the device from the Device dropdown of connected ports, optionally set an Alias (e.g. FOH, X-Touch), and Save the row.

Each row saves and deletes independently. A patch whose device is unplugged keeps its binding – the device shows (not connected) and re-saving preserves it.

Patch fields

FieldMeaning
IDThe patch's stable integer key. Read-only; assigned on Add. 0 is reserved as the "any patch" wildcard, so a real patch is always ≥ 1.
AliasOptional friendly name (max 64 chars). Shown in patch dropdowns alongside the ID.
DeviceThe connected MIDI input port bound to this patch. Identity falls through the device serial first, then the port-name / product pair, so two of the same model can be told apart.

Virtual fader bus

The virtual fader bus exposes eight normalised 0.0 – 1.0 values, addressed by their position on the bus (1 through 8). Each fader carries an operator-set display name that defaults to "Fader 1", "Fader 2", etc.; OSC Output transmitters reference a fader by its index. The bus is fixed at eight faders – you can't add or delete entries.

Configuring a fader

Open Input → MIDI → Virtual Faders and click a strip to load its editor. Each fader takes:

FieldMeaning
Display nameShown on the operator screen and in trigger forms that reference this fader. Max 32 chars.
Default value0.00 – 1.00. The fader's value at startup.
ColourSwatch that tints the fader strip.
Show on Operator ScreenSurfaces the fader on the Operator Screen.
Source TypeNo source (the fader sits at its default value) or MIDI.

With Source Type → MIDI, pick the Patch (or any patch), the Message Type (Control Change, Key Pressure, or Channel Pressure), the Channel (0 = any, 1–16 for one channel), and the CC / Note number. Or click Learn and move the control – the next message it sends (10-second window) fills the patch / type / channel / number for you. Save the fader; its live value appears in the strip and is immediately available to OSC Output transmitters.

Marker faders

The Marker Faders group under Input → MIDI is a read-only readout – one fader per controlled marker, driven by whichever gamepad currently controls that marker. They're auto-provisioned from the controlled markers, not configured here. Send a marker's fader value with the OSC [markerfader] placeholder.

Which gamepad stick axis feeds the marker faders, and how fast it travels, is set on the Gamepad page – the Left Y or Right Y stick, and the max-speed setting, which is the number of seconds for a full sweep at full deflection.

Operator Screen status indicator

The on-screen overlay carries a small status indicator in the top-right corner that surfaces subsystem health – one row per active condition. MIDI conditions appear here, e.g. a patch whose bound device isn't connected, or MIDI being unavailable on the host. No active condition means the indicator is empty.

Where this connects