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: 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 buster and stretch or Ubuntu focal, eoan, 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
$ apt-get install lavue-controller
$ apt-get update
$ apt-get install python3-lavue
$ apt-get install lavue-controller3

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 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

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

LavueController Tango Server API:


Indices and tables