aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README.md67
-rw-r--r--contrib/macos/launchd/dk.jonls.redshift.plist22
-rw-r--r--src/signals.c5
-rw-r--r--src/signals.h4
4 files changed, 96 insertions, 2 deletions
diff --git a/README.md b/README.md
index 54d9a04..244a3c2 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,73 @@ Building from source
See the file [HACKING](HACKING.md) for more details on building from source.
+FAQ
+---
+
+**Where can I find my coordinates to put in the configuration file?**
+
+There are multiple web sites that provide coordinates for map locations, for
+example clicking anywhere on Google Maps will bring up a box with the
+coordinates. Remember that longitudes in the western hemisphere (e.g. the
+Americas) must be provided to Redshift as negative numbers.
+
+**Why doesn't Redshift work on my Chromebook/Raspberry Pi?**
+
+Certain video drivers do not support adjustable gamma ramps. In some cases
+Redshift will fail with an error message, but other drivers silently ignore
+adjustments to the gamma ramp.
+
+**Why doesn't Redshift change the backlight when I use the brightness option?**
+
+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. Preferable only use it if your normal backlight adjustment is
+too coarse-grained.
+
+**Why doesn't Redshift work on Wayland (e.g. Fedora 25)?**
+
+The Wayland protocol does not support Redshift. There is currently no way for
+Redshift adjust the color temperature in Wayland.
+
+**Why doesn't Redshift work on Ubuntu with Mir enabled?**
+
+Mir does not support Redshift.
+
+**The redness effect is applied during the day instead of at night. Why?**
+
+This usually happens to users in America when the longitude has been set in the
+configuration file to a positive number. Longitudes in the western hemisphere
+should be provided as negative numbers (e.g. New York City is at approximately
+latitude/longitude 41, -74).
+
+**Why does the redness effect occasionally switch off for a few seconds?**
+
+Redshift uses the gamma ramps of the graphics driver to apply the redness
+effect but Redshift cannot block other applications from also changing the
+gamma ramps. Some applications (particularly games and video players) will
+reset the gamma ramps. After a few seconds Redshift will kick in again. There
+is no way for Redshift to prevent this from happening.
+
+**Why does the redness effect continuously flicker?**
+
+You may have multiple instances of Redshift running simultaneously. Make sure
+that only one instance is running for the display where you are seeing the
+flicker.
+
+**Why doesn't Redshift change the color of the mouse cursor?**
+
+Mouse cursors are usually handled separately by the graphics hardware and is
+not affected by gamma ramps. Some graphics drivers can be configured to use
+software cursors instead.
+
+**I have an issue with Redshift but it was not mentioned in this FAQ. What
+do I do?**
+
+Please go to [the issue tracker](https://github.com/jonls/redshift/issues) and
+check if your issue has already been reported. If not, please open a new issue
+describing you problem.
+
Donations
---------
diff --git a/contrib/macos/launchd/dk.jonls.redshift.plist b/contrib/macos/launchd/dk.jonls.redshift.plist
new file mode 100644
index 0000000..1e0562b
--- /dev/null
+++ b/contrib/macos/launchd/dk.jonls.redshift.plist
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+ <key>Label</key>
+ <string>dk.jonls.redshift</string>
+
+ <key>ProgramArguments</key>
+ <array>
+ <string>/usr/local/bin/redshift</string>
+ </array>
+
+ <key>Nice</key>
+ <integer>20</integer>
+
+ <key>RunAtLoad</key>
+ <true/>
+
+ <key>KeepAlive</key>
+ <true/>
+</dict>
+</plist>
diff --git a/src/signals.c b/src/signals.c
index 3dac82c..cee5ece 100644
--- a/src/signals.c
+++ b/src/signals.c
@@ -50,6 +50,11 @@ sigdisable(int signo)
disable = 1;
}
+#else /* ! HAVE_SIGNAL_H || __WIN32__ */
+
+int disable = 0;
+int exiting = 0;
+
#endif /* ! HAVE_SIGNAL_H || __WIN32__ */
diff --git a/src/signals.h b/src/signals.h
index 36cdaf1..7a1d22e 100644
--- a/src/signals.h
+++ b/src/signals.h
@@ -27,8 +27,8 @@ extern volatile sig_atomic_t exiting;
extern volatile sig_atomic_t disable;
#else /* ! HAVE_SIGNAL_H || __WIN32__ */
-# define exiting 0
-# define disable 0
+extern int exiting;
+extern int disable;
#endif /* ! HAVE_SIGNAL_H || __WIN32__ */