Skip to content

Darkroom4364/BetterMonitor

Repository files navigation

App icon

BetterMonitor

Control your external display brightness, volume and contrast with native OSD support. Use menubar sliders, keyboard shortcuts, or the CLI for automation.

Download for macOS



latest version license platform

Screenshot


Features

  • Brightness, volume & contrast control for external displays via DDC
  • Native OSD β€” shows the system brightness/volume overlay
  • CLI tool (bettermonitor) for scripted and automated control
  • Multiple protocols β€” DDC for external displays, native Apple protocol for built-in displays, gamma/shade for virtual screens
  • Smooth transitions and combined hardware + software dimming (dim beyond your display's minimum)
  • Brightness sync β€” replicate ambient light sensor changes from built-in displays to externals
  • Keyboard shortcuts β€” Apple media keys and custom shortcuts
  • Dozens of settings β€” enable Show advanced settings to fine-tune for your hardware
  • Free and open source

Screenshots

Screenshot Screenshot Screenshot Screenshot

Install

Download the latest .dmg from Releases.

CLI

BetterMonitor includes a command-line tool for automation:

# List all displays
bettermonitor list

# Get/set brightness
bettermonitor get brightness
bettermonitor set brightness 70

# JSON output
bettermonitor list --json

The CLI communicates with the running BetterMonitor app β€” make sure it's open.

Getting started

  1. Download and copy BetterMonitor to your Applications folder
  2. Launch the app
  3. Grant Accessibility access when prompted (required for keyboard brightness/media keys)
  4. Use your keyboard or the menubar sliders to control displays
  5. Open Settings for customization (enable Show advanced settings for more options)

Supported displays

  • DDC displays β€” most modern LCDs from all major manufacturers via USB-C, DisplayPort, HDMI, DVI
  • Apple & built-in displays β€” native protocol support
  • TVs β€” supported via software dimming (most TVs don't implement DDC)
  • DisplayLink, AirPlay, Sidecar β€” shade (overlay) control

Known limitations:

  • Built-in HDMI on Apple Silicon Macs does not support DDC. Use USB-C or a Thunderbolt dock instead.
  • EIZO displays using MCCS over USB are limited to software dimming.
  • DisplayLink docks do not support DDC on macOS.

macOS compatibility

BetterMonitor macOS
Latest Catalina 10.15+ (full features on Big Sur 11+)

Build from source

Requirements: Xcode, SwiftLint, SwiftFormat, BartyCrouch

git clone https://github.com/Darkroom4364/BetterMonitor.git
cd BetterMonitor
open BetterMonitor.xcodeproj

Dependencies resolve automatically via SPM.

Dependencies

Credits

BetterMonitor is a fork of MonitorControl with added CLI support, automation features, and active development.

Original MonitorControl contributors:

License

MIT

About

πŸ–₯ Control your display's brightness & volume on your Mac. Fork with CLI tool, macOS 26 brightness HUD, and automation support.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors