Installationsanleitung · macOS

Streame deinen Mac in jeden Browser

MoonlightWeb ist ein kostenloser Open-Source-Server (GPL-3.0), der deinen Mac auf jedes Gerät mit Browser streamt. Ein Download auf dem Mac, auf dem die Spiele laufen. Alle anderen Geräte öffnen einfach eine URL.

Was du brauchst

Installation Schritt für Schritt

Lade den Installer herunter

Hol dir das arm64 .pkg von der Releases-Seite.

Starte den geführten Installer — auf dem Mac, auf dem deine Spiele laufen

Der Einrichtungsassistent führt dich durch die Konfiguration, inklusive der optionalen Internet-Verbindung (Remote-Streaming-Sessions, standardmäßig aus). Danach läuft der Server.

Anschließend bittet macOS dich, MoonlightWeb die Bildschirmaufnahme zu erlauben — ohne sie kann dieser Mac seinen eigenen Bildschirm nicht streamen. Das ist die erste von zwei Berechtigungen, die nur du erteilen kannst; der Assistent öffnet dir den richtigen Einstellungsbereich.

Öffne einen Browser auf einem beliebigen Gerät

Auf dem Mac selbst: https://localhost. Von einem anderen Gerät in deinem Netzwerk: deine LAN-IP. Spielen von außerhalb deines Netzwerks: Schalte den Internetzugriff ein, und die App gibt dir einen Remote-Link, der direkt zu diesem Rechner führt. Du kannst auch deine eigene Domain und dein eigenes Zertifikat verwenden.

Dein Mac ist schon da

Dieser Mac steht sofort in der Liste, mit einer Karte pro Bildschirm — nichts zu koppeln, keine PIN. Andere Hosts in deinem Netzwerk (Sunshine, Wolf, MultiSeat) werden daneben per mDNS gefunden: Die koppelst du einmal — bei Sunshine, indem du die PIN, die MoonlightWeb anzeigt, auf der Weboberfläche von Sunshine eingibst — und die Kopplung bleibt für immer gespeichert.

Drück auf Play

Wähle einen Bildschirm, ein Spiel oder den ganzen Desktop. iPhone, iPad, ein anderer Laptop, ein Fernseher — alles mit Browser wird zum Client.

⬇ Für macOS herunterladen

Was du unter macOS erlauben musst

Apple lässt keinen Installer diese Berechtigungen für dich erteilen — jeder Streaming-Server unter macOS fragt nach denselben. Es sind zwei, und MoonlightWeb fragt beim ersten Start nach beiden — direkt nach der Installation, während du noch vor dem Mac sitzt:

Unterwegs fragt der Installer außerdem nach deinem Administratorpasswort (die App landet in /Applications) und auf seiner ersten Seite nach einem Erlauben für „Dieses Paket führt ein Programm aus, um festzustellen, ob die Software installiert werden kann“ — dieses Programm ist die Seite zum Internetzugang im Installer selbst. Sonst nichts: Der Installer lässt MoonlightWeb bereits durch die macOS-Firewall, daher erscheint keine Abfrage für eingehende Verbindungen, und es wird kein zweiter Streaming-Server installiert.

Einmal erteilt, dauerhaft behalten. Releases sind mit einem stabilen Zertifikat signiert, daher fragt ein Update von MoonlightWeb nicht erneut nach diesen Berechtigungen.

Stattdessen ein Befehl — und keine Warnung

MoonlightWeb ist kostenlos und Open Source, und das heißt auch: Es ist nicht mit einer kostenpflichtigen Apple Developer ID signiert. Deshalb begrüßt macOS ein heruntergeladenes .pkg mit „kann nicht geöffnet werden, da es von einem nicht verifizierten Entwickler stammt“. Diese Prüfung gilt nur für Dateien, die ein Browser heruntergeladen hat — jeder dieser beiden Befehle installiert also genau dasselbe Paket, ganz ohne Wegklicken:

brew install --cask linckosz/tap/moonlightweb
curl -fsSL https://moonlightweb.top/install.sh | bash

Beide fragen nach deinem Administratorpasswort, installieren nach /Applications und öffnen den Einrichtungsassistenten — derselbe Installer, dasselbe Ergebnis, ein Schritt weniger.

Fehlerbehebung

macOS verweigert das Öffnen des Installers: „nicht verifizierter Entwickler“

Erwartet und harmlos: Um diesen Dialog loszuwerden, braucht es eine kostenpflichtige Apple Developer ID. Nutze einen der beiden Befehle oben, dann erscheint er nie. Willst du lieber die bereits heruntergeladene Datei verwenden: Unter macOS 15 Sequoia und neuer doppelklickst du sie einmal, lässt sie abweisen, öffnest dann Systemeinstellungen → Datenschutz & Sicherheit, scrollst ganz nach unten und klickst auf Dennoch öffnen — der alte Trick mit Control-Klick → Öffnen funktioniert nicht mehr. Das Gegenstück im Terminal ist xattr -dr com.apple.quarantine ~/Downloads/moonlightweb-*.pkg.

Das Bild ist da, aber Maus und Tastatur tun nichts

Das ist die Berechtigung Bedienungshilfen: Fehlt sie, verwirft macOS eingespeiste Klicks und Tastenanschläge völlig stillschweigend. Aktiviere MoonlightWeb unter Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen, dann beende die App und öffne sie erneut.

Der Schalter ist schon aktiviert, und es geht trotzdem nicht

macOS knüpft eine Berechtigung an die Signatur einer App, nicht an ihren Namen — ein übrig gebliebener Eintrag einer älteren oder anders gebauten Kopie bleibt also aktiviert, während die laufende App abgewiesen wird. Lösch ihn im Terminal und lass die App erneut fragen:

tccutil reset ScreenCapture com.moonlightweb.server
tccutil reset Accessibility com.moonlightweb.server

Öffne MoonlightWeb erneut und aktiviere es in beiden Bereichen, sobald es dort wieder auftaucht. Bei einem Pre-Release-Build lautet die Kennung com.moonlightweb.server.dev.

Der Host erscheint nicht im Browser

Stell sicher, dass das Client-Gerät im selben Netzwerk ist wie der Mac. Der Installer lässt MoonlightWeb selbst durch die macOS-Firewall, eine Firewall eines Drittanbieters oder ein Gast-WLAN, das seine Clients voneinander isoliert, tut das aber nicht. Du kannst einen Host auch manuell per IP hinzufügen.

Spielen auf iPhone oder iPad

Öffne dieselbe URL in Safari — kein Download aus dem App Store nötig. Du bekommst ein Multitouch-Trackpad und eine native virtuelle Tastatur mit Sondertasten; ein Mac als Host empfängt keinen Controller (macOS erlaubt keinen virtuellen Controller).

Der Stream ruckelt bei schwacher Verbindung

Senk die Stream-Auflösung und aktiviere Video Enhancement: Der Stream wird auf der GPU des Clients hochskaliert und nachgeschärft (WebGL2 oder WebGPU mit SGSRv1 + FSR1), sodass ein 720p-Stream fast wie 1440p aussieht.

Restriktives Netzwerk? MoonlightWeb weicht automatisch aus (UDP → TCP) und funktioniert so auch hinter strengen Firewalls und in feindseligem Hotel-WLAN.

Weiterlesen