Vagalume: regel de helderheid van al je schermen op macOS (open source)

Neto Pompeu —

Helderheid op een Mac is lastiger dan het lijkt

Op macOS lijkt helderheid aanpassen triviaal: twee toetsen en klaar. In werkelijkheid valt die ervaring uit elkaar zodra je een extern scherm aansluit of een MacBook Pro met XDR-paneel hebt.

  • De F1/F2-toetsen regelen alleen het ingebouwde scherm. Sluit een externe monitor aan en ze doen er niets mee.
  • Externe schermen hebben geen native helderheidsregeling op macOS. Je bent aangewezen op de fysieke knoppen (OSD) van de monitor.
  • Op MacBook Pro Liquid Retina XDR-panelen begrenst macOS de SDR-helderheid tot ~500 nits, terwijl het paneel veel hoger kan.

Om dit op te lossen zonder ballast (geen profielen, geen cloud-account, geen abonnement) bouwden we Vagalume — een kleine, gratis, open-source app in je menubalk.

Wat Vagalume doet

  • Een globale schuif voor alle schermen, plus een schuif per scherm.
  • DDC/CI-hardwareregeling van externe monitoren: Vagalume praat rechtstreeks met de monitor via de I2C-bus om de echte helderheid in te stellen.
  • Software-dimming als terugval wanneer DDC niet beschikbaar is (docks, adapters, sommige monitoren).
  • Sub-zero-modus: ga onder het hardwareminimum voor nachtelijke sessies, zonder een volledig zwart scherm.
  • XDR Boost (experimenteel): voorbij Apple's limiet van ~500 nits op XDR-panelen, via een EDR-overlay in multiply-compositing die de kleuren behoudt (zwart blijft zwart, kleurverhoudingen blijven behouden).
  • Ondersteuning voor de zon- / F1-F2-toetsen, met Option + pijltjes als terugval.
  • Nits-schattingen per scherm, live detectie van aangesloten/losgekoppelde schermen en automatische updates.

De technische stack

Vagalume is een 100% native app, gebouwd om licht te blijven (~80 MB RAM, 0% CPU in rust):

  • Swift + SwiftUI met MenuBarExtra voor de menubalk-UI, zonder Dock-icoon.
  • IOKit / I2C om DDC/CI-commando's naar externe monitoren te sturen (lezen en schrijven van de helderheids-VCP op de echte schaal van de monitor — geen vaste 0–100-schaal).
  • AppleSiliconDDC voor betrouwbare DDC-detectie op Apple Silicon.
  • Metal + EDR (CAMetalLayer, wantsExtendedDynamicRangeContent, multiply-compositing) voor XDR Boost — dezelfde techniek als Lunar of Vivid, maar met behoud van kleurnauwkeurigheid.
  • DisplayServices (privé-framework) om het ingebouwde scherm soepel aan te sturen, zonder de lelijke stap bij 20%.
  • Sparkle voor ondertekende automatische updates, gedistribueerd via GitHub Releases.
  • Een build die ondertekend is met Developer ID en genotariseerd door Apple, zodat hij opent zonder Gatekeeper-waarschuwing.

De helderheidslogica (clamping, dim-curves, nits-schattingen, DDC-schaal) is gedekt door unit-tests om visuele regressies te voorkomen.

Waarom open source

Vagalume verzamelt geen gegevens: geen analytics, geen telemetrie, geen account. De code is open (MIT-licentie), want een app die de aansturing van je scherm op laag niveau raakt, verdient het om controleerbaar te zijn. Het is ook onze manier, bij Primo Studio, om iets terug te geven aan de gemeenschap van tools die we elke dag vanuit het Amazonegebied gebruiken.

Downloaden

Vagalume is gratis, ondertekend en genotariseerd. Download de nieuwste versie, pak hem uit, sleep Vagalume.app naar /Applications en start hem.

Vereist macOS 14 (Sonoma) of nieuwer, op een Apple Silicon-Mac.