Live image viewer application for photon science detectors.

live, viewer, photon, science, detector, online, pyqt, pyqtgraph, python, tango
pip install lavue==2.62.0


LaVue - Live Image Viewer

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: 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 libqt4-dev-bin.

Debian packages

Debian stretch (and jessie) ot Ubuntu bionic packages can be found in the HDRI repository.

To install the debian packages, add the PGP repository key

$ sudo su
$ wget -q -O - | apt-key add -

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

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


$ wget


$ wget


$ wget



$ apt-get update
$ apt-get install python-lavue

for python 2.7 version

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

for python 3 version. Please notice that HiDRA is not available for python 3 yet.

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 lavue

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

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

Start the Viewer

To start LaVue

$ lavue

for python 2.7 or

$ lavue3

for python 3.

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