Hardware Setup Guide

qPlayer works on all iPhones, iPads, and Macs, but the level of functionality depends on your device and connector type. USB-C devices (iPhone 15 and later, modern iPads, all Macs) unlock the full feature set with simultaneous audio, video, and lighting. Lightning devices still work but with significant limitations on simultaneous outputs.

💻
New
🔌
Recommended
🏛️
💰
📊

Mac as a Show Machine

A Mac, especially a Mac mini, makes an excellent dedicated show playback device. No phone calls, no notifications, no accidental swipes. Just reliable show playback.

Why Use a Mac?

Mac Mini Signal Chain

A typical Mac mini show setup:

  1. Mac mini sits at the side of stage, connected to power.
  2. USB audio interface connected via USB for multichannel audio to the mixer.
  3. HDMI/USB-C display for video output to projector or LED wall.
  4. Second display for teleprompter output (optional).
  5. Ethernet for wired Art-Net/sACN DMX lighting control.
  6. Keyboard and mouse at the operator position, or just a keyboard for Space/Escape control.

Tip

Use Show Transfer to send your show from your authoring Mac to the show machine via AirDrop or LAN Transfer. Author in Studio on your laptop, transfer to the Mac mini at the venue.

Lightning iPhones (iPhone 14 and earlier)

Lightning devices have limited connectivity due to the port's bandwidth constraints. You can use one of the following at a time, not simultaneously:

In either configuration:

Key Limitation

Lightning cannot provide multichannel audio, video, lighting, and power simultaneously. You'll need to choose which features matter most for your setup, or upgrade to a USB-C iPhone for the full experience.

USB-C iPhones (iPhone 15 and later)

USB-C unlocks the full qPlayer experience. With a USB-C hub or the Apple USB-C Digital AV Multiport Adapter, multiple outputs run simultaneously:

Tip

Even without a hub, a USB-C iPhone can connect directly to a USB audio interface for multichannel output. Add a hub or the Apple adapter when you need HDMI video and charging alongside audio.

Recommended Dock: CalDigit USB-C HDMI Dock

For professional use, we recommend the CalDigit USB-C HDMI Dock. It provides a fully wired, single-dock control solution with everything you need for a complete stage setup:

Diagram showing the complete professional setup: iPhone connected via USB-C to CalDigit dock, with HDMI to screens, USB to audio interface, Ethernet to Art-Net node, 3.5mm fallback to DI box, and mains power
The complete signal chain: one dock, one cable to the phone, everything wired.

Why CalDigit?

The CalDigit is mains-powered via its own PSU, so it doesn't draw power from the phone to run the hub. It's aluminium with passive cooling: fanless and silent. It sits on a desk, shelf, or in a rack at the side of stage, and you cable it up once at soundcheck.

Signal Chain

The complete signal flow is straightforward:

  1. iPhone connects to the CalDigit dock via a single USB-C cable.
  2. HDMI from the dock to your screens and projectors.
  3. USB-A from the dock to your multichannel audio interface, then to the mixer.
  4. USB-A from the dock to a stereo USB audio device (e.g., cheap USB sound card), then to a DI box and spare mixer channel as emergency fallback.
  5. Ethernet from the dock to your Art-Net node, then to your lighting rig.
  6. Power from the mains to the dock, automatically charging the iPhone.

Tip

Cable everything to the dock once during soundcheck. Between songs, sets, or shows, the only thing you touch is qPlayer on screen. One dock, one cable to the phone, everything wired.

Budget Alternative

If you don't need the full professional setup, a compact USB-C hub with HDMI, USB-A, 3.5mm audio, and PD charging will get you most of the way there. Look for hubs from Hagibis, Anker, or UGreen that include all four ports.

These are bus-powered (no separate PSU) so they're more portable but less robust for demanding show environments. Power delivery is typically lower (30–60W vs 94W), and they may not include Ethernet.

Note

Ensure any hub you choose supports DisplayPort Alt Mode for HDMI output and USB Audio Class for your audio interface. Not all cheap hubs support both simultaneously. Check the manufacturer's specs before buying.

Quick Reference Table

Feature availability across different hardware configurations:

Feature Lightning USB-C (direct) USB-C + Hub/Adapter CalDigit Dock
Multichannel Audio Limited *
HDMI Video Limited * ✓ (Dual)
DMX (WiFi)
DMX (Wired Ethernet)
Stereo Fallback ✓ (USB stereo)
Charging While Playing HDMI adapter only ✓ (94W)
MIDI (USB) Limited *
MIDI (Bluetooth LE)
Apple Watch Remote

* Limited: Available but uses the Lightning port exclusively. Cannot be combined with other wired outputs simultaneously.

Still need help?

Drop us an email and we'll get back to you. Gig, Plus, and Pro licence holders can also submit in-app support tickets.

Email Support →