Skip to content
python wrapper for Xvfb, Xephyr and Xvnc
Find file
Pull request Compare This branch is 44 commits behind ponty:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
docs
pyvirtualdisplay
tests
.gitignore
LICENSE.txt
MANIFEST.in
README.rst
TODO
pavement.py
paver-minilib.zip
requirements.txt
setup.py

README.rst

pyvirtualdisplay is a python wrapper for Xvfb, Xephyr and Xvnc

Links:
Features:

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

Ubuntu

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

Uninstall

install pip:

# as root
pip uninstall pyvirtualdisplay
Something went wrong with that request. Please try again.