Do I need to change anything on my Mac?
Turn on Screen Sharing (System Settings → General → Sharing) and run the connector command. That's the whole setup. No kernel extensions, no accessibility permissions, no menu-bar apps.
Does it work outside my home network?
Yes — that's the point. The Mac and the browser each make an outbound connection to the relay on Cloudflare's edge network, so it works across any two networks that can reach the internet, NAT and hotel Wi-Fi included.
Can I just type an IP address instead of running the connector?
Yes — the viewer has "connect by address". Our edge opens a TCP connection to that address's VNC port and bridges it to your browser, so nothing runs on the Mac. It only works when the Mac is reachable from the internet (a public IP or a router port-forward on 5900–5999); Tailscale and LAN addresses are invisible from the edge — use the connector for those.
I already use Tailscale — do I need your relay?
No. Run the connector with --listen 5800 --no-relay and it serves the viewer from your Mac itself, bridging directly to Screen Sharing. Open http://<tailscale-ip>:5800 from any device on your tailnet and every byte stays inside it — the relay is never in the path.
What happens if someone gets my pairing code?
They reach a login prompt. The code only routes to your Mac; getting in still requires your macOS username and password, verified by macOS itself. Treat the code like your home address, not like your keys.
Is my screen content encrypted?
Both legs are TLS-encrypted (HTTPS/WSS): browser to relay, and relay to your Mac. Login credentials are additionally encrypted end-to-end, so they are never visible to the relay even in transit. Full end-to-end encryption of screen pixels is on the roadmap.
Can I use it from my phone?
Yes — the viewer has a trackpad mode built for touch: one finger moves the pointer with acceleration, tap clicks, two fingers scroll, pinch zooms, and there's an on-screen keyboard plus one-tap Mac shortcuts like Mission Control and Spotlight. A native iOS and Android app is also in the works.
Can I control my Mac from my iPhone or Android phone?
Yes. Open the viewer in Safari or Chrome, type your pairing code, and your phone becomes a trackpad for the Mac — tap to click, two fingers to scroll, pinch to zoom, with an on-screen keyboard. A native iOS and Android app is coming — join the waitlist.
How can I control a Mac remotely?
Turn on Screen Sharing on the Mac (System Settings → General → Sharing), run the one-line connector command in Terminal, then open the viewer on any device and enter the pairing code it prints. Sign in with the Mac's username and password and you have full mouse and keyboard control.
I ran the command and got “command not found: node”. Now what?
That Mac has no Node.js installed — macOS doesn't ship it. Install Node 21 or newer from nodejs.org (or run brew install node), then run the same command again. The curl half already worked, so mrc.mjs is sitting in whichever folder Terminal was in — from there, node mrc.mjs is enough.
The viewer says “Nothing is listening”. What does that mean?
The connector reached the relay, but the Mac refused its own Screen Sharing connection on port 5900 — almost always because Screen Sharing is off. Turn it on in System Settings → General → Sharing, then reconnect. You don't need to restart the connector: it opens that connection fresh for each viewer.
Why isn't my Mac allowing screen sharing?
Check three things: Screen Sharing is on in System Settings → General → Sharing; your user is in its allowed-users list; and Remote Management (which replaces Screen Sharing) isn't enabled at the same time. If the connector says port 5900 is unreachable, one of those three is almost always the cause.
Can a Mac be accessed remotely when it's not on the same network?
Yes — that's what the pairing-code relay is for. The Mac and your browser each dial out to the relay, so it works across different networks, NAT, and firewalls with no port forwarding. Same Wi-Fi, different country — the session looks identical.
Can you unlock a MacBook remotely?
Yes. Apple's Screen Sharing works at the macOS login screen, so you can connect to a locked (but awake) Mac and type the password remotely to sign in. A Mac that's asleep or shut down can't be woken over the internet by the connector alone.
Do I need an account?
No — connecting with a pairing code or an address works without one. A free account adds a dashboard of saved Macs, so your machines and their addresses are one click away from any browser you sign in on.