https://github.com/srirangav/displayutil

MacOSX command line program for retrieving and updating display related settings
https://github.com/srirangav/displayutil

cli display display-manager displays macos

Last synced: 12 months ago
JSON representation

MacOSX command line program for retrieving and updating display related settings

• Host: GitHub
• URL: https://github.com/srirangav/displayutil
• Owner: srirangav
• License: mit
• Created: 2021-04-05T07:28:28.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2023-09-30T09:04:08.000Z (almost 3 years ago)
• Last Synced: 2025-04-13T01:51:36.837Z (about 1 year ago)
• Topics: cli, display, display-manager, displays, macos
• Language: Objective-C
• Homepage:
• Size: 535 KB
• Stars: 7
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.txt
  • License: LICENSE.txt

Awesome Lists containing this project

README

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

    or, alternately to make as follows:

        $ make install 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="" [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