Skip to main content

A complete VirtualBox Main API implementation

Project description

What’s in pyvbox:

  • A complete implementation of the VirtualBox Main API

  • Create a VirtualBox instance and seamlessly explorer the potential of VirtualBox’s amazing Main API

  • Pythonic functions and names.

  • Introspection, documentation strings, getters and setters…

Project hosting provided by github.com.

Install and run

Simply run the following:

> python setup.py install
> python setup.py test

Example:

> ipython
In [1]: import virtualbox

In [2]: vbox = virtualbox.VirtualBox()

In [3]: session = virtualbox.Session()

In [4]: vm = vbox.find_machine('test_vm')

In [5]: progress = vm.launch_vm_process(session, 'headless', '')

In [6]: h, w, d = session.console.display.get_screen_resolution(0)

In [7]: png = session.console.display.take_screen_shot_png_to_array(0, h, w)

In [8]: with open('screenshot.png', 'wb') as f:
  ....:     f.write(png)

In [9]: print(session.state)
Locked

In [10]: session.state
Out[10]: SessionState(2)

In [11]: session.console.power_down()

Issues

Source code for pyvbox is hosted on GitHub. Please file bug reports with GitHub’s issues system.

Compatibility

pyvbox utilises the VirtualBox project’s vboxapi to gain access to the underlying COM API primitives, which makes pyvbox compatible on systems where vboxapi is installed and functioning.

Change log

version 0.0.0 (10/05/2013)

  • builder

  • library primitives

Project details


Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page