Vagalume: controle o brilho de todas as suas telas no macOS (open source)

Neto Pompeu —

O brilho no Mac é mais complicado do que parece

No macOS, ajustar o brilho parece trivial: duas teclas e pronto. Na prática, assim que você conecta um monitor externo ou tem um MacBook Pro com tela XDR, a experiência desmorona.

  • As teclas F1/F2 só controlam a tela integrada. Conecte um monitor externo e elas não fazem nada nele.
  • Monitores externos não têm controle de brilho nativo no macOS. Você fica preso aos botões físicos (OSD) do monitor.
  • Nos MacBook Pro com tela Liquid Retina XDR, o macOS limita o brilho SDR a ~500 nits, mesmo que a tela possa ir bem mais alto.

Para resolver isso sem complicação (sem perfis, sem conta na nuvem, sem assinatura), criamos o Vagalume — um app pequeno, gratuito e open source, que fica na barra de menus.

O que o Vagalume faz

  • Um controle global para todas as telas, e um controle por tela.
  • Controle de hardware via DDC/CI dos monitores externos: o Vagalume fala diretamente com o monitor pelo barramento I2C para ajustar o brilho real.
  • Escurecimento por software como alternativa quando o DDC não está disponível (docks, adaptadores, alguns monitores).
  • Modo sub-zero: descer abaixo do mínimo do hardware para sessões noturnas, sem deixar a tela totalmente preta.
  • Boost XDR (experimental): ultrapassar o limite de ~500 nits da Apple nas telas XDR, com um overlay EDR em composição multiply que preserva as cores (os pretos continuam pretos, as proporções de cor são mantidas).
  • Suporte às teclas de sol / F1-F2, com alternativa Option + setas.
  • Estimativa de nits por tela, detecção em tempo real de telas conectadas/desconectadas e atualizações automáticas.

A stack técnica

O Vagalume é um app 100% nativo, feito para ser leve (~80 MB de RAM, 0% de CPU em repouso):

  • Swift + SwiftUI com MenuBarExtra para a interface na barra de menus, sem ícone no Dock.
  • IOKit / I2C para enviar comandos DDC/CI aos monitores externos (lendo e escrevendo o VCP de brilho na escala real do monitor — não uma escala fixa de 0–100).
  • AppleSiliconDDC para a detecção DDC confiável em chips Apple Silicon.
  • Metal + EDR (CAMetalLayer, wantsExtendedDynamicRangeContent, composição multiply) para o Boost XDR — a mesma técnica do Lunar ou do Vivid, mas preservando a fidelidade das cores.
  • DisplayServices (framework privado) para controlar a tela integrada de forma suave, sem o degrau feio nos 20%.
  • Sparkle para atualizações automáticas assinadas, distribuídas via GitHub Releases.
  • Um build assinado com Developer ID e notarizado pela Apple, então abre sem aviso do Gatekeeper.

A lógica de brilho (clamp, curvas de escurecimento, estimativa de nits, escala DDC) é coberta por testes unitários para evitar regressões visuais.

Por que open source

O Vagalume não coleta dados: sem analytics, sem telemetria, sem conta. O código é aberto (licença MIT) porque um app que mexe no controle de baixo nível da sua tela merece ser auditável. É também a nossa forma, na Primo Studio, de retribuir à comunidade das ferramentas que usamos todos os dias a partir da Amazônia.

Baixar

O Vagalume é gratuito, assinado e notarizado. Baixe a versão mais recente, descompacte, arraste o Vagalume.app para /Applications e abra.

Requer macOS 14 (Sonoma) ou mais recente, em um Mac Apple Silicon.