Difference between revisions of "Redshift"

From ArchWiki
Jump to: navigation, search
(Manual setup)
(Remove old summary box.)
Line 3: Line 3:
 
[[Category:Eye candy]]
 
[[Category:Eye candy]]
 
[[Category:Audio/Video]]
 
[[Category:Audio/Video]]
{{Article summary start}}
 
{{Article summary text|Installation, configuration, tips & tricks and basic troubleshooting of Redshift - A program that shifts the screen color temperature according to the position of the sun.}}
 
{{Article summary heading|Other sources}}
 
{{Article summary text|[http://jonls.dk/redshift Redshift website]}}
 
{{Article summary text|[https://launchpad.net/redshift Redshift on launchpad]}}
 
{{Article summary end}}
 
 
 
The [https://launchpad.net/redshift website] states:
 
The [https://launchpad.net/redshift website] states:
  
Line 77: Line 70:
 
{{Pkg|python2-xdg}}, {{Pkg|librsvg}} and {{Pkg|pygtk}} are needed for gtk-redshift. They are the optional dependencies for the redshift package. If you run into problems when trying to run gtk-redshift, check if they are installed. If they are not installed, install them as a dependency:
 
{{Pkg|python2-xdg}}, {{Pkg|librsvg}} and {{Pkg|pygtk}} are needed for gtk-redshift. They are the optional dependencies for the redshift package. If you run into problems when trying to run gtk-redshift, check if they are installed. If they are not installed, install them as a dependency:
 
   # pacman --asdeps -S python2-xdg librsvg pygtk
 
   # pacman --asdeps -S python2-xdg librsvg pygtk
 +
 +
== See also ==
 +
* [http://jonls.dk/redshift Redshift website]
 +
* [https://launchpad.net/redshift Redshift on launchpad]

Revision as of 02:59, 22 December 2013

The website states:

"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 launchpad.

Installation

The redshift package is available in the Official Repositories.

Note: If Redshift will not start, see section #Troubleshooting.

Configuration

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").

Quick start

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.

Manual setup

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. Example for Hamburg/Germany:

~/.config/redshift.conf
; Global settings
[redshift]
temp-day=5700
temp-night=3500
transition=1
gamma=0.8:0.7:0.8
location-provider=manual
adjustment-method=vidmode

; The location provider and adjustment method settings
; are in their own sections.
[manual]
; Hamburg
lat=53.3
lon=10.0

; In this example screen 1 is adjusted by vidmode. Note
; that the numbering starts from 0, so this is actually
; the second screen.
[vidmode]
screen=0
screen=1

After you created that file, start redshift from the menu of your DE (called "gtk-redshift") or type the following in your terminal:

 $ redshift-gtk &

Using "redshift-gtk" instead of "redshift" launches Redshift with a system tray icon for easier handling of the application. Finally, if you want to start Redshift automatically on system startup, rightclick the system tray icon an check "Autostart".

Troubleshooting

Missing dependency

python2-xdg, librsvg and pygtk are needed for gtk-redshift. They are the optional dependencies for the redshift package. If you run into problems when trying to run gtk-redshift, check if they are installed. If they are not installed, install them as a dependency:

 # pacman --asdeps -S python2-xdg librsvg pygtk

See also