vMix Integration

Send live captions to vMix for broadcast productions.

Overview

Send real-time captions to vMix for broadcast productions. Maestra runs on the same computer as vMix and sends your live captions into a vMix title input.

Before you start

Use Google Chrome and keep it updated to the latest version.
Make sure vMix is running and the vMix Web Controller is enabled.
Open Maestra in the same browser, on the same machine as vMix.

How to set up

You must be running vMix on the same computer that Maestra Live is running on.
Download this title template that will display captions in vMix. Import this title template into vMix by going to Add Input > Title/XAML. In the upper right of the Input Select window, click Browse... and select the title template file you downloaded. Click OK.
In vMix, go to Settings > Web Controller and check the box to enable web controller.
Set the port or accept the default.
Copy the "vMix Web Site Address" and paste it into Maestra.
Optionally, download the Maestra Companion App for a more seamless experience. Once installed and running, enable it in the vMix channel settings, refresh the page, and enjoy captions in vMix.

Troubleshooting

If captions are not reaching vMix from your Maestra real-time session, work through this checklist in order. Each step rules out a common cause, from Web Controller settings and Chrome network permissions to firewalls, ports, and the vMix caption template. Stop as soon as captions start updating on screen.

Checklist

Confirm the basics

Run the vMix Web Controller on the same machine as the browser using Maestra.
Ensure the channel points to the correct vMix URL (default http://localhost:8088) and the caption title or template GUID matches.

Review the Web Controller security options

Keep Allow software on this computer access without login checked.
Leave Enable enhanced security on Web and TCP API unchecked.
Leave Restrict access to LAN only unchecked.

Enable local network access in Chrome

Visit chrome://settings/content/all, then search and select live.maestra.ai (or use the padlock, then Site settings).
Set Local network access to Allow, reload Maestra, and retry.

Check network reachability

On that machine, open the Web Controller URL (for example http://localhost:8088) in any browser.
If it fails to load or is sluggish, fix that first: start vMix, correct the port, and unblock firewalls.

Try a different port

If 8088 keeps failing, change the vMix Web Controller to an unused high port (for example 2025), update the URL in Maestra, and retest.
This often bypasses corporate security filters or stale listeners tied to common ports.

Rule out corporate or VPN blocks

Temporarily disconnect VPNs, endpoint firewalls, or antivirus that may forbid HTTPS pages from reaching http://localhost.
If captions start working, whitelist vMix and the browser, then re-enable the security tools.

Validate the vMix template

In Title Designer, ensure the WebCaptionerCaptions field exists and the GUID matches the Maestra settings.
Manually edit the field in vMix to confirm it updates on screen.

Inspect the browser

Open DevTools, then the Network tab, enable the channel, and watch the SetText request.
Note whether the browser flags Mixed Content, Private Network Access, or CORS, or if the request never leaves.

Address mixed-content or private network warnings

Chrome, Edge, or Brave: disable chrome://flags/#block-insecure-private-network-requests, then restart.
Safari: toggle Develop, then Disable Cross-Origin Restrictions during testing.
Firefox: set network.websocket.allowInsecureFromHTTPS to true and ensure HTTPS-only mode is off.

Monitor results

Keep DevTools open while captions run. If requests look successful but text does not update, capture screenshots of the Network entry and the vMix preview.
Collect the timestamp, browser version, operating system, and any console errors before escalating to support.

Still stuck?

If captions still do not update after this checklist, open the support widget in the app and click Create a Ticket. Please include the timestamp, your browser version, operating system, vMix version, and any console errors.