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 bullseye, buster and stretch or Ubuntu impish, hirsute, focal, bionic 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



$ 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 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.74.0.tar.gz (32.0 MB view hashes)

Uploaded source

Built Distribution

lavue-2.74.0-py3-none-any.whl (11.1 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page