Illuminate

Problem

Auf einem MacBook Pro mit Liquid-Retina-XDR-Display begrenzt macOS normale Desktop-Inhalte auf 500–600 Nits, obwohl das Panel im Vollbild dauerhaft 1000 Nits schafft.

Lösung

Illuminate fordert beim WindowServer EDR-Headroom an und hebt SDR-Inhalte hinein, um bis zu das Doppelte des aktuellen SDR-Weiß. Der Boost folgt dem Helligkeitsregler des Systems und bleibt bei 60 % des verfügbaren Headrooms gedeckelt.

Die Entscheidung: zwei Techniken

• Overlay (Standard): ein klickdurchlässiges Fenster pro Display mit einem CAMetalLayer im erweiterten Farbraum und Multiply-Filter. Stürzt die App ab, verschwindet das Fenster mit ihr; es bleibt kein Systemzustand zurück.
• Gamma-Tabelle: skaliert die erfasste Transfertabelle des Displays, sodass die Kalibrierung erhalten bleibt. Farben bleiben exakt, HDR-Video clippt dafür. Auf M5 Pro und M5 Max ist die Technik deaktiviert, weil macOS dort Gamma-Tabellen ignoriert.

Robustheit

Ein Zustandsautomat pro Display wartet auf Headroom, bevor er Verstärkung anlegt; ein Display, das EDR verweigert, beeinflusst kein anderes. Der Boost pausiert bei Bildschirmschoner, Sperrbildschirm, Ruhezustand sowie auf Akku unter 20 % und im Stromsparmodus. Die Gamma-Tabelle wird beim Beenden, bei Signalen und nach einem Absturz beim nächsten Start wiederhergestellt.

Die Kernlogik liegt in einem eigenen Modul ohne AppKit und ist vollständig mit Unit-Tests abgedeckt.