- Change the display brightness smoothly or abrupt
- Set the display power on or off
- Get the current brightness
- Get the maximum brightness
- Get the display power state (on/off)
- Command line interface
- Graphical user interface
- A Raspberry Pi including a correctly assembled 7" touch display v1.1 or higher running a Linux-based OS
- Python 2 or 3
- Optional:
pygobject
for the GUI, is likely to be already installed on a recent Raspbian
Install from PyPI using:
pip install rpi_backlight
or clone this repository and install by:
git clone https://github.com/linusg/rpi-backlight.git cd rpi-backlight sudo python3 setup.py install
Note: You may need to edit the backlight rules file in order to run the code:
sudo nano /etc/udev/rules.d/backlight-permissions.rules
Insert the line:
SUBSYSTEM=="backlight",RUN+="/bin/chmod 666 /sys/class/backlight/%k/brightness /sys/class/backlight/%k/bl_power"
Example in a Python shell:
>>> import rpi_backlight as bl >>> bl.set_brightness(255) >>> bl.set_brightness(20, smooth=True, duration=3) >>> bl.get_max_brightness() 255 >>> bl.get_actual_brightness() 20 >>> bl.get_power() True >>> bl.set_power(False)
NOTE: Code using set_
functions of this library has to be run as root, e.g. sudo python file.py
, if the permissions for changing the backlight were not changed as described in the installation section!
Open a terminal and run rpi-backlight
as root:
$ rpi-backlight -b 255 $ rpi-backlight -b 20 -s -d 3 $ rpi-backlight --max-brightness 255 $ rpi-backlight --actual-brightness 20 $ rpi-backlight --power True $ rpi-backlight --off
Open a terminal and run rpi-backlight-gui
as root.
Yay, this list is currently empty! Feel free to add ideas here.
The source code and all other files in this repository are licensed under the MIT license, so you can easily use it in your own projects.