jacopofar / remote-virtualbox

:cake: Little package to do simple things with VirtualBox remotely using its SOAP API

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Remote VirtualBox

Build Status Black Indicator

About

This package is intended to be simple and useful abstraction based on Zeep SOAP client.

It doesn't depend on ancient VirtualBox Python SDK and even more ancient ZSI (last updated in 2006) and PyXML (thing from 2007) libraries.

The initial goal was to build an easy to use CuckooSandbox machinery.

VirtualBox Webservice

There is an official manual how to start it:

https://www.virtualbox.org/manual/ch09.html#vboxwebsrv-daemon

Install

pip install remotevbox --user

Development version

Pipenv is used here:

pipenv install

Usage example

>>> import remotevbox
>>> vbox = remotevbox.connect("http://127.0.0.1:18083", "vbox", "yourpassphrase")
>>> vbox.get_version()
'6.1.2'
>>> machine = vbox.get_machine("Windows10")
>>> machine.launch()
>>> screenshot_data = machine.take_screenshot_to_bytes()
>>> fp = open('screenshot.png', 'wb')
>>> fp.write(screenshot_data)
>>> fp.close()
>>> machine.save()
>>> vbox.disconnect()

About

:cake: Little package to do simple things with VirtualBox remotely using its SOAP API

License:GNU General Public License v3.0


Languages

Language:Python 100.0%