Monitor control mac os
MonitorControl — Now with Apple Silicon support
Control your external display brightness and volume
Use menulet sliders or the native Apple keyboard keys
Behaves like native, with (optional) brightness & volume OSD
Go to Releases and download the latest .dmg
| MonitorControl version | macOS version |
|---|---|
| v4.0.0 | Catalina 10.15* |
| v3.1.1 | Mojave 10.14 |
| v2.1.0 | Sierra 10.12 |
* With some limitations — full functionality available on macOS 11 Big Sur or newer.
Open issues if you have a question, an enhancement to suggest or a bug you’ve found. If you want you can fork the code yourself and submit a pull request to improve the app.
MonitorControl supports localization. We gladly welcome your contribution with a new language! See the opening post of the relevant discussion on how to add your translation!
- Xcode
- Swiftlint
- SwiftFormat
- BartyCrouch (for updating localizations)
Clone the project via this Terminal command:
If you want to clone one of the branches, add —single-branch —branch [branchname] after the clone option.
You’re all set ! Now open the MonitorControl.xcodeproj with Xcode! The dependencies will automatically get downloaded once you open the project. If they don’t:
File > Packages > Resolve Package Versions
Third party dependencies
- @mathew-kurian (original developer)
- @Tyilo (fork)
- @Bensge — (used some code from his project NativeDisplayBrightness)
- @nhurden (for the original MediaKeyTap)
- @kfix (for ddcctl)
- @reitermarkus (for DDC.Swift)
- @zhuowei (figured out M1 I²C communication)
- @tao-j (figured out M1 I²C write)
- @alin23 (generally spearheaded M1 DDC support and figured out a many of the caveats)
- javierocasio (app icon background)
About
🖥 Control your external monitor brightness & volume on your Mac
Источник
Monitor control mac os
ddcctl: DDC monitor controls for the OSX command line
Adjust your external monitors’ built-in controls from the OSX shell:
And possibly (if your monitor firmware is well implemented):
- input source
- built-in speaker volume
- on/off/standby
- rgb colors
- color presets
- reset
This is a GPLv3 open source repo and you may use it in the ways that license allows.
It is not a Community «Free Software» Project — its decidedly my personal utility and its in the (dreaded/loved) «maintenance mode».
To be blunt, if you have issues with your macOS, Macintosh (not hackintosh), and DDC-controlled monitor(s), then its up to you to debug them and (optionally) PR your fixes (see bottom section) if you’d like to share them.
I don’t have the time currently to triage new Issues and help with the non-bugs being reported, and don’t intend to moderate a support or discussion forum here.
Option 1: Install via Homebrew
Open a terminal window and run $ brew install ddcctl .
Option 2: Download Binaries
Head to Releases and from the latest release download ddcctl_binaries.zip archive
Option 3: Build from Source
Run ddcctl -h for some options.
ddcctl.sh is a script I use to control two PC monitors plugged into my Mac Mini.
You can point Alfred, ControlPlane, or Karabiner at it to quickly switch presets.
When setting input source, refer to the table below to determine which value to use.
For example, to set your first display to HDMI: ddcctl -d 1 -i 17 .
| Input Source | Value |
|---|---|
| VGA-1 | 1 |
| VGA-2 | 2 |
| DVI-1 | 3 |
| DVI-2 | 4 |
| Composite video 1 | 5 |
| Composite video 2 | 6 |
| S-Video-1 | 7 |
| S-Video-2 | 8 |
| Tuner-1 | 9 |
| Tuner-2 | 10 |
| Tuner-3 | 11 |
| Component video (YPrPb/YCrCb) 1 | 12 |
| Component video (YPrPb/YCrCb) 2 | 13 |
| Component video (YPrPb/YCrCb) 3 | 14 |
| DisplayPort-1 | 15 |
| DisplayPort-2 | 16 |
| HDMI-1 | 17 |
| HDMI-2 | 18 |
| USB-C | 27 |
ddcctl.m sprang from a forum thread on the TonyMac-x86 boards.
DDC.c originated from jontaylor/DDC-CI-Tools-for-OS-X, but was reworked by others on the forums.
A few forks have also backported patches, which is nice 👌 .
bug-fix & non-bug-fix/feature PRs have the same broad guidelines:
- well described as to the universal utility of the change for the (presumed) majority of users / developers
- also helpful: a positive proof that the change doesn’t detract from the usability for the majority of users
- easy to test
- provide your test procedure, if you have one!
- keep in mind my verification is always manual — I don’t have a CI system wired up to a bank of real Macs & monitors
As to additional criteria for new-features, please understand that ddcctl currently does what I need it to do on my own all-Apple fleet.
There is a backlog of some (broadly desirable) features that came from reported issues. PRs are encouraged to address these!
I’m not really interested in adding any features that I have no ability or desire to support on my own hardware.
Unfortunately, I cannot make a time-to-review estimation — but the simpler/cleaner a PR is, the the faster its likely to get reviewed & merged.
About
DDC monitor controls (brightness) for Mac OSX command line
Источник
Monitor control mac os
JoniVR released this Oct 7, 2021
Changes compared to v4.0.0-beta1:
Enhancements
- Added Internet Access Policy
- Don’t relinquish control over brightness keys with no external display connected if fine brightness OSD scale is active
- Changed icon order in menu (when icon mode is enabled)
- Gear shape icon is used for preferences + stands a little bit apart to help user focus.
- Changed default to a minimum software dimming of 15% for safety reasons.
- Added advanced option to enable zero brightness with software dimming.
- Added ‘Avoid gamma table manipulation’ option for coexistence with f.lux.
- Set relevant options to disabled when keyboard control is disabled.
- Added Command + Q shortcut in menu when it is in standard text mode (not icon mode).
- Made preferences more spacious + more room for verbose languages
Updated translations:
- English — base language
- Chinese (Traditional, Taiwan) — thanks to @stiiveo, @dororojames
- Dutch — thanks to @JoniVR
- French — thanks to @the0neyouseek
- German — thanks to @jajoho
- Hungarian — thanks to @waydabber
- Italian — thanks to @picov
- Korean — thanks to @zzulu
- Turkish — thanks to @mennan
Under the hood changes & fixes
- Register DDC command touched status. When write on startup enabled, apply only touched command values.
- Reorganised PrefKey list to be less confusing.
- Disengage custom shortcut keyboard after 100 key repeat to prevent possibly endless loop if keyUp event never arrives due to any circumstance.
- Fixed text for external display brightness control keyboard shortcut.
- Fix cumulative darkening bug upon toggling ‘Disable dimming as fallback’.
- Make sure that key repeat speed for custom shortcuts do not go below a certain threshold.
- Fixes text clipping issues for various languages
- Added beta channel update backend
- Fixed layout issue at brightness custom shortcuts.
- Fixed custom key shortcuts going runaway when menu was opened during a key repeat streak.
Known issues
- Some preference panes may not fit to low resolution screens (1280×800 or less) in Advanced mode.
Notes
- This is a beta release. If you encounter any issues, you can try the last stable release v3.1.1 or the previous beta.
- If you are new to v4.0.0, please take a look at the changelog of v4.0.0-beta1 for the list of major new features!
- If you discover issues, make sure to report them in the linked release discussion or in a new issue.
- If you want to help translating, see #637
- Thanks to everyone who helps make MonitorControl better!
JoniVR released this Sep 30, 2021
Enhancements
- Automatic & manual updates through the app, no more manual downloads 🎉
- Added proper support for controlling Apple displays.
- Added option to show/hide brightness slider.
- Added option to show brightness slider for internal display and apple displays (enabled by default).
- Replication of built-in and Apple display brightness to corresponding brightness slider.
- Added suffix to similarly named displays for better differentiation.
- Option to disable slider snapping for finer control + disable slider snapping by default.
- Added option to show slider tick marks for better accuracy.
- Added option to use window focus instead of mouse to determine which display to control.
- control + command + brightness now controls external displays only ( control + Brightness continues to control internal display only)
- Added separate tab for menu options.
- Added option to restore last saved values upon startup.
- Added option for audio device name matching for display volume control selection.
- Separated option to change all screens for brightness and volume.
- Added option for keyboard fine scale for brightness.
- Added option for keyboard fine scale for volume.
- Added version check upon startup for mandatory preferences reset upon downgrade or incompatible previous version + notification about this.
- Added implementation for command + f1 macOS shortcut to enable/disable mirroring.
- Added safer ‘Assume last saved settings are valid’ option as default instead of startup DDC read (or restore).
- Streamlined preference panes, ‘Show advanced settings’ now affect all tabs. This leads to a better and safer first timer experience (especially because of the influx of many new features).
- Added a Quit button to Preferences if menu is hidden (it was not passible to quit the application until this time in this mode only by re-enabling the menu).
- Lowered default first-run volume DDC default from 75% to 15% if read is not possible or disabled to prevent unexpectedly loud sound.
- Added slider skew setting on a per control basis to have the ability to manipulate DDC slider balance and OSD scale if display control is not linear.
- Added the ability to set min. and max. DDC bounds on a per display, per control basis.
- Audio device name override option for a display (manually assign a specific audio device to a display).
- Advanced setting to invert DDC control range (some displays have the scale reversed).
- Advanced setting to remap DDC control code (some displays have contrast and brightness mixed up).
- Ability to mark a DDC control as available or unavailable in advanced settings under Displays.
- Ability to automatically hide menu icon if there is no slider present in the menu.
- Option to show slider percentage for more precision.
- Option to set combined or separate OSD scale when combined hardware+software brightness is used.
- Apple like smooth brightness change (both for software, hardware, mixed and DisplayServices).
- Added support for DisplayLink, AirPlay, Sidecar, screen sharing etc. using window shades (this is an inferior technique to the existing software implementation — gamma control — but still better than nothing). Disabled for any kind of mirroring setups. 1
- Brightness change synchronisation from Built-In and Apple displays to other displays. This makes Touch Bar, Ambient light sensor, Control Center and System Preferences induced changes affect all displays. Synchronisation uses a sophisticated indirect delta method + the user can intervene and adjust individual screen brightness at any time to easily compensate mismatching native brightness levels.
- Preferences pane tab selector has a simpler look on Catalina.
- All menu sliders are now scrollable using a magic mouse/trackpad swipes or mouse wheel.
- Added option for menu to show only items that are relevant to display which shows the menu currently.
- Added option to enable combined sliders (note: this option combined with enabled Apple/built-in display syncing and enabled ‘change all’ keyboard settings finally provides full synchronised control of all displays).
- Combined sliders can now display multiple displays when keyboard and brightness syncing is not enabled. 1
- Redesigned sliders to look like Big Sur/Monterey Control Center’s sliders. 1
- Quit and Preferences. are now icons for a much cleaner look. 1
- Added option to change additional menu options style or hide them. 1
- Multiple displays are now in nice Big Sur styled blocks — no more ugly separators. 1
- Added customisable gamma/ddc switchover point for combined brightness in the advanced section of Displays.
- Added comma separated list for control code override to enable edge cases like controlling Brightness and Contrast at the same time (use VCP list entry 10, 12 for that)
- Contrast can now be controlled from keyboard via control + option + command + brightness up/down .
- Custom keyboard shortcuts for brightness, contrast, volume and mute
Other under the hood changes and bug fixes
- Standardised internal scale among various displays and DDC ranges for ranged controls.
- Uses the new internal scale for combined hardware-software brightness mode.
- Migrated scales to internal float representation to prevent loss of fine detail on transformations.
- Fixed double sound when muting multiple external displays at the same time.
- Fixed lack of initial volume configuration if slider is not shown in menu.
- Fixed wrong settings being applied to a display when replaced on Apple Silicon (UserDefaults preferences are now tied to specific display strings instead of CGDirectDisplayID — which is no longer semi-unique on arm64).
- A lot of refactoring, streamlining and general optimisations.
Known issues with this release
Note: these issues are already fixed in the master branch and will be fixed in the upcoming version.
- Translations to languages other than English are incomplete.
- Displays tab in Preferences might have graphical corruptions with certain languages.
- Custom brightness shortcut record intrface may appear misaligned.
- ‘Quit application’ button has wrong spelling when the Quit menu option is not visible.
- Register DDC command touched status. When write on startup enabled, apply only touched command values.
Disengage custom shortcut keyboard after 100 key repeat to prevent possibly endless loop if keyUp event never arrives due to any circumstance. - External display brightness control keyboard shortcut is incorrectly displayed as control + option + brightness key instead of control + command + brightness key .
- Cumulative darkening happens when toggling ‘Disable dimming as fallback’ if software dimming is engage. You need to restart the app to rectify this.
- Custom key shortcuts may go runaway when menu is opened during a custom shortcut key-repeat streak.
- When Apply last saved values to the display is enabled, a DDC contrast of 100% will be applied erroneously if the user never changed the contrast setting before.
Notes
- This is a beta release. If you encounter any issues, you can try the last stable release v3.1.1.
- Once again, @waydabber did a fantastic job on this release!
- Because of the sheer size of the update, translations need to be updated again, please help out here if you can!
- If you discover issues, make sure to report them in the linked release discussion.
- Happy testing 😄
-
Only on Big Sur and above ↩ ↩ 2 ↩ 3 ↩ 4 ↩ 5 ↩ 6
Источник
