Frequently asked questions

1. Make sure Host is running (menu bar icon). 2. Make sure both devices are on the same network (same Wi-Fi, LAN, or Thunderbolt). 3. Check the firewall allows WisBridge Host to accept incoming connections. 4. A VPN can interfere — try turning it off or use a manual IP. 5. macOS: allow Local Network for WisBridge in System Settings → Privacy & Security → Local Network, then reopen WisBridge. 6. iOS: allow Local Network for WisBridge.

Check that Host is powered on, online, and WisBridge Host is running. Wake the controlled Mac, check Wi-Fi/Ethernet, or switch links. With Thunderbolt, make sure Thunderbolt Bridge is enabled in network settings.

Restart Host. Also check that the firewall allows WisBridge Host to accept incoming connections.

Click Refresh Routes in the Control Center, pick an available link (marked “current” or “recommended”) from the list, and confirm before switching.

Use Refresh Routes to pick the correct Thunderbolt address, or enter the right IP manually. If it still fails, restart Host and try again.

Known issue: connecting to a headless Mac over Thunderbolt can get stuck on the preparing screen. Restart Host; if it doesn't recover, reinstall Host and try again.

Switch to Easy display mode to prioritize smoothness. If possible, use a wired (Ethernet / Thunderbolt) connection.

1. Keep the default quality settings — all modes are optimized for smoothness. 2. Switch to Easy mode (Control Center → Easy). 3. Check the Wi-Fi signal or use a wired connection. 4. Make sure Screen Recording and Accessibility permissions are complete on Host.

Switch to Pro or Max mode after connecting; if it's still soft, reconnect once to let the picture re-optimize.

Switch to Easy mode or reconnect. If the headless virtual display fails, restart Host.

Reconnect, or switch to Easy mode.

Reconnect the display, or switch display modes.

Known issue: after auto-reconnect on a dropped link, or after manually selecting a route, the picture may not auto-fill the screen. Workaround: switch desktops left or right once (Control + ← / →, local Mac desktop switching); the system will automatically fill the screen with the Host picture.

On the controlled Mac, check Accessibility under System Settings → Privacy & Security. If it still fails, remove and re-add WisBridge Host, grant access again, then restart it. Make sure WisBridge Host is installed inside the Applications folder, not run from a quarantined location.

Fn+Option combinations are local WisBridge shortcuts (screenshot / recording / PiP) and need the WisBridge window focused. Mission Control / Launchpad: use Option+↑ / Option+↓. PiP shortcut: Fn+Option+F6; if it doesn't respond, use the Control Center button.

Update to the latest version. In newer versions, the mouse wheel is forwarded as remote scrolling while the PiP is locked.

Use Fn+Option+Space.

1. Make sure Host audio capture is working; if there's still no sound after video appears, reconnect or restart Host. 2. Check whether WisBridge has Local Mute or Listen Here Only enabled. 3. Check the controlled Mac's volume and audio devices. 4. If it's a MacBook with the lid closed, that's a known situation (see System & devices).

Use a faster link (wired), or lower the display mode (Easy).

Wait for it to recover or reconnect; if it keeps failing, please report the error.

After the trial, you still get 15 minutes of Lite free usage every day. Buy or subscribe to Lite or Pro to unlock full access (one-time or subscription). Check your status in the license panel (Cmd+L).

Lite connects to 1 Host at a time; Pro connects to 3. Close other Host sessions, or upgrade to Pro.

These are Pro-only features: multiple Hosts (up to 3), interactive PiP (clicking/typing inside PiP), MOV recording, and the iOS multi-PiP overview. Lite includes 1 Host, PiP viewing only, and the same high-fidelity system audio as Pro. These being unavailable is an expected license difference - they unlock automatically when you upgrade. During the 7-day trial you get full access.

Check your network and App Store account, then try again later (applies to both one-time and subscription purchases).

