{"id":13493313,"url":"https://github.com/kfix/ddcctl","last_synced_at":"2025-05-15T03:05:05.489Z","repository":{"id":19259020,"uuid":"22494900","full_name":"kfix/ddcctl","owner":"kfix","description":"DDC monitor controls (brightness) for Mac OSX command line","archived":false,"fork":false,"pushed_at":"2022-11-29T07:39:32.000Z","size":146,"stargazers_count":1905,"open_issues_count":32,"forks_count":152,"subscribers_count":42,"default_branch":"main","last_synced_at":"2025-04-14T00:59:56.167Z","etag":null,"topics":["ddc","macos","monitor","osx"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kfix.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-08-01T04:11:33.000Z","updated_at":"2025-04-12T21:43:44.000Z","dependencies_parsed_at":"2023-01-13T20:16:00.413Z","dependency_job_id":null,"html_url":"https://github.com/kfix/ddcctl","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfix%2Fddcctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfix%2Fddcctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfix%2Fddcctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kfix%2Fddcctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kfix","download_url":"https://codeload.github.com/kfix/ddcctl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248804790,"owners_count":21164132,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ddc","macos","monitor","osx"],"created_at":"2024-07-31T19:01:14.111Z","updated_at":"2025-04-14T01:00:06.309Z","avatar_url":"https://github.com/kfix.png","language":"C","readme":"# ddcctl: DDC monitor controls for the OSX command line #\nAdjust your external monitors' built-in controls from the OSX shell:\n\n* brightness\n* contrast\n\nAnd *possibly* (if your monitor firmware is well implemented):\n\n* input source\n* built-in speaker volume\n* rgb colors\n* color presets\n* reset\n\n# Project Status #\nThis is a GPLv3 open source repo and you may use it in the ways that license allows.  \n\nIt is not a Community \"Free Software\" Project - its decidedly my personal utility and its in the (dreaded/loved) _\"maintenance mode\"_.\n\n# Reporting issues #\nTo 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.  \n\nI 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.  \n\n# Installation #\n\n## Option 1: Install via Homebrew ##\nOpen a terminal window and run `$ brew install ddcctl`.\n\n## Option 2: Download Binaries ##\nHead to [Releases](https://github.com/kfix/ddcctl/releases) and from the\n[latest release](https://github.com/kfix/ddcctl/releases/latest) download\n[`ddcctl_binaries.zip`](https://github.com/kfix/ddcctl/releases/latest/download/ddcctl_binaries.zip)\narchive\n\n## Option 3: Build from Source ##\n* install Xcode\n* run `make`\n\n# Usage #\nRun `ddcctl -h` for some options.  \n[ddcctl.sh](/scripts/ddcctl.sh) is a script I use to control two PC monitors plugged into my Mac Mini.  \nYou can point Alfred, ControlPlane, or Karabiner at it to quickly switch presets.\n\n# Input Sources #\nWhen setting input source, refer to the table below to determine which value to use.  \nFor example, to set your first display to HDMI: `ddcctl -d 1 -i 17`.\n\n| Input Source | Value        |\n| ------------- |-------------|\n| VGA-1 | 1 |\n| VGA-2 | 2 |\n| DVI-1 | 3 |\n| DVI-2 | 4 |\n| Composite video 1 | 5 |\n| Composite video 2 | 6 |\n| S-Video-1 | 7 |\n| S-Video-2 | 8 |\n| Tuner-1 | 9 |\n| Tuner-2 | 10 |\n| Tuner-3 | 11 |\n| Component video (YPrPb/YCrCb) 1 | 12 |\n| Component video (YPrPb/YCrCb) 2 | 13 |\n| Component video (YPrPb/YCrCb) 3 | 14 |\n| DisplayPort-1 | 15 |\n| DisplayPort-2 | 16 |\n| HDMI-1 | 17 |\n| HDMI-2 | 18 |\n| USB-C | 27 |\n\n# Credits #\n`ddcctl.m` sprang from a [forum thread](https://www.tonymacx86.com/threads/controlling-your-monitor-with-osx-ddc-panel.90077/page-6#post-795208) on the TonyMac-x86 boards.\n\n`DDC.c` originated from [jontaylor/DDC-CI-Tools-for-OS-X](https://github.com/jontaylor/DDC-CI-Tools-for-OS-X), but was reworked by others on the forums.  \n\nA few forks have also backported patches, which is *nice* :ok_hand:.\n\n# Contributing PRs #\n\nbug-fix \u0026 non-bug-fix/feature PRs have the same broad guidelines:\n* well described as to the universal utility of the change for the (presumed) majority of users / developers\n  * also helpful: a positive proof that the change doesn't detract from the usability for the majority of users\n* easy to test\n  * provide _your_ test procedure, if you have one!\n  * keep in mind my verification is always manual - I don't have a CI system wired up to a bank of real Macs \u0026 monitors\n\nAs to additional criteria for new-features, please understand that `ddcctl` currently does what _I need it to do_ on my own all-Apple fleet.\n\nThere is a [backlog](https://github.com/kfix/ddcctl/projects/1) of some (broadly desirable) features that came from reported issues. PRs are encouraged to address these!  \n\nI'm not really interested in adding any features that I have no ability or desire to support on my own hardware.  \n\nUnfortunately, I cannot make a time-to-review estimation - but the simpler/cleaner a PR is, the the faster its likely to get reviewed \u0026 merged.\n","funding_links":[],"categories":["C"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkfix%2Fddcctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkfix%2Fddcctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkfix%2Fddcctl/lists"}