Thyxx / xflux-gui

Better lighting for Linux. Open source GUI for xflux

f.lux indicator applet

Better lighting for your computer

The f.lux indicator applet fluxgui is an indicator applet to control xflux, an application that makes the color of your computer's display adapt to the time of day, warm at nights and like sunlight during the day. Reducing blue light exposure in the evening can help you fall asleep at night. See https://justgetflux.com/research.html for more details.

This project -- https://github.com/xflux-gui/xflux-gui -- is only concerned with the fluxgui indicator applet program, not with the underlying xflux program the indicator applet controls. The xflux program is responsible for actually changing the color of your screen. See https://justgetflux.com/linux.html for more information about xflux.

Install Instructions

Ubuntu PPA Package Manager Install

There is a PPA here:

https://launchpad.net/~nathan-renniewaldock/+archive/ubuntu/flux

See ubuntuhandbook.org instructions for more details on using the PPA to install xflux using the package manager.

If you have trouble with the PPA version try the manual install below.

Ubuntu/Debian Manual Install

# Install dependencies
sudo apt-get install git python-appindicator python-xdg python-pexpect python-gconf python-gtk2 python-glade2 libxxf86vm1

# Download xflux-gui
cd /tmp
git clone "https://github.com/xflux-gui/xflux-gui.git"
cd xflux-gui
python download-xflux.py

# EITHER install globally
sudo python setup.py install
# EXCLUSIVE OR, install in your home directory. The binary installs
# into ~/.local/bin, so be sure to add that to your PATH if installing locally.
python setup.py install --user

# Run flux
fluxgui

Ubuntu/Debian Manual Uninstall

If you manually installed instead of using the PPA, you can uninstall by making setup.py tell you where it installed files and then removing the installed files.

# EITHER uninstall globally
sudo python setup.py install --record installed.txt
sudo xargs rm -vr < installed.txt

# EXCLUSIVE OR uinstall in your home directory
python setup.py install --user --record installed.txt
xargs rm -vr < installed.txt

License

The f.lux indicator applet is released under the MIT License.

Developing

Running fluxgui Without Installing

When working on fluxgui, you can use

cd <path to your xflux-gui.git clone>
# You only need to download xflux once.
python download-xflux.py
PATH=`pwd`:$PATH PYTHONPATH=`pwd`/src:$PYTHONPATH ./fluxgui &

to test your local copy of fluxgui without installing anything.

Change Logs, Versions, Releases

Note changes in ./debian/changelog.

Use version <ver>~pre until ready to release a version. When releasing a version make branch, remove the ~pre suffix from the version strings in the branch, and tag the branch v<ver>.

When releasing the version string needs to be changed in debian/changelog and setup.py, and the release dates needs to be added in debian/changelog.