Getting Started
Q2Q requires macOS 14.6 Sonoma or later. It runs natively on Apple Silicon (M1 and later) and is not supported on Intel Macs. We recommend keeping macOS up to date.
Yes — Q2Q requires NDI Tools to be installed on your Mac. NDI Tools is free and available from ndi.video. Q2Q loads the NDI runtime dynamically at launch; without it, NDI source discovery and output will not function.

NDI Tools does not need to be running — only installed.
Q2Q is a one-time purchase on the Mac App Store. Check the App Store listing for current pricing.
Install NDI Tools from ndi.video, then relaunch Q2Q. The app looks for the NDI library at the path installed by NDI Tools. If you installed NDI Tools and still see this error, try reinstalling NDI Tools to ensure the library is placed correctly.
NDI Sources
NDI discovery uses mDNS and does not cross router boundaries by default. Confirm your Mac and NDI sources are on the same subnet.

Check that macOS Firewall isn't blocking Q2Q: go to System Settings → Privacy & Security → Firewall and allow incoming connections for Q2Q.

For cross-subnet sources, use NDI Bridge (included with NDI Tools) or enter the source IP manually.
Yes. Q2Q supports both full-bandwidth NDI and NDI|HX. NDI|HX decoding uses hardware acceleration on Apple Silicon where available.
Q2Q has 10 input slots: 6 NDI/camera slots, 2 media player slots, and 2 ME engine output slots. The practical decode limit depends on your Mac's hardware and network bandwidth. Wired Gigabit Ethernet is strongly recommended for production use with multiple simultaneous 1080p sources.
Switching & Transitions
Q2Q includes 18 transitions: Cut, Dissolve, Dip to Black, Dip to White, Wipe Left, Wipe Right, Wipe Up, Wipe Down, Box In, Box Out, Star Wipe, Push Left, Push Right, Push Up, and Push Down.

Each transition has an independently configurable duration, or you can set a master duration that applies to all transitions without a specific override.
Yes. Cut and Auto are accessible via keyboard. See the full shortcut reference in the Docs.
Q2Q outputs an NDI Program feed that any NDI-compatible receiver on your network can pick up — OBS, vMix, Wirecast, capture cards, and more. It also outputs a separate NDI Multiview feed. Both are available from the moment the app launches.
Keyers & ME Engines
DSK (Downstream Keyer) composites a key layer on top of the final program output — useful for persistent lower thirds, bugs, or overlays that should appear over everything. USK (Upstream Keyer) composites within an ME engine before the signal reaches the program mix. Q2Q has 2 DSK layers and 2 USK layers, each with alpha, luma, and chroma key modes.
Q2Q has two independent Mix Effects (ME) engines. Each ME takes an input source and composites it with a shape mask — choose from 18 shapes including rectangles, circles, diamonds, stars, chevrons, and organic blobs. You can add border, drop shadow, and crop, then save up to 8 presets per engine. ME outputs appear as ME 1 and ME 2 in the main source grid and can be selected for Program or Preview like any other input.
Chroma key quality is most affected by lighting on the green/blue screen and the source video quality. In Q2Q, adjust the Clip and Gain sliders to fine-tune the key range, and ensure your backdrop is evenly lit with no colour spill on the subject. The chroma key pipeline uses a GPU-accelerated 32³ colour cube for clean real-time results.
Audio Mixer
Every channel has an independent DSP chain: gain, 6-band parametric EQ, compressor, delay, and pan. Real-time VU metering and spectrum analysis are shown per channel. The audio mixer also supports Audio Follow Video (AFV), so audio automatically crossfades with video transitions.
Yes. Q2Q includes a local monitor output via AVAudioEngine, routable to any macOS audio output including built-in speakers, headphones, or AirPlay devices. Only the Program and Preview buses produce audible output — all other inputs are kept silent until on-air.
Yes. Media player audio is routed through the same DSP chain as NDI audio. If a media file has a non-standard audio codec and you see FigFilePlayer err=-12860 in the logs, re-encode the audio track to AAC using ffmpeg -i input.mp4 -c:v copy -c:a aac output.mp4.
Output & Streaming
Open the RTMP output panel from the menu bar or toolbar. Enter your stream URL and stream key, then click Start. Q2Q encodes program video using H.264 via VideoToolbox and audio as AAC — no external encoder needed. Any RTMP-compatible platform is supported (YouTube Live, Twitch, Facebook Live, custom RTMP servers).
Q2Q runs a TCP tally server on your local network. Compatible tally lights and controllers can connect to it and receive live Program/Preview state. Check the Devices menu for the server address and port. The protocol is compatible with standard tally light controllers that accept TCP tally data.
Q2Q can expose its program output as a virtual NDI source that other apps on the same Mac can receive — useful for routing Q2Q's composited output into video conferencing apps or other NDI-capable software without needing a second machine.
Performance
Frame drops are usually network-related. Recommended steps:

• Use wired Gigabit Ethernet instead of Wi-Fi
• Ensure your switch supports Jumbo Frames (MTU 9000) for high-bandwidth NDI
• Close apps competing for GPU or CPU resources
• Check Activity Monitor for available CPU and memory headroom
• Reduce the number of simultaneously decoded NDI sources if you are near hardware limits
Wi-Fi is not recommended for production NDI use. Full-bandwidth 1080p60 NDI requires approximately 125–140 Mbps per stream. Wi-Fi latency and packet loss will cause frame drops and audio glitches. Use wired Ethernet for all NDI sources and your production Mac.
Still need help?
Reach out and we'll get back to you.

Email Support

Send us your question and we'll respond within 1–2 business days.

[email protected]

GitHub Issues

Found a bug? Report it on GitHub and track its status publicly.

Open an issue →