Skip to main content

Live image viewer application for photon science detectors.

Project description

Authors: Christoph Rosemann <christoph.rosemann at>, Jan Kotański <jan.kotanski at>, André Rothkirch <andre.rothkirch at>


This is a simple implementation of a live viewer front end. It is supposed to show a live image view from xray-detectors at PETRA3 @, e.g. Pilatus, Lambda, Eiger, PerkinElmer, PCO, LimaCCD, and others.


LaVue requires the following python packages: qt5/qt4 pyqtgraph numpy zmq scipy

It is also recommended to install: pytango hidra pil fabio requests h5py pni nxstools

From sources

Download the latest LaVue version from

Extract sources and run

$ python install

The script may need: setuptools sphinx numpy pytest python packages as well as qtbase5-dev-tools or libqt4-dev-bin.

Debian packages

Debian bookworm, bullseye, buster or Ubuntu lunar, jammy, focal packages can be found in the HDRI repository.

To install the debian packages, add the PGP repository key

$ sudo su
$ curl -s  | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/debian-hdri-repo.gpg --import
$ chmod 644 /etc/apt/trusted.gpg.d/debian-hdri-repo.gpg

and then download the corresponding source list, e.g.

$ cd /etc/apt/sources.list.d


$ wget


$ wget


$ wget


$ wget



$ apt-get update
$ apt-get install python3-lavue
$ apt-get install lavue-controller


$ apt-get install lavue-controller3

for python 3 version (for older debian/ubuntu releases).

From pip

To install it from pip you need to install pyqt5 in advance, e.g.

$ python3 -m venv myvenv
$ . myvenv/bin/activate

$ pip install PyQtWebKit


$ pip install pyqt5


$ pip install PyQt5==5.14

and then

$ pip install lavue

Moreover it is also good to install the following python packages:

$ pip install fabio
$ pip install pillow
$ pip install pyFAI
$ pip install lavuefilters
$ pip install pytango

Start the Viewer

To start LaVue

$ lavue


$ lavue3

for python 3 version (for older debian/ubuntu releases).

Start the Viewer in the expert mode

Changing LaVue settings is available in the expert mode, i.e.

$ lavue -m expert

under an additional button: Configuration.

Launching options

To get all possible command-line parameters

$ lavue -h

Further reading

More information can be found at: LaVue

Project details

Release history Release notifications | RSS feed

Download files

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

Source Distribution

lavue-2.88.0.tar.gz (32.7 MB view hashes)

Uploaded Source

Built Distribution

lavue-2.88.0-py3-none-any.whl (11.4 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page