Install guide · macOS

Stream your Mac to any browser

MoonlightWeb is a free, open-source (GPL-3.0) server that streams your Sunshine machine to any device with a browser. One download on the Mac that runs the games. Every other device just opens a URL.

What you need

Installation, step by step

Download the installer

Grab the arm64 .pkg from the releases page.

Run the guided installer — on the Mac that runs your games

The setup wizard walks you through the configuration, including optional one-click Internet access (personal sub-domain, free TLS certificate, UPnP port mapping). When it finishes, the server is running.

Open a browser on any device

On the Mac itself: https://localhost. From another device on your network: your LAN IP. From anywhere: your personal sub-domain (https://you.moonlightweb.top) if you enabled Internet access.

Pair once with a PIN

Your Sunshine hosts are already listed — discovered automatically on the LAN via mDNS. Enter the PIN Sunshine displays, and the pairing is remembered forever.

Press play

Pick a game or the full desktop. iPhone, iPad, another laptop, a TV — anything with a browser becomes a client.

⬇ Download for macOS

Troubleshooting

The host doesn't appear in the browser

Make sure the client device is on the same network as the Mac, and that macOS allowed incoming connections for MoonlightWeb when prompted. You can also add a host manually by IP.

Playing on iPhone or iPad

Open the same URL in Safari — no App Store download needed. You get a multi-touch trackpad, a native virtual keyboard with modifier keys, and full game-controller support with rumble.

Stream feels choppy on a weak connection

Lower the streamed resolution and enable Video Enhancement: the stream is upscaled and sharpened on the client's GPU (WebGPU running SGSRv1 + FSR1), so a 720p stream looks close to 1440p.

Restrictive network? MoonlightWeb falls back automatically (UDP → TCP → WSS), so it keeps working through strict firewalls and hostile hotel Wi-Fi.

Keep reading