brightness

{
  "aliases": [],
  "alternatives": [],
  "build_dependencies": [],
  "categories": [],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Change macOS display brightness from the command-line",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:35:59+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "brightness",
  "github_default_branch": "master",
  "github_last_commit_at": "2024-03-05T20:05:24Z",
  "github_readme_excerpt": "brightness\n==========\n\nCommand-line display brightness control for macOS.\n\nThis tool enables you to set and obtain the brightness level of all\ninternal and certain external displays from the command line or a\nscript.\n\n\u003ctable\u003e\u003ctr\u003e\u003cth\u003e If you cannot control your display\u2019s brightness from\nDisplays System Preferences, you will not be able to do it with\n\u003ctt\u003ebrightness\u003c/tt\u003e. See \u003ca\nhref=\"https://github.com/nriley/brightness/issues/11\"\u003ethis issue\u003c/a\u003e\nfor more information and some potential other options.\n\u003c/th\u003e\u003c/tr\u003e\u003c/table\u003e\n\nInstall with Homebrew\n--------------------\n\n```brew install brightness```\n\nInstall From Source\n------------------\n\n```shell\ngit clone https://github.com/nriley/brightness.git\ncd brightness\nmake\nsudo make install\n```\n\nmacOS Version Support\n---------------------\n\n`brightness` requires OS X/macOS 10.8 or later \u2014\u00a0but go back in the\ncommit history and you\u2019ll find code compatible with older (Mac) OS X\nversions.\n\nThrough macOS 10.12.3, `brightness` uses documented APIs.  It works on\ninternal laptop displays.  It doesn\u2019t work on older Apple external\nLCDs which connect via DVI and USB.  I don\u2019t know if it works on newer\nexternal displays, such as Thunderbolt displays, because I don\u2019t have\nany to test with.  (Feedback welcome.)\n\nAs of macOS 10.12.4 with the introduction of Night Shift, the\ndocumented APIs fail to work correctly and Apple does not provide\nreplacement APIs.  Therefore, `brightness` uses an [undocumented\nmethod](https://github.com/nriley/brightness/issues/21) to adjust\nbrightness.\n\nmacOS 11 on M1/Apple Silicon Macs require yet another [undocumented\nmethod](https://github.com/nriley/brightness/pull/36) to adjust\nbrightness (thanks to @jtbandes).\n\nUsage Examples\n--------------\n\nSet 100% brightness: ```brightness 1```\n\nSet 50% brightness: ```brightness 0.5```\n\nShow current brightness: ```brightness -l```\n\n````\n% brightness\nusage: brightness [-m|-d display] [-v] \u003cbrightness\u003e\n   or: brightness -l [-v]\n% brightness -lv\ndisplay 0: main, active, awake, onli",
  "github_repo": "nriley/brightness",
  "github_stars": 658,
  "github_topics": [],
  "homepage": "https://github.com/nriley/brightness",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 351,
  "installs_365d": 3562,
  "installs_90d": 1124,
  "keg_only": 0,
  "keg_only_reason": null,
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "BSD-2-Clause",
  "llm_generated_at": null,
  "llm_model": null,
  "name": "brightness",
  "oldnames": [],
  "one_liner": null,
  "optional_dependencies": [],
  "rank_30d": 2067,
  "rank_365d": 2261,
  "rank_90d": 2085,
  "raw_hash": "40f8aec9ec13efe3",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/b/brightness.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": "HEAD",
  "version_stable": "1.2",
  "versioned_formulae": [],
  "why_use_this": null
}