From the Redshift project web page:
- Redshift adjusts the color temperature of your screen according to your surroundings. This may help your eyes hurt less if you are working in front of the screen at night. This program is inspired by f.lux.
- 1 Installation
- 2 Usage
- 3 Configuration
- 4 Troubleshooting
- 4.1 Screen 1 could not be found
- 4.2 Left/right clicking the tray icon does not work
- 4.3 Redshift makes the screen quickly flicker between the set color value of the screen and the default color value
- 4.4 Redshift works fine when invoked as a command but fails when run as a systemd service
- 4.5 Redshift does not appear in system tray
- 4.6 Redshift temporarily resets using some wine apps that reset gamma values
- 4.7 Redshift GDBus.Error:org.freedesktop.DBus.Error.AccessDenied on start
- 4.8 Redshift turns the screen green when resolution is over 1080p while using Nvidia drivers
- 5 See also
Install the package. Alternatively, install the AUR package, for a version with minimal dependencies.
The redshift-gtk command comes with thepackage and provides a system tray icon for controlling Redshift. See optional dependencies.
Alternatives are broken link: package not found] and AUR.AUR and AUR, AUR or [
Redshift will at least need your location to start (unless
-O is used), meaning the latitude and longitude of your location. Redshift employs several routines for obtaining your location. If none of them works (e.g. none of the used helper programs is installed), you need to enter your location manually.
To just get it up and running with a basic setup, issue:
$ redshift -l LATITUDE:LONGITUDE
where LATITUDE is the latitude and LONGITUDE is the longitude of your location.
To instantly adjusts the color temperature of your screen use:
$ redshift -P -O TEMPERATURE
where TEMPERATURE is the desired color temperature (between
There are several options to have Redshift automatically started:
- By right-clicking the system tray icon and selecting Autostart when redshift-gtk or plasma5-applets-redshift-control is already launched.
- By placing a Redshift desktop entry in
~/.config/autostart/or by adding
redshiftto your window manager or desktop environment's autostarting method.
- By using systemd/User. Two services are provided:
redshift-gtk.service. Activate only one of them depending on whether or not you want the system tray icon.
- The Redshift service files contain
Restart=alwaysso they will restart infinitely. See .
- When using a systemd user service, Xorg must be started before execution of the service, which is not the case without a display manager. Otherwise you will get
RANDR Query Version' returned error -1and
Initialization of randr failed.
Redshift reads the configuration file
~/.config/redshift/redshift.conf  if it exists. However, Redshift does not create that configuration file, so you may want to create it manually. See redshift.conf.sample.
Automatic location based on GeoClue2
First check if
$ /usr/lib/geoclue-2.0/demos/where-am-i. At this time default Archlinux API key for Mozilla services reaches limit (see SO post and bugreport) and Wi-Fi location method is banned. As workaround it's suggested to change API key to 'geoclue'.
In order to allow access Redshift to use GeoClue2, add the following lines to
[redshift] allowed=true system=false users=
redshift.service and/or any other Redshift instance to apply the changes.
- This workaround is not needed with Geoclue2 version 2.5.0 and above.
- If using GNOME, also toggle Location Services to "On" in Settings > Privacy.
- Due possible bugs with geoclue2 and Redshift , it may be required to use the
manuallocation-provider instead, e.g. for Paris:
[redshift] ... ; Set the location-provider: 'geoclue2', 'manual' ; type 'redshift -l list' to see possible values. ; The location provider settings are in a different section. location-provider=manual ... ; Keep in mind that longitudes west of Greenwich (e.g. the Americas) ; are negative numbers. [manual] lat=48.864716 lon=2.349014
- If using i3wm or similar, you will also need to enable the geoclue agent on startup. As well as
systemctl --user enable redshift-gtkor
... exec --no-startup-id /usr/lib/geoclue-2.0/demos/agent ...
Automatic location based on GPS
You can also use GPS location and use it as an input for Redshift. Create the following script and pass
redshift -l $lat;$lon:
#!/bin/bash date #gpsdata=$( gpspipe -w -n 10 | grep -m 1 lon ) gpsdata=$( gpspipe -w | grep -m 1 TPV ) lat=$( echo "$gpsdata" | jsawk 'return this.lat' ) lon=$( echo "$gpsdata" | jsawk 'return this.lon' ) alt=$( echo "$gpsdata" | jsawk 'return this.alt' ) dt=$( echo "$gpsdata" | jsawk 'return this.time' ) echo "$dt" echo "You are here: $lat, $lon at $alt"
For more information, see this forums thread.
Use real screen brightness
Redshift has a brightness adjustment setting, but it does not work the way most people might expect. In fact it is a fake brightness adjustment obtained by manipulating the gamma ramps, which means that it does not reduce the backlight of the screen. 
Changing screen backlight is possible with redshift hooks and Backlight#xbacklight as there are some limitations and you may have to find another method of controlling the backlight depending on your hardware.and but, please see
You need to create a file in
~/.config/redshift/hooks and make it executable. You can use and edit the following example:
$ mkdir -p ~/.config/redshift/hooks
Create and adjust the following script:
#!/bin/sh # Set brightness via xbrightness when redshift status changes # Set brightness values for each status. # Range from 1 to 100 is valid brightness_day=100 brightness_transition=50 brightness_night=10 # Set fade time for changes to one minute fade_time=60000 if [ "$1" = period-changed ]; then case $3 in night) xbacklight -set $brightness_night -time $fade_time ;; transition) xbacklight -set $brightness_transition -time $fade_time ;; daytime) xbacklight -set $brightness_day -time $fade_time ;; esac fi
Make it executable:
$ chmod +x ~/.config/redshift/hooks/brightness.sh
redshift.service to apply changes.
Check the service status as it should not contain the following message:
redshift[..]: No outputs have backlight property
Screen 1 could not be found
Locate configuration-file "redshift.conf" in your distribution and change "screen 1" to "screen 0".
Left/right clicking the tray icon does not work
Redshift makes the screen quickly flicker between the set color value of the screen and the default color value
Make sure there are not multiple instances of redshift running.
Redshift works fine when invoked as a command but fails when run as a systemd service
The systemd unit has a line in the
redshift.service file that makes the service wait until the
display-manager.service unit is started by a display manager before the unit will invoke
redshift. If you do not use a display manager, edit the
redshift.service user service and delete the
After=display-manager.service line. Run
systemctl --user daemon-reload and the service should initialize properly.
Redshift does not appear in system tray
If running the
$ redshift-gtk command does not start in the system tray, but instead you get the following output
Traceback (most recent call last): File "/usr/bin/redshift-gtk", line 26, in <module> from redshift_gtk.statusicon import run File "/usr/lib/python3.8/site-packages/redshift_gtk/statusicon.py", line 31, in <module> gi.require_version('Gtk', '3.0') AttributeError: module 'gi' has no attribute 'require_version'
you will need to install.
Redshift temporarily resets using some wine apps that reset gamma values
If you notice that using some wine apps, redshift seems to reset temporarily upon launch, or adjusting settings, or etc, then there is a useful registry key that seems to alleviate this. See  and . Set or create the string value
using the registry editor, or import/set it otherwise.
Redshift GDBus.Error:org.freedesktop.DBus.Error.AccessDenied on start
$ redshift and you are getting:
Trying location provider `geoclue2'... Using provider `geoclue2'. Unable to start GeoClue client: GDBus.Error:org.freedesktop.DBus.Error.AccessDenied: 'redshift' disallowed, no agent for UID 1000. Unable to connect to GeoClue. Unable to get location from provider.
$ redshift-gtk and getting the similar error:
Failed to run Redshift Trying location provider `geoclue2'... Unable to start GeoClue client: GDBus.Error:org.freedesktop.DBus.Error.AccessDenied: 'redshift' disallowed, no agent for UID 1000. Unable to connect to GeoClue. Unable to get location from provider.
You can create a systemd unit file in
~/.config/systemd/user/geoclue-agent.service with the following config:
[Unit] Description=redshift needs to get a (geo)clue [Service] ExecStart=/usr/lib/geoclue-2.0/demos/agent [Install] WantedBy=default.target
Start and enable the service with systemctl:
$ systemctl --user enable --now geoclue-agent.service and try running redshift again.
If you still get the same error, it may be because of geoclue being locked down to a few programs by default. Try adding the following lines to
/etc/geoclue/geoclue.conf (see redshift issue 158 and FS#40360) and run
$ redshift again:
[redshift] allowed=true system=false users=
Redshift turns the screen green when resolution is over 1080p while using Nvidia drivers
This is a bug with the nvidia drivers. A fix for this is to make the following edit:
Section "Device" ... Option "UseNvKmsCompositionPipeline" "false" ... EndSection