Repository files navigation

You should useredshift-gtk instead. That's what I use :)

SeeIssue #178.

Thexflux program that Fluxgui traditionally used to change thescreen color hasn't worked on most modern systems since 2016, it's aclosed source program that is not part of this project, and there areno plans to fix it. Because of this, Fluxgui by default now usesRedshift to control your screen color,which should be supported on all systems.

SeeIssue #27 for whyxflux probably won't work on your system andhow to test if it can.

Better lighting for your computer

The f.lux indicator appletfluxgui is an indicator applet that usesxflux orredshift to make the color of your computer's displayadapt to the time of day: warm at night, and like sunlight during theday. Reducing blue light exposure in the evening can help you fallasleep at night. Seehttps://justgetflux.com/research.html orhttp://jonls.dk/redshift/ for more details.

This project --https://github.com/xflux-gui/fluxgui -- is onlyconcerned with thefluxgui indicator applet program, not with theunderlyingxflux orredshift program the indicator appletcontrols. Thexflux orredshift program is responsible foractually changing the color of your screen. Seehttps://justgetflux.com/linux.html for more information aboutxflux.

Thexflux program is downloaded automatically when installingfluxgui. You can installredshift via theredshift package onmost Linux distros. Simply runfluxgui in your terminal afterinstallation to open the applet. You can also easily configure theapplet to auto-start on login.

Thefluxgui is only known to work with Python 3.

ThePPA was last updated in 2019 (last supported Ubuntu version is 18.04 - bionic) and so you probably want to do amanual install!

To install via apt:

sudo add-apt-repository ppa:nathan-renniewaldock/fluxsudo apt-get updatesudo apt-get install fluxgui

Seeubuntuhandbook.org instructions for more details.

Whilesudo apt-get update there is an error#144

E: The repository 'http://ppa.launchpad.net/nathan-renniewaldock/flux/ubuntu focal Release' does not have a Release file.

To solve:

1. sudo vim /etc/apt/sources.list.d/nathan-renniewaldock-ubuntu-flux-focal.list
2. Replacefocal withbionic or whatever distro you're using and save it.
3. Repeatabove mentioned steps from line 2.

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

There is no Fedora package provided yet. Please useManual Install below.

To install manually you first install the dependencies using your package manager, and then installfluxgui using the providedsetup.py. The manual install can be done locally or system wide.

For theappindicator implementation, both plainappindicator and the Ayatanaayatanaappindicator are supported.

Partial list of Python 3 dependencies (after the upgrade to GTK+ 3 in PR #112. If you discover the correct deps, please submit a PR):

sudo apt-get install python3-pexpect python3-distutils python3-xdg gir1.2-ayatanaappindicator3-0.1 gir1.2-gtk-3.0 redshift

According tothis comment, these deps may also be needed:

gir1.2-appindicator3-0.1 python3-gi python3-gi-cairo

Out of date Python 2 dependencies; the remaining Python 3 deps should be similar:

sudo apt-get install git python-gconf python-gtk2 python-glade2 libxxf86vm1 libcanberra-gtk-module

WARNING: these dependencies may be out of date after the upgrade to GTK+ 3 in PR #112. If you discover the correct deps, please submit a PR.

sudo yum install git python-appindicator python2-pyxdg python3-pexpect gnome-python2-gconf pygtk2 pygtk2-libglade redshift

There are separate instructions in the code below for installing system wide and for installing locally in your user directory; choose one.

# Download fluxguicd /tmpgit clone"https://github.com/xflux-gui/fluxgui.git"cd fluxgui./download-xflux.py# EITHER install system widesudo ./setup.py install --record installed.txt# EXCLUSIVE OR, install in your home directory## The fluxgui program installs# into ~/.local/bin, so be sure to add that to your PATH if installing# locally. In particular, autostarting fluxgui in Gnome will not work# if the locally installed fluxgui is not on your PATH../setup.py install --user --record installed.txt# Run fluxfluxgui

If you manually installed instead of using package manager, you can uninstallby makingsetup.py tell you where it installed files and thenremoving the installed files.

# EITHER uninstall globally## The 'installed.txt' is generated when you install. Reinstall first if you# as described above if you don't have an 'installed.txt' file.sudo xargs rm -vr< installed.txtsudo glib-compile-schemas"$(dirname"$(grep apps.fluxgui.gschema.xml installed.txt)")"# EXCLUSIVE OR uninstall in your home directoryxargs rm -vr< installed.txtglib-compile-schemas"$(dirname"$(grep apps.fluxgui.gschema.xml installed.txt)")"

Thefluxgui applet is released under theMIT License. The underlyingxflux program that actually controls the screen color is closed source.

Try to stick to the same coding style that is already used in the file you are editing.In particular, don't change the style of code you're not already editing for some otherreason. Style changes create noise in the Git history and make thegit blame outputmisleading. When reviewing a PR, the maintainers want to focus on the logical changesintroduced by your code, and extraneous style changes make that harder.

When working onfluxgui, you can use

cd<path to your fluxgui.git clone># You only need to download xflux once../download-xflux.pyglib-compile-schemas.GSETTINGS_SCHEMA_DIR=`pwd` PATH=`pwd`:$PATH PYTHONPATH=`pwd`/src:$PYTHONPATH ./fluxgui

to test your local copy offluxgui without installing anything.

Note changes in./debian/changelog.

Use version<ver>pre until ready to release a version. Whenreleasing a version remove thepre suffix from the version stringsand commit, copying the changelog changes for the current release intothe commit message. Thengit tag -a v<ver>, using the commit msg forthe tag annotation, and push the version tag withgit push origin v<ver>. Finally, create another commit with the new<next version>pre version strings and changelog entry.

When releasing the version string needs to be changed indebian/changelog andsetup.py, and the release dates needs to beadded indebian/changelog.