A macOS menu bar app that mirrors a resizable region of your screen into a standalone window. Share that one window in a meeting, then drag any app into the region to put it on the call, without ever re-picking the share target.
Google Meet, Slack and Microsoft Teams can share a whole display or a single window, never an arbitrary rectangle. Virtual Display supplies the missing rectangle, as an ordinary window that all of them can share. Zoom has Share > Advanced > Portion of Screen built in, which covers a one-off share inside Zoom.
- Region presets, an aspect lock and a region that can follow the focused window
- Drawing over the region, and click highlights the meeting can see
- Hidden apps: notification banners and chosen apps never reach the share
- Screenshots and recording of exactly what the meeting sees
- Global shortcuts that need no Accessibility permission
- A token-gated URL scheme that drives every command from a script or a Stream Deck
- Lua plugins that add commands, menu items and overlays
Requires macOS 14 or later. Releases are universal binaries covering both Apple Silicon and Intel.
brew install --cask rapatao/tap/virtual-displayThe cask clears the quarantine flag on install, so the app launches without a Gatekeeper
detour. Upgrade with brew upgrade --cask virtual-display, remove with
brew uninstall --cask virtual-display, and brew uninstall --zap --cask virtual-display
to also delete saved preferences.
The package lives in the rapatao NUR repository
as nur.repos.rapatao.virtual-display, or straight from that repository:
nix profile install github:rapatao/nur-packages#virtual-displayIt installs VirtualDisplay.app under the profile's Applications directory. Nix does
not quarantine what it fetches, so the app launches without the Gatekeeper detour.
Download VirtualDisplay.zip from the Releases page, unzip, and move
VirtualDisplay.app to /Applications. Unless the release was notarized, macOS
quarantines it and refuses to open it. Clear the flag once:
xattr -d com.apple.quarantine /Applications/VirtualDisplay.appTo build it yourself instead, see DEVELOPMENT.md.
- Click the menu bar icon and enable Mirroring. Grant Screen Recording if asked, then reopen the app.
- Position the red region frame over the part of the screen you want to share. Drag from anywhere inside it, resize from any edge.
- Turn Edit Region off. The frame turns green and becomes click-through, so windows underneath stay usable.
- In your meeting pick Share > Window > Virtual Display. The output window opens automatically with mirroring. It can sit behind everything else or be dragged mostly off the edge of the display, and the meeting still gets the full picture; keep some of it on screen and never minimise it. Settings > Output > Open the output window off screen does that for you, leaving only a corner showing at the bottom right.
- Drag any window into the region. It is now on the call.
| Page | Covers |
|---|---|
| Usage | The menu, shortcuts, drawing, captures, presets, follow mode, hidden apps, behaviour notes |
| Configuration | The settings window, output size, config.json, saved state |
| Automation | The virtualdisplay:// commands and the automation token |
| Plugins | The Lua vd API, overlays, HTTP |
| Troubleshooting | Shortcuts, permissions, the app missing from a share picker |
Working examples live in examples/.
- Building from source, code layout, signing a local build: DEVELOPMENT.md
- Tagging a version, CI secrets, the Homebrew tap: RELEASING.md
Copyright (C) 2026 Luiz Henrique Rapatao.
GNU General Public License v3.0 or later. See LICENSE.
Forks and derivative works must ship their source under the same license. Note that the Mac App Store's terms are incompatible with the GPL, so a GPL-licensed build cannot be distributed there.