LinuxCommandLibrary

gammastep

screen color temperature adjuster

TLDR

Start with automatic location

$ gammastep
copy
Set manual location
$ gammastep -l [37.7749:-122.4194]
copy
Set color temperatures
$ gammastep -t [6500:3500]
copy
One-shot mode (apply once)
$ gammastep -O [3500]
copy
Reset screen
$ gammastep -x
copy
Use Wayland backend
$ gammastep -m wayland
copy

SYNOPSIS

gammastep [options]

DESCRIPTION

gammastep adjusts screen color temperature based on time of day to reduce eye strain and improve sleep. It makes screens warmer (redder) at night and cooler (bluer) during day.
Gammastep is a fork of Redshift with Wayland support. It's commonly used with tiling window managers and supports automatic location detection or manual coordinates.

PARAMETERS

-l lat:lon

Manual location (latitude:longitude).
-t day:night
Color temperature (day:night Kelvin).
-b day:night
Brightness (day:night, 0.1-1.0).
-O temp
One-shot mode with temperature.
-x
Reset and exit.
-m method
Adjustment method: randr, wayland, drm.
-P
Reset before applying.
-v
Verbose output.
-r
Disable gradual transition.

CONFIGURATION

~/.config/gammastep/config.ini

Configuration for color temperature, brightness, and location settings.

CONFIGURATION EXAMPLE

$ # ~/.config/gammastep/config.ini
[general]
temp-day=6500
temp-night=3500
brightness-day=1.0
brightness-night=0.8

[manual]
lat=37.7749
lon=-122.4194
copy

CAVEATS

Requires compatible display server (X11/Wayland). Automatic location needs geoclue or manual coordinates. Some applications may display colors inaccurately. Night light features in DEs may conflict.

HISTORY

Gammastep was forked from Redshift by Maxime Coste to add Wayland support. Redshift was created by Jon Lund Steffensen in 2009 based on research about blue light's effects on circadian rhythms.

SEE ALSO

redshift(1), xrandr(1), wlsunset(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community