TouchOSC and Companion Integration

pMix’s OSC support makes it compatible with popular control surface apps. Here’s how to set up the two most common options.

TouchOSC

TouchOSC is a customizable control surface app that runs on phones, tablets, and computers.

Setup

  1. Install TouchOSC on your device
  2. In TouchOSC, create a new connection:
    • Protocol: OSC
    • Host: Your iPad’s IP address
    • Send Port: 9000 (or your configured pMix OSC port)
    • Receive Port: TouchOSC’s default (for receiving feedback)
  3. Send any message to register as a feedback subscriber

Building a control surface

Design your own control layout in TouchOSC with:

  • Buttons for switching (/pmix/program/1, /pmix/cut, /pmix/auto)
  • Faders for audio (/pmix/audio/{n}/volume)
  • Toggles for mute/overlay (/pmix/audio/{n}/mute, /pmix/overlay/{n}/toggle)
  • Labels driven by feedback (/pmix/fb/program, /pmix/fb/audio/{n}/level)

Tips

  • Use TouchOSC’s scripting to build complex macros (e.g., recall a PTZ preset + switch camera + show overlay in one button press)
  • Map feedback addresses to label/LED controls for real-time state display
  • TouchOSC works on a second iPad, iPhone, or computer alongside pMix

Bitfocus Companion

Bitfocus Companion is an open-source tool for controlling broadcast equipment with Stream Deck, web buttons, or touch interfaces.

Setup

  1. Install Companion on a computer on the same network
  2. Open the Companion web interface
  3. Add a new connection: Generic OSC
  4. Configure:
    • Target IP: Your iPad’s IP address
    • Target Port: 9000
    • Listen Port: Auto (for receiving feedback)

Building buttons

Create Companion buttons that send OSC commands:

Camera switch button:

  • Action: Send OSC /pmix/preview/1 then /pmix/auto

Audio mute toggle:

  • Action: Send OSC /pmix/audio/2/mute with argument i 1 or i 0

Start streaming:

  • Action: Send OSC /pmix/output/start

Recall scene + transition:

  • Action 1: Send OSC /pmix/scene/1
  • Action 2: Delay 100ms
  • Action 3: Send OSC /pmix/auto

Stream Deck integration

Companion connects to Elgato Stream Deck for physical button control. Each Stream Deck key can be mapped to a Companion button, giving you tactile one-press control of your pMix production.

Tips

  • Companion supports multi-action sequences — chain multiple OSC commands with delays
  • Use Companion’s feedback system with pMix’s OSC feedback for dynamic button colors
  • Companion can control multiple devices simultaneously (pMix + ATEM + lighting)
  • The web interface lets you trigger buttons from any device with a browser