13/12/2017 GitHub - xflux-gui/fluxgui: Better lighting for Linux.

Open source GUI for xflux

xux-gui / uxgui

Dismiss
Join GitHub today
GitHub is home to over 20 million developers working together to
host and review code, manage projects, and build software
together.

Sign up

Better lighting for Linux. Open source GUI for xux https://justgetux.com/linux.html
# indicator-applet # xux # ubuntu # night # bluelight # eye-strain # sleep-issues

217 commits 1 branch 1 release 12 contributors MIT

Branch: master New pull request Find le Clone or download

@ ntc2 Update changelog Latest commit 9ce2b1f 26 days ago

nt

debian Update changelog 26 days ago

desktop Spelling correction in app descriptions. 5 years ago

icons clear code all SVG icons. redesign ubuntu-mono & hicolor. Add 16-96px a month ago

resources update todo 7 years ago

src/uxgui rename tray icons to uxgui-panel #79 a month ago

.gitignore initial commit 8 years ago

ISSUE_TEMPLATE.md Add explicit link to Issue #27. 11 months ago

LICENSE Rename copying le to license 2 years ago

MANIFEST.in update stu 8 years ago

README.md Rename project xux-gui -> uxgui a month ago

download-xux.py - use python built in methods 2 months ago

uxgui Reset colertemp to default before exiting from signal. a year ago

setup.py clear code all SVG icons. redesign ubuntu-mono & hicolor. Add 16-96px a month ago

README.md

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://justgetux.com/research.html
for more details.

https://github.com/xflux-gui/fluxgui 1/3
13/12/2017 GitHub - xflux-gui/fluxgui: Better lighting for Linux. Open source GUI for xflux

This project -- https://github.com/xux-gui/uxgui -- 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://justgetux.com/linux.html for more
information about xflux .

Install Instructions

Only Python 2 is Supported

The fluxgui is only known to work with Python 2, so use python2 instead of python for the commands in this
README if Python 3 is the default on your system.

Ubuntu PPA Package Manager Install

To install via apt:

sudo add-apt-repository ppa:nathan-renniewaldock/flux

sudo apt-get update
sudo apt-get install fluxgui

See ubuntuhandbook.org instructions for more details.

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-glad

# Download fluxgui
cd /tmp
git clone "https://github.com/xflux-gui/fluxgui.git"
cd fluxgui
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 les and then removing the installed les.

# 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

https://github.com/xflux-gui/fluxgui 2/3
13/12/2017 GitHub - xflux-gui/fluxgui: Better lighting for Linux. Open source GUI for xflux

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 fluxgui.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 sux from the version strings in the branch, and git tag -a 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 .

https://github.com/xflux-gui/fluxgui 3/3