Katana_mirror/kde-playground
1
0
Fork 0
mirror of https://bitbucket.org/smil3y/kde-playground.git synced 2025-02-23 18:32:51 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
kde-playground/redshift-plasmoid
History
Ivailo Monev 1755951fd3 redshift-plasmoid: build fix 
Signed-off-by: Ivailo Monev <xakepa10@gmail.com>
2022-03-24 18:30:54 +02:00
..
icons redshift-plasmoid: build fix 2022-03-24 18:30:54 +02:00
po redshift-plasmoid: build fix 2022-03-24 18:30:54 +02:00
src redshift-plasmoid: build fix 2022-03-24 18:30:54 +02:00
CMakeLists.txt import redshift-plasmoid v1.0 2015-05-03 18:24:38 +00:00
COPYING import redshift-plasmoid v1.0 2015-05-03 18:24:38 +00:00
Doxyfile import redshift-plasmoid v1.0 2015-05-03 18:24:38 +00:00
README.md import redshift-plasmoid v1.0 2015-05-03 18:24:38 +00:00
TODO import redshift-plasmoid v1.0 2015-05-03 18:24:38 +00:00

README.md

Redshift Plasmoid

Redshift Plasmoid provide a graphical configuration interface to redshift and it allows to start/stop the redshift daemon. The program automatically retrieves the user coordinates from the KDE settings, permitting redshift to determine the current position of the sun, needed to perform the color regulation.

The program extends the original redshift with the following extra features:

  • KDE activities support A different behavior of redshift can be set for different activities. The possible behaviors are: Always On, Always Off or Auto. As an example redshift can be automatically turned off when the user switches to the movie activity, so that the movie can be seen without altering the original colors.

  • Manual color adjustment Sometimes the color temperature set does not match the current environmental light. It can happen when we are in a different location, where there are different types of light, or when there is a gloomy day and the sunlight is not very bright. In these cases it is possible to manually adjust the color temperature by spinning the mouse wheel over the widget. The program will then switch to Manual Mode and won’t adjust the temperature automatically, but will keep the current. To exit Manual Mode you just click on the widget.

Installation instructions

From redshift root directory execute:

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=$(kde4-config --prefix) ..
make
sudo make install

To start using the plasmoid reboot you machine or run the following command:

redshiftautostart

Dependencies

  • KDE SC 4.x
  • Redshift

Build dependecies

  • Essential build tools (gcc, cmake, and so on)

Required packages for Debian like distributions:

  • build-essentials
  • cmake
  • kde-workspace-dev
  • redshift

Installation troubleshoots:

If make fails to build because it try to build it against Qt5, try:

cmake -DQT_QMAKE_EXECUTABLE=/usr/bin/qmake-qt4 -DCMAKE_INSTALL_PREFIX=$(kde4-config --prefix) ..)

If your distribution doesn't use bash as default shell, try:

su -c 'make install'

How to use

Basic commands

  • Click on the redshift widget to toggle the screen color regulation on/off. When in Manual mode clicking brings redshift back in Auto mode.
  • Scroll the mouse wheel over the redshift widget to switch to Manual Mode and keep the screen color temperature constant throughout the day.

Configuration pages

  • General configuration page The general redshift parameters can be set from this page. A tooltip explains each parameter.
  • Activities configuration page In this page a different behavior of redshift can be set for each kde activity. The possible behaviors are:
    • Auto Redshift can be turned on/off
    • Always on Redshift is active and can't be turned off
    • Always off Redshift is inactive and can't be turned on
  • Shortcut configuration page In this page it's possible to set a global keyboard shortcut to toggle redshift on/off.

Author

Simone Gaiarin <simgunz AT gmail DOT com>

License

Software distributed under the GNU General Public License version 3 (GNU GPL v3).

http://www.gnu.org/copyleft/gpl.html

References