/pyrandr-bt

Manage your screen brightness and temperature using randr

Primary LanguagePython

Moved to xscreenfilter

This project has been moved to a new repository: xscreenfilter.

The new repository supports installation through pip.

OLD readme of PyRandr-BT

Protect your eyes. Manage your screen brightness and temperature using randr. (for linux systems)

This script lets you modify the software brightness and temperature manually from the command line. You can assign it to a global hotkey for ease of access.

For the hardware brightness, also called backlight, check out brightnessctl.

Why?

  • We spend many hours on the screen.
  • Screens are too bright, even on 1% backlight.
  • xrandr supports brightness but not temperature: there is a --gamma option but colors look very strange if you use it.
  • redshift supports setting both, but not reading, increasing or decreasing. It is meant for automated use only, making things darker at night. In my opinion, it is more practical to let the user change it directly, because if the window is closed during the day or the lights are on during the night, the automated system stops being useful. Furthermore, redshift has tons of dependencies and uses your location by default. In my opinion, it is too complex for such a simple task.
  • No other open source software is available.

How to use?

Install python3-xlib, copy the script pyrandr-bt.py and run it with python3 pyrandr-bt.py. You will see the available arguments.

Particularly, the -c argument alters both brightness and temperature (combined). You can use it to make the screen

  • 'darker and warmer' (python3 pyrandr-bt.py -c -5), or
  • 'lighter and cooler (white)' (python3 pyrandr-bt.py -c +5).

Assign them to some global hotkeys for the best experience.

Video

Showcase video

I wished I could record the screen from the screen recorder, but screen recorders can't see the screen filters that are applied.