-
Notifications
You must be signed in to change notification settings - Fork 0
MacOSX command line program for retrieving and updating display related settings
License
srirangav/displayutil
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
README ------ displayutil v0.4.6 Homepage: https://github.com/srirangav/displayutil About: displayutil is a command line utility for retrieving information about, enabling, or disabling, darkmode, grayscale, nightshift, and truetone on MacOS X systems. It can also retrieve and set the brightness level and resolution for some active displays, along with listing information about active displays. Usage: Brightness: displayutil [brightness|br [[all|main|dispaly id] [0.0 - 1.0]]] Darkmode: displayutil [darkmode|dm] [on|enable|off|disable] Grayscale: displayutil [grayscale|gs] [on|enable|off|disable] List Display Information: displayutil [list|ls] [-a|-l] [all|main|display id] Nightshift: Status: displayutil [nightshift|ns] [on|enable|off|disable] Schedule: displayutil [nightshift|ns] schedule [disable|sunset|[h]h:mm [h]h:mm]] Strength: displayutil [nightshift|ns] [0.0 - 1.0] Resolution: displayutil [resolution|rs] [main|display id] [[width] [height] [yes]] Truetone: displayutil [truetone|tt] [on|enable|off|disable] Build: $ ./configure $ make Install: $ ./configure $ make $ make install By default, displayutil is installed in /usr/local/bin. To install it in a different location, the alternate installation prefix can be supplied to configure as follows: $ ./configure --prefix="<prefix>" or, alternately to make as follows: $ make install PREFIX="<prefix>" For example, the following will install displayutil in /opt/local: $ make PREFIX=/opt/local install A DESTDIR can also be specified for staging purposes (with or without an alternate prefix): $ make DESTDIR="<destdir>" [PREFIX="<prefix>"] install Notes: Accessing the current nightshift setting and/or enabling or disabling nightshift is only available on MacOSX 10.12.4 and newer. Accessing the current darkmode setting and/or enabling or disabling darkmode is only available on MacOSX 10.14 and newer. Accessing the current truetone setting and/or enabling or disabling truetone has only been tested on MacOSX 11.x and newer on M1-based macs. Accessing / setting the current brightness setting has only been tested on MacOSX 11.x and newer on M1-based macs and on MacOSX 12.x on x86_64/intel. displayutil can only set the display to a resolution that the system reports as "supported". Known Bugs and Issues: Sometimes there is a delay in turning darkmode on or off and/or it takes a few tries. Enabling nightshift's sunset to sunrise mode may require location services to be enabled. History: v. 0.4.6 - add support for brightness on x86_64/intel on MacOSX 12.x (Monterey) v. 0.4.5 - list display resolution when no arguments or just a display is specified to resolution mode v. 0.4.4 - fix manpage formatting v. 0.4.3 - update Makefile to compile each source file separately, minor input validation fixes v. 0.4.2 - add extra security related compiler options, fix detection of CoreBrightness framework v. 0.4.1 - try to adopt #include/#import discipline for header files (see https://doc.cat-v.org/bell_labs/pikestyle) v. 0.4.0 - add support for setting resolutions v. 0.3.5 - switch to autoconf for configuration / build v. 0.3.4 - change verbose and extended modes for display listing to -l (long) and -a (all), respectively v. 0.3.3 - default verbose listing to show only supported resolutions for a display and add an extended mode to show all available resolutions for a display v. 0.3.2 - fixes for grayscale on MacOS X 11.x (M1) v. 0.3.1 - add support for listing all available resolutions for a display v. 0.3.0 - add support for brightness v. 0.2.0 - add support for truetone v. 0.1.0 - initial release License: See LICENSE.txt
About
MacOSX command line program for retrieving and updating display related settings