aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 69d6d6d795dfe61de60fd7ae2fbfb77c7481c8ce (plain) (blame)
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
NAME
	radharc - Reduce eye strain and improve sleep.

PRONUNCIATION
	ɹˈaɪɐrk (depending on dialect)

SYNOPSIS
	radharc [OPTIONS]...

	The -l option is mandatory, unless single value -t is used.

OPTIONS
	-l LATITUDE:LONGITUDE
		Tell radharc where you are. This is mandatory.
		The values are measured in degrees and in the
		GPS (you probably do not have too care about that,
		the differences between the systems should not
		be significant another), and must be in decimal.

		Reminder for Americans (particularly US Americans),
		you are an the western hemisphere, not the eastern,
		thus your longtiude is negative. If you experience
		weird colour temperatures, 100 % of the times it is
		because you forgot the minus sign. But no need to
		feel stupid, it is a really common mistake.

		No complicated stuff please, only latitudes within
		±90° and longitudes within ±180°. No unit thought.

	-t DAY:NIGHT
		Select colour temperature to use during full daytime
		and full night. This should be a integer. Do not
		include the unit (the 'K'). The temperatures must
		be at least 1000 K.

	-t TEMPERATURE
		Select temperature to use. The program will exit
		when it is done setting the temperature. The
		natural colour temperature is 6500 K ('-t 6500').
		The temperature must be at least 1000 K.

	-t +DELTA
		Increase the colour temperature by DELTA kelvin.

	-t -DELTA
		Decrease the colour temperature by DELTA kelvin.

	-T TEMPERATURE
		Temperature that shall be used when the program
		is disabled (via SIGUSR1).

	-p	Print the current status.

	-n	Set the temperature immediately, do not transition.

	-N	Do not transition when exiting, disabling, or
		reenabling.

	-o	Set the colour, and exit.

	-x	Ignore the current calibrations on the monitors.

	-s SECONDS
		The start and exit transitions shall take SECONDS
		seconds. This may be a floating point number, with
		an explicit unit.

	-S KELVINS
		The transitions speed, in kelvin per second.
		This most be a positive integer.

	-i
		Apply negative image filter. Radharc will detect
		which monitors have this one when it starts.

	-h PATHNAME
		Use a hook script for events.

	-b
		Broadcast events with bus.

	-d SERVER=DISPLAY
		Use the display server whose identifier is
		DISPLAY and whose identifier is stored in the
		environment variable SERVER, for example
		-d DISPLAY=:0 for the X display :0.

	-d SYSTEM
		Use a subsystem which does not have identifiers.
		For example drm for the Direct Rendering Manager.

	-e EDID
		Select monitor to use by its EDID.

	-m NUM
		Select monitor to use by its global index.

	-m SCREEN:NUM
		Select monitor to use by its index without
		a screen or graphic card. The later is for when
		not inside a graphics environment.

SIGNALS
	SIGHUP
		Perform an online update to a newer version.

	SIGUSR1
		Enable or disable radharc.

	SIGUSR2
		Toggle negative image filter. Enable on all
		monitors if it is enable on some but not all.

	SIGRTMIN+N
		Toggle negative image on monitor N, if monitors
		have been selected manually, it will be in the
		order they where selected.

ENVIRONMENT
	RADHARC_STATE
		The pathname to the state file, will be
		determined automatically if not set.
		If not set, you may only have one instance
		running per display server instance.

NOTES
	I suggest using a local script named radharc that
	sets all options for you.

KNOWN ISSUES
	In X.org, the gamma ramps do not apply to hardware cursors,
	because the developers thinks it is the graphics drivers
	that shall fix this, and they are not accepting patches for
	this. You can use xorg-server-hwcursor-gamma, however, that
	patched version does not apply apply the gamma ramps until
	the cursor changes image. You can also use sortware cursors
	if this really bothers you.

SEE ALSO
	redshift(1), blueshift(1), redshift-adjust(1), nightshift(1)