Native macOS menu bar control for external-monitor brightness, warmth, contrast, volume, input source, presets, and schedules—with DDC/CI hardware control and software fallback.

Dimmerly brings controls that are usually buried in the monitor OSD or split across System Settings into one native menu bar app.

Download latest release · Install with Homebrew · View screenshots · Changelog

brew tap olujicz/dimmerly
brew install --cask dimmerly

• Control multiple displays from a single menu bar panel
• Use real DDC/CI hardware controls where the monitor and connection support them
• Keep settings private and local, with no analytics or tracking

• Per-display brightness, warmth, contrast, and blanking controls
• Built-in display support where macOS exposes the needed controls
• Presets for saving and restoring complete display setups
• Global keyboard shortcuts for dimming and presets
• Schedules based on a fixed time, sunrise, or sunset
• Desktop widgets and Shortcuts actions
• Optional automatic color temperature changes
• Optional auto-dim after inactivity
• VoiceOver labels and Reduce Motion support

• macOS 15 Sequoia or later
• Optional Accessibility permission for global shortcuts
• Optional Location permission for sunrise and sunset schedules
• Optional DDC/CI-capable external monitor for hardware controls

brew tap olujicz/dimmerly
brew install --cask dimmerly

The Homebrew cask installs the signed and notarized direct-download build with the full feature set.

Download the latest signed and notarized DMG from GitHub Releases.

This is the recommended build when you want DDC/CI hardware controls and display sleep.

The repository also includes a sandboxed App Store configuration. See Build Differences for its capabilities.

See BUILDING.md for Xcode requirements, build configurations, test commands, and architecture notes.

Use the direct-download build if you want the hardware monitor controls. Use the sandboxed build when App Store distribution or sandboxing matters more.

Open Dimmerly from the menu bar to adjust each display. The main slider controls brightness. Expand a display row for warmth, contrast, and, when available, DDC/CI controls such as volume or input source.

If a display shows the hardware indicator, Dimmerly is talking to it through DDC/CI. Otherwise the app uses software dimming for that display.

Presets save the current display setup: brightness, warmth, and contrast for each display. They can be applied from the menu bar, widgets, Shortcuts, schedules, or per-preset keyboard shortcuts.

Schedules can run at a fixed time, at sunrise, at sunset, or with an offset from sunrise or sunset. Sunrise and sunset schedules can use your current location or manually entered coordinates.

The direct-download build can put displays to sleep. Dim-only mode keeps the session visible but darkened, which is useful when you want quick wake behavior without display sleep.

Wake behavior can be configured for:

• keyboard, click, scroll, or mouse movement
• keyboard, click, or scroll when mouse movement is ignored
• Escape only for stricter dismissal

Animated transitions respect the macOS Reduce Motion setting.

Dimmerly includes Shortcuts actions for setting brightness, warmth, and contrast, sleeping displays, toggling dimming, and applying presets.

It also includes small and medium desktop widgets for quick dimming and preset access.

• Hardware monitor controls require a DDC/CI-capable display and connection. Some hubs, docks, KVMs, HDMI adapters, DisplayLink adapters, and built-in HDMI ports can block DDC/CI commands even when the monitor supports them.
• Monitor support varies by manufacturer and model. Some displays expose only brightness, while others also expose contrast, volume, mute, or input switching.
• Global keyboard shortcuts require Accessibility permission from macOS.
• Sunrise and sunset schedules need Location permission unless you enter a manual coordinate.
• Dimmerly stores settings locally and does not sync presets or schedules between Macs.

Dimmerly does not collect analytics, usage data, crash reports, or personal data.

Settings are stored locally with UserDefaults. If you use current location for sunrise and sunset schedules, macOS Location Services provides the coordinate used for the calculation. Dimmerly does not send that coordinate to a developer-owned service.

Read the full Privacy Policy.

If a display does not show the hardware indicator, Dimmerly is using software dimming for that display. Software dimming changes perceived brightness, not the monitor backlight.

Common reasons DDC/CI is unavailable:

• the monitor does not support DDC/CI
• DDC/CI is disabled in the monitor's on-screen menu
• a USB-C hub, dock, KVM, HDMI adapter, or DisplayLink adapter blocks DDC commands
• the display is connected through built-in HDMI on some Apple Silicon Macs

Try connecting the monitor directly over USB-C or DisplayPort and check the monitor's settings for DDC/CI support.

Global shortcuts require Accessibility permission:

System Settings -> Privacy & Security -> Accessibility

After granting permission, restart Dimmerly. If the shortcut still does not work, choose a shortcut that is not already reserved by macOS or another app.

Open Settings and adjust the dimming wake behavior. Enable "Ignore mouse movement" if small pointer movement wakes the displays, or enable Escape-only dismissal for stricter control.

• Report a bug
• Report a monitor compatibility issue
• Review recent changes

Dimmerly is a Swift 6 macOS project with a single third-party runtime dependency: MenuBarExtraAccess (MIT). See NOTICES.md for its license text.

Useful commands:

just setup
just format-check
just lint
just test
just build-release

Project documentation:

• BUILDING.md - local build, test, and architecture notes
• documentation/RELEASE.md - release process for signed and notarized builds
• documentation/REPOSITORY_SETTINGS.md - required GitHub repository settings
• SECURITY.md - supported versions and vulnerability reporting

Bug reports, focused fixes, and well-scoped feature proposals are welcome.

Before opening a pull request:

1. Run just setup once to enable the local pre-commit hooks.
2. Keep changes focused.
3. Add or update tests for behavior changes.
4. Run just format-check, just lint, and just test.
5. Update CHANGELOG.md when the change affects users.

Read CONTRIBUTING.md and CODE_OF_CONDUCT.md before participating.

Security vulnerabilities should not be reported in public issues. Follow SECURITY.md.

Dimmerly is released under the MIT License. See LICENSE. Third-party software notices are listed in NOTICES.md.