carta
wlsunset(1)

wlsunset1

Day/night gamma adjustments for wayland compositors supporting wlr-gamma-control-unstable-v1

Usage

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.

Examples

# 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.

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm)

Authors

Maintained by Kenny Levinsen <[email protected]>. For more information about wlsunset development, see https://sr.ht/~kennylevinsen/wlsunset.

From wlsunset 0.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.