wlsunset - Man Page
day/night gamma adjustments for Wayland compositors supporting wlr-gamma-control-unstable-v1
Examples (TL;DR)
- Automatically compute sunset/sunrise times based on the specified location:
wlsunset -l latitude -L longitude
- Manually set the sunset/sunrise times (time format:
HH:MM
):wlsunset -s sunset_time -S sunrise_time
- Set the high and low temperatures (default: high - 6500, low - 4000):
wlsunset -T high_temp -t low_temp
- Set the animation time to
n
seconds (only applicable when using manual sunset/sunrise times):wlsunset -d n -s sunset_time -S sunrise_time
- Set the gamma (default: 1.0):
wlsunset -g gamma_value
Synopsis
wlsunset [options...]
Options
- -h
Show this help message.
- -T <temp>
Set high temperature (default: 6500).
- -t <temp>
Set low temperature (default: 4000).
- -l <lat>
Set latitude (e.g. 39.9).
- -L <long>
Set longitude (e.g. 116.3).
- -S <sunrise>
Manual time for sunrise as HH:MM (e.g. 06:30).
- -s <sunset>
Manual time for sunset as HH:MM (e.g. 18:30).
- -d <duration>
Manual animation time in seconds (e.g. 1800).
Only applicable when using manual sunset/sunrise times.
- -g <gamma>
Set gamma (default: 1.0).
Runtime Control
Sending SIGUSR1 to wlsunset causes it to cycle through the following modes:
1. Forced use of the high temperature.
2. Forced use of the low temperature.
3. Automatic temperature calculation, the default behavior.
Example
# Beijing lat/long. wlsunset -l 39.9 -L 116.3
Greater precision than one decimal place serves no purpose (https://xkcd.com/2170/) other than padding the command-line.
Authors
Maintained by Kenny Levinsen <contact@kl.wtf>. For more information about wlsunset development, see https://sr.ht/~kennylevinsen/wlsunset.