PyVirtualDisplay 0.0.9

python wrapper for Xvfb, Xephyr and Xvnc

pyvirtualdisplay is a python wrapper for Xvfb, Xephyr and Xvnc

Links:

• home: https://github.com/ponty/PyVirtualDisplay

• documentation: http://ponty.github.com/PyVirtualDisplay

Features:

• python wrapper

• backends: Xvfb, Xephyr, Xvnc

Warning

at least one backend should be installed

Known problems:

• Python 3 is not supported

• only a few backend options are supported

Possible applications:

• GUI testing

• automatic GUI screenshot

Basic usages

Start Xephyr:

from pyvirtualdisplay import Display
xephyr=Display(visible=1, size=(320, 240)).start()

Create screenshot of xmessage with Xvfb:

from easyprocess import EasyProcess
from pyvirtualdisplay.smartdisplay import SmartDisplay
with SmartDisplay(visible=0, bgcolor='black') as disp:
    with EasyProcess('xmessage hello'):
        img = disp.waitgrab()
img.show()

Installation

General

• install Xvfb or Xephyr or Xvnc.

• install pip

• optional: pyscreenshot and PIL should be installed for smartdisplay submodule

• install the program:

  # as root
  pip install pyvirtualdisplay

Ubuntu

sudo apt-get install python-pip
sudo apt-get install xvfb
sudo apt-get install xserver-xephyr
sudo apt-get install tightvncserver
sudo pip install pyvirtualdisplay
# optional
sudo apt-get install python-imaging
sudo apt-get install scrot
sudo pip install pyscreenshot

Uninstall

# as root
pip uninstall pyvirtualdisplay