-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.txt
155 lines (103 loc) · 4.17 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
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