Skip to content

kfix/ddcctl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

98 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ddcctl: DDC monitor controls for the OSX command line

Adjust your external monitors' built-in controls from the OSX shell:

  • brightness
  • contrast

And possibly (if your monitor firmware is well implemented):

  • input source
  • built-in speaker volume
  • rgb colors
  • color presets
  • reset

Project Status

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".

Reporting issues

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.

Installation

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

  • install Xcode
  • run make

Usage

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.

Input Sources

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

Credits

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 👌.

Contributing PRs

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.