Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Python wrapper for Xvfb, Xephyr and Xvnc

Fetching latest commit…

Cannot retrieve the latest commit at this time

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.