Skip to main content

Raspberry Pi 7" LCD emulator for rpi-backlight

Project description

Raspberry Pi 7" LCD emulator for rpi-backlight

License PyPI Black Issues


This is an emulator for the Raspberry Pi 7" LCD to test and develop rpi-backlight without having a physical display connected or even running on the Pi.


Python 3.5+ is required, along with the packages PySide2, watchdog and rpi-backlight>=2.0.0b5 (see below).


PySide2 wheels for x86/x64 are available on PyPI, so you can simply run:

$ pip3 install rpi-backlight-emulator

On ARM (e.g. Raspberry Pi) it's more complicated (and only the new Debian/Raspbian Buster will work, Stretch won't - you'd have to install PySide2 from source):

$ sudo apt install python3-pyside2.qtcore python3-pyside2.qtgui python3-pyside2.qtwidgets
$ pip3 install watchdog rpi-backlight>=2.0.0b5
$ pip3 install --no-deps rpi-backlight-emulator



$ rpi-backlight-emulator

Next, open a Python shell and create a rpi_backlight.Backlight instance using the emulator:

>>> from rpi_backlight import Backlight
>>> backlight = Backlight(":emulator:")

Now, continue like you're connected to a real display!

You can make changes to the display using the emulator, they'll be reflected in the Python-API and vice versa.

Enable Show live screen to replace the static Raspbian Buster screenshot with a live preview of your monitor.


Display off Display on Brightness low


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. See LICENSE for more information.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for rpi-backlight-emulator, version 1.1.0b1
Filename, size File type Python version Upload date Hashes
Filename, size rpi_backlight_emulator-1.1.0b1-py3-none-any.whl (1.1 MB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size rpi-backlight-emulator-1.1.0b1.tar.gz (1.1 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page