Ein Fork basierend auf LizardByte/Sunshine, bietet vollständige Dokumentationsunterstützung Read the Docs.
Sunshine-Foundation ist ein selbst gehosteter Game-Stream-Host für Moonlight. Diese Fork-Version hat erhebliche Verbesserungen gegenüber dem ursprünglichen Sunshine vorgenommen und konzentriert sich darauf, das Spiel-Streaming-Erlebnis für verschiedene Streaming-Endgeräte und Windows-Hosts zu verbessern:
- Laden Sie ein Windows-Installationspaket von den Foundation Sunshine Releases herunter, installieren Sie es und starten Sie Sunshine. Lesen Sie vor der Wahl einer Vorabversion die Versionshinweise.
- Öffnen Sie auf dem Host https://localhost:47990. Erstellen und sichern Sie beim ersten Start Ihre Zugangsdaten; der Browser kann vor dem lokalen selbstsignierten Zertifikat warnen.
- Fügen Sie in Sunshine eine Anwendung und in Moonlight den Host hinzu. Geben Sie anschließend die von Moonlight angezeigte PIN in Sunshine ein.
Virtuelle Displays, DualSense, USB-Weiterleitung und NVIDIA-Bildverbesserungen benötigen jeweils eigene Treiber oder Komponenten. Prüfen Sie deren Status vor der Aktivierung im Bedienfeld.
- Vollständige HDR-Pipeline-Unterstützung - Dualformat HDR10 (PQ) + HLG Kodierung mit adaptiven Metadaten für eine breitere Geräteabdeckung
- Virtuelle Anzeige - Integrierte Verwaltung von ZakoVDD-Displays; der zugehörige Treiber wird benötigt
- Entferntes Mikrofon - Unterstützt das Empfangen von Client-Mikrofonen und bietet hochwertige Sprachdurchleitung
- Erweiterte Systemsteuerung - Intuitive Web-Oberfläche zur Konfiguration mit Echtzeit-Überwachung und Verwaltung
- Niedrige Latenzübertragung - Optimierte Encoder-Verarbeitung unter Nutzung der neuesten Hardware-Fähigkeiten
- Intelligente Paarung - Intelligentes Management von Profilen für gepaarte Geräte
- Controller und Geräte - Globale und anwendungsbezogene Wahl des Gamepad-Typs, optionaler virtueller DualSense mit Audiohaptik und USB-Weiterleitung für gekoppelte Clients
- NVIDIA-Bildverbesserungen - Optionales RTX HDR und DLSS NR; DLSS NR unterstützt SDR und natives HDR sowie Umschalten und Skalieren der Verarbeitung während des Streams, sofern Hardware und Komponenten verfügbar sind
- Streamstatus - Anzeige des ausgehandelten Dolby Vision Profile 8.1 / 8.4 und des RPU-Injektionsstatus auf dem Host sowie Option, die Anwendung nach Ende der letzten Videositzung zu beenden
- Virtueller DualSense: Wählen Sie den Gamepad-Typ im Controller-Center des Bedienfelds. Installieren Sie zuvor die optionale DualSense-Komponente; Audiohaptik benötigt zusätzlich USB/IP-Transport und einen kompatiblen Client. Ist die Komponente nicht verfügbar, wird die automatische Gamepad-Auswahl verwendet.
- NVIDIA-Bildverbesserungen: Richten Sie die RTX HDR- oder DLSS NR-Komponente in der Bildverbesserungsverwaltung ein und aktivieren Sie sie für eine Anwendung. RTX HDR wandelt SDR-Eingaben in PQ HDR um; native HDR-Eingaben und HLG-Ausgaben werden nicht verarbeitet. Die Aktivierung kann bei HLG-Sitzungen die Aushandlung von Dolby Vision Profile 8.4 verhindern. DLSS NR lässt sich während eines Streams anpassen. Die Dolby Vision-Anzeige beschreibt die RPU-Injektion auf dem Host, nicht eine bestätigte Ausgabe am Client oder Display; Profile 8.4 benötigt noch eine Ende-zu-Ende-Prüfung auf einem Gerät.
- USB-Weiterleitung: Auf dem Windows-Host muss die USB-Weiterleitung aktiviert und eine funktionsfähige USB/IP-Transportkomponente vorhanden sein, bevor gekoppelte Clients die Weiterleitung zur Laufzeit konfigurieren können.
Dual-Format HDR-Kodierung: HDR10 (PQ) + HLG Parallelunterstützung
Herkömmliche Streaming-Lösungen unterstützen nur HDR10 (PQ) mit absoluter Luminanzzuordnung, was erfordert, dass das Client-Display die EOTF-Parameter und Spitzenhelligkeit der Quelle genau reproduziert. Wenn die Fähigkeiten des Empfangsgeräts unzureichend sind oder die Helligkeitsparameter nicht übereinstimmen, treten Tone-Mapping-Artefakte wie abgeschnittene Schatten und überbelichtete Lichter auf.
Foundation Sunshine führt HLG-Unterstützung (Hybrid Log-Gamma, ITU-R BT.2100) auf der Kodierungsebene ein. Dieser Standard verwendet eine relative Luminanzzuordnung mit folgenden technischen Vorteilen:
- Szenenreferenzierte Luminanzanpassung: HLG verwendet eine relative Luminanzkurve, die es dem Display ermöglicht, automatisch Tone Mapping basierend auf seiner eigenen Spitzenhelligkeit durchzuführen — die Erhaltung von Schattendetails auf Geräten mit niedriger Helligkeit ist PQ deutlich überlegen
- Sanfter Highlight-Roll-Off: Die hybride Log-Gamma-Transferfunktion von HLG bietet einen graduellen Roll-Off in Highlight-Bereichen und vermeidet die Banding-Artefakte, die durch hartes Clipping bei PQ verursacht werden
- Native SDR-Abwärtskompatibilität: HLG-Signale können von SDR-Displays direkt als Standard-BT.709-Inhalt dekodiert werden, ohne zusätzliches Tone Mapping
Einzelbild-Luminanzanalyse und adaptive Metadatengenerierung
Die Kodierungspipeline integriert ein Echtzeit-Luminanzanalysemodul auf der GPU-Seite, das über Compute Shader für jedes Einzelbild folgende Operationen ausführt:
- MaxFALL / MaxCLL Einzelbild-Berechnung: Echtzeit-Berechnung des maximalen Inhaltslichtpegels (MaxCLL) und des maximalen durchschnittlichen Bildlichtpegels (MaxFALL) auf Einzelbildebene, dynamisch in HEVC/AV1 SEI/OBU-Metadaten injiziert
- Robuste Ausreißerfilterung: Perzentilbasierte Abschneidestrategie zur Eliminierung extremer Luminanzpixel (z.B. Spiegelreflexionen), um zu verhindern, dass isolierte Leuchtpunkte die globale Luminanzreferenz anheben und zu einer allgemeinen Bildverdunkelung führen
- Interframe-Exponentialglättung: EMA-Filterung (Exponentieller gleitender Durchschnitt) auf Luminanzstatistiken über aufeinanderfolgende Frames, zur Beseitigung von Helligkeitsflimmern durch abrupte Metadatenänderungen bei Szenenwechseln
Vollständige HDR-Metadaten-Durchleitung
Unterstützt die vollständige Durchleitung von statischen HDR10-Metadaten (Mastering Display Info + Content Light Level), dynamischen HDR Vivid-Metadaten und HLG-Transfercharakteristik-Kennungen. Dies stellt sicher, dass die von NVENC / AMF / QSV-Encodern ausgegebenen Bitstreams vollständige Farbvolumen- und Luminanzinformationen gemäß der CTA-861-Spezifikation enthalten, sodass Client-Decoder die HDR-Absicht der Quelle präzise reproduzieren können.
- Dynamische Erstellung und Entfernung virtueller Displays
- Unterstützung für benutzerdefinierte Auflösungen und Bildwiederholraten
- Verwaltung von Mehrfachanzeigekonfigurationen
- Echtzeit-Konfigurationsänderungen ohne Neustart
Für das beste Streaming-Erlebnis wird die Verwendung der folgenden optimierten Moonlight-Clients empfohlen (aktiviert Set-Boni):
Warning
Diese Tabellen werden kontinuierlich aktualisiert. Bitte kaufen Sie Hardware nicht nur basierend auf diesen Informationen.
| Komponente | Anforderung |
|---|---|
| GPU | AMD: VCE 1.0 oder höher, siehe: obs-amd Hardware-Unterstützung |
| Intel: VAAPI-kompatibel, siehe: VAAPI Hardware-Unterstützung | |
| Nvidia: Grafikkarte mit NVENC-Unterstützung, siehe: NVENC-Unterstützungsmatrix | |
| CPU | AMD: Ryzen 3 oder höher |
| Intel: Core i3 oder höher | |
| RAM | 4GB oder mehr |
| Betriebssystem | Windows: 10 22H2+ (Windows Server unterstützt keine virtuellen Gamepads) |
| macOS: 12+ | |
| Linux/Debian: 12+ (bookworm) | |
| Linux/Fedora: 39+ | |
| Linux/Ubuntu: 22.04+ (jammy) | |
| Netzwerk | Host: 5GHz, 802.11ac |
| Client: 5GHz, 802.11ac |
| Komponente | Anforderung |
|---|---|
| GPU | AMD: Video Coding Engine 3.1 oder höher |
| Intel: HD Graphics 510 oder höher | |
| Nvidia: GeForce GTX 1080 oder höhere Modelle mit mehreren Encodern | |
| CPU | AMD: Ryzen 5 oder höher |
| Intel: Core i5 oder höher | |
| Netzwerk | Host: CAT5e Ethernet oder besser |
| Client: CAT5e Ethernet oder besser |
Lösungsweg bei Problemen:
- Konsultieren Sie die Nutzungsdokumentation LizardByte-Dokumentation
- Aktivieren Sie den detaillierten Log-Level in den Einstellungen, um relevante Informationen zu finden
- Treten Sie der QQ-Gruppe bei, um Hilfe zu erhalten
- Benutze zwei Buchstaben!
Problemrückmeldung-Labels:
hdr-support- Probleme im Zusammenhang mit HDRvirtual-display- Probleme mit virtuellen Displaysconfig-help- Probleme im Zusammenhang mit der Konfiguration
- Build-Anleitung - Anleitung zum Kompilieren und Erstellen des Projekts
- Konfigurationshandbuch - Erläuterung der Laufzeit-Konfigurationsoptionen
- WebUI-Entwicklung - Vollständige Anleitung zur Entwicklung der Vue 3 + Vite Web-Oberfläche
Wir begrüßen die Teilnahme an Diskussionen und Code-Beiträgen!
Foundation Sunshine Edition - Macht Game-Streaming eleganter