PreviewMonitor docs
Getting Started

Install on macOS

Install the PreviewMonitor .pkg on macOS — the Gatekeeper block and how to get past it, the admin password, the firewall prompt, and manual removal.

Download PreviewMonitor-<version>.pkg from the download page and install it. Three things will surprise you if nobody warns you first: Gatekeeper blocks the package, macOS asks for your admin password, and Premiere Pro raises an unexplained network prompt the first time you stream. All three are covered below.

Check your Mac first. The 0.2.0 build is Intel-only and requires macOS 15 or newer. On an Apple Silicon Mac — anything from late 2020 onward — the package installs without complaint but the plugin never appears in Premiere Pro, because Premiere Pro runs natively as arm64 and cannot load an Intel plugin. The same is true on macOS 12, 13 and 14.

Check yours under → About This Mac. If Chip reads Apple M-anything, this build will not work for you yet. See Requirements.

Install it

Gatekeeper blocks it — open it anyway

The package is not signed and not notarized. Double-clicking it gets you a refusal along the lines of "PreviewMonitor-<version>.pkg cannot be opened because it is from an unidentified developer" rather than an installer.

To get past it, right-click (or Control-click) the .pkg in Finder and choose Open, then click Open in the confirmation dialog. That is the same file, opened through a path that records your explicit consent.

macOS Gatekeeper dialog refusing to open the PreviewMonitor package because it is from an unidentified developer

Double-clicking produces this. Right-click → Open produces a dialog with an Open button instead.

If your Mac still refuses, open System Settings → Privacy & Security, scroll to the Security section, and click Open Anyway next to the message about the blocked package. Then run it again.

Signing and notarization are planned. Until they ship, this prompt is expected on every fresh download.

Enter your admin password

The installer writes into /Library, so macOS asks for an administrator password (or Touch ID).

This is a system-wide install by necessity, not by preference: Premiere Pro scans only the machine-wide Control Surface folder, never the per-user one, so the transport plugin has to live under /Library to be found at all.

Finish and restart Premiere Pro

Adobe hosts scan for plugins once, at launch.

Unlike the Windows installer, the .pkg does not force Premiere Pro closed and will happily install underneath a running copy — in which case the old plugin (or no plugin) stays loaded until you quit and reopen the app. If PreviewMonitor is not in the device list, this is almost always why.

Allow incoming network connections

The first time Premiere Pro actually streams, macOS raises:

Do you want the application "Adobe Premiere Pro" to accept incoming network connections?

Click Allow.

macOS firewall dialog asking whether Adobe Premiere Pro should be allowed to accept incoming network connections, with Deny and Allow buttons

The dialog names Adobe Premiere Pro, not PreviewMonitor — the plugin runs inside Premiere Pro's process, so that is the app macOS is asking about.

This prompt is unexplained by design constraint, not by choice: nothing in the installer or the plugin touches the macOS firewall, so there is no way to pre-authorize it the way the Windows installer does. Click Deny — or dismiss it and forget about it — and your iPhone will never find the host. It looks exactly like a discovery failure.

If you already clicked Deny, fix it in System Settings → Network → Firewall → Options: find Adobe Premiere Pro in the list and set it to Allow incoming connections. After Effects needs the same treatment separately.

What gets installed

BundleDestinationWhat it does
PremiereLive.bundle/Library/Application Support/Adobe/Common/Plug-ins/7.0/MediaCore/The Mercury Transmit device — the video and audio stream itself
PremiereLiveCtrl.bundle/Library/Application Support/Adobe/Common/Plug-ins/ControlSurface/The Control Surface plugin — lets the phone's transport bar drive Premiere Pro's playhead

The bundle names still carry the internal engineering name PremiereLive. Adobe loads plugins by filename; the device you actually see in Premiere Pro is named PreviewMonitor.

The After Effects transport plugin does not exist on macOS at all — it is a Windows-only build. After Effects on a Mac still gets the live picture from PremiereLive.bundle exactly as Premiere Pro does; only transport control is affected. See Enable in After Effects.

Uninstalling

The .pkg ships no uninstaller. Removal is manual.

Quit Premiere Pro and After Effects, then delete the two bundles:

sudo rm -rf "/Library/Application Support/Adobe/Common/Plug-ins/7.0/MediaCore/PremiereLive.bundle"
sudo rm -rf "/Library/Application Support/Adobe/Common/Plug-ins/ControlSurface/PremiereLiveCtrl.bundle"

Optionally, forget the package receipt so macOS no longer reports it as installed:

sudo pkgutil --forget com.premierelive.pkg

Neither step touches your own data. The device identity and the list of trusted iPhones live in ~/Library/Application Support/PremiereLive/; delete that folder too if you want a genuinely clean slate. See Reset and reinstall.

There is no macOS log file to clean up — the plugin logs to the unified system log rather than to disk. See Logs and diagnostics.

Next

Enable the device in Premiere Pro.

Last updated on