Restoring only brings back access you already own — it never charges you again, so it's safe to tap even if you've already bought or subscribed. License panel → Restore Purchases, using the same Apple ID (works for one-time purchases and subscriptions still within their active period). If a subscription has lapsed, resubscribe to renew; manage or cancel subscriptions in the license panel / App Store.

Have you switched Apple IDs? Entitlements follow the Apple ID used at purchase; if the current account isn't the purchasing one (changed, shared, or a different account after a reset), you'll see a downgrade (back to Lite / trial) or the app may be unusable. Fix: sign out in App Store and sign back into the original purchasing Apple ID, then use Restore Purchases in the license panel. Your subscription may have expired (subscriptions and one-time purchases are separate). Cross-platform use requires the same Apple ID. Refresh entitlements or restore purchases in the license panel.

First check what you bought: Lite comes as a one-time purchase or a monthly / yearly subscription. If it's a subscription, when it lapses you go back to the 15-minute daily free allowance — that's expected, and renewing restores access. If it's a one-time purchase but still shows expired: have you switched Apple IDs? Entitlements follow the Apple ID used at purchase; switching accounts shows up as expired or back to trial. Fix: sign out in App Store and sign back into the original purchasing Apple ID, then use Restore Purchases in the license panel. Also refresh entitlements / restore purchases, and note cross-platform use requires the same Apple ID (Universal Purchase).

The license panel loads in-app products (Lite / Pro one-time and subscription options) from the App Store. If they won't load, the App Store product catalog is temporarily unavailable — this does not mean WisBridge is missing from the App Store. Check your network and try again later.

System Settings → Privacy & Security → Screen Recording → check WisBridge Host → restart Host.

System Settings → Privacy & Security → Accessibility → check WisBridge Host. Without it, the mouse can move but clicks and keyboard input won't work.

File transfer window: click Grant Folder Access… in the WisBridge pane and allow the folder you need. For other file writes, choose a writable folder or grant file/folder access in System Settings.

System Settings → Privacy & Security → Automation, allow WisBridge Host to control Finder. Without it, received files are saved to the Desktop instead — the feature still works.

Local Network permission was declined. Restore it: System Settings → Privacy & Security → Local Network → check WisBridge, then restart WisBridge.

iOS Settings → Privacy & Security → Local Network → enable WisBridge. Make sure iOS and the Host are on the same network.

Known situation: closing the lid can lock the controlled Mac and mute audio. Fix: avoid sleep when the lid is closed, or use an external display.

Adjust power settings in System Settings to avoid sleep during a remote session; Host resumes capture automatically after wake.

Update to the latest version; if it happens again, copy diagnostic logs and report it.

Keep only one copy in the Applications folder.

Update both WisBridge and WisBridge Host to the latest version.

Reconnect, then send again.

Try a different folder, and check space and permissions.

WisBridge runs in a protected environment, so grant folder access first: 1) the first time, choose Home or a specific folder in the Allow Folder Access panel; 2) or click Grant Folder Access… to add one manually; 3) access is remembered and restores automatically.

If a destination was specified, files go there. Otherwise, Host tries the folder of the frontmost Finder window; if there's no Finder window, files go to the Desktop.

A conflict dialog appears: Keep Both (saves with a “ copy” suffix), Replace (overwrites, backed up first if enabled), Stop (stops the remaining transfer), Apply to All (applies to all remaining conflicts).

Copy again, or use file transfer instead.

Update to the latest version. The new version no longer reads your device clipboard in the background — text is only sent explicitly via the “Send Text to Mac Clipboard” shortcut.

Automatic: menu bar menu → Automatically Install Updates (on by default). Manual: Host status window → Update.

Check your network; if needed, download the installer from our website and install manually.

That's normal — Host restarts automatically after the update; just reconnect.

Check the iOS Local Network permission. Make sure iOS and the Host are on the same network. You can also connect by entering the IP manually.

Update to the latest version; the new version limits scrolling/zooming to the originally selected area.

Known issue in old versions; updating to the latest version fixes it.

Not yet — saving templates is a planned feature.

There's no “clear” button yet; it's a planned feature.

Yes, rotation is supported (90° left).