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 [...].
The project is developed on GitHub.
Install the package. Alternatively, install the AUR package, for a version with minimal dependencies.
For desktop environments, the
redshift-gtk command is installed with the package. redshift-gtk provides a system tray icon for controlling redshift. redshift-gtk requires the , , and packages. KDE users can use the AUR. users can use the AUR.
There are two ways to have redshift automatically started:
- By launching redshift on a script under /etc/X11/xinit/xinitrc.d/
- Using the provided systemd service unit files (see Systemd#Using units). Two service files are provided,
/usr/lib/systemd/user/redshift-gtk.service: activate only one of them depending on whether or not you want the system tray icon. The
DISPLAYenvironment variable needs to be configured, see systemd/User#DISPLAY and XAUTHORITY.
- By right-clicking the system tray icon when redshift-gtk or plasma5-applets-redshift-control is already launched and selecting 'Autostart'.
Restart=alwaysso the service will restart infinitely (see
Redshift will at least need your location to start, 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: For most places/cities an easy way is to look up the wikipedia page of that place and get the location from there (search the page for "coordinates").
To just get it up and running with a basic setup, issue:
$ redshift -l LAT:LON
where LAT is the latitude and LON is the longitude of your location.
Automatic location based on GPS
You can also use
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.
Redshift reads the configuration file
~/.config/redshift.conf, if it exists. However, Redshift does not create that configuration file, so you have to create it manually.
Below is an example (copied from the Redshift website).
; Global settings for redshift [redshift] ; Set the day and night screen temperatures temp-day=5700 temp-night=3500 ; Enable/Disable a smooth transition between day and night ; 0 will cause a direct change from day to night screen temperature. ; 1 will gradually increase or decrease the screen temperature transition=1 ; Set the screen brightness. Default is 1.0 ;brightness=0.9 ; It is also possible to use different settings for day and night since version 1.8. ;brightness-day=0.7 ;brightness-night=0.4 ; Set the screen gamma (for all colors, or each color channel individually) gamma=0.8 ;gamma=0.8:0.7:0.8 ; Set the location-provider: 'geoclue', 'gnome-clock', 'manual' ; type 'redshift -l list' to see possible values ; The location provider settings are in a different section. location-provider=manual ; Set the adjustment-method: 'randr', 'vidmode' ; type 'redshift -m list' to see all possible values ; 'randr' is the preferred method, 'vidmode' is an older API ; but works in some cases when 'randr' does not. ; The adjustment method settings are in a different section. adjustment-method=randr ; Configuration of the location-provider: ; type 'redshift -l PROVIDER:help' to see the settings ; e.g. 'redshift -l manual:help' [manual] lat=48.1 lon=11.6 ; Configuration of the adjustment-method ; type 'redshift -m METHOD:help' to see the settings ; ex: 'redshift -m randr:help' ; In this example, randr is configured to adjust screen 1. ; Note that the numbering starts from 0, so this is actually the second screen. [randr] screen=1
Screen 1 could not be found
Locate configuration-file "redshift.conf" in your distribution and change Screen 1 to Screen 0
redshift-gtk will not start
redshift-gtk requires optional dependencies to work correctly. To verify any missing dependencies, run
redshift-gtk in the command line. Similar output to the following would be produced:
Traceback (most recent call last): File "/usr/bin/redshift-gtk", line 26, in <module> from redshift_gtk.statusicon import run File "/usr/lib/python3.4/site-packages/redshift_gtk/statusicon.py", line 31, in <module> from gi.repository import Gtk, GLib ImportError: No module named 'gi.repository'
If this is the case, installing, , and packages solves this issue.
Failed to run Redshift due to geoclue2
By default, the geoclue2 configuration files does not allow Redshift access.
In order to allow access, add the following lines to
[redshift] allowed=true system=false users=
If using Gnome, you can also toggle Location Services to "On" in "Settings -> Privacy"