vbox_vm_multistart

This script allows you to easily launch multiple encrypted VMs in VirtualBox.

Installation:

git clone https://github.com/Bay40k/vbox_vm_multistart
cd vbox_vm_multistart
pip install -r requirements.txt

Usage:

from pathlib import Path
import tempfile, os
from getpass import getpass
import vbox_vm_multistart
from vbox_vm_multistart import VBoxVM

# Set a VBoxManage.exe path other than default (this is the default)
vbox_path = Path("C:/Program Files/Oracle/VirtualBox")
vbox_vm_multistart.vboxmanage_path = Path(vbox_path / "vboxmanage.exe").resolve()

# Enable logging and set Loguru log level. Log format can also be defined with log_format=.
# https://loguru.readthedocs.io/en/stable/api/logger.html#levels
vbox_vm_multistart.enable_logging(log_level="DEBUG")

# Obtain password
password = getpass()

# Create temp file, write password to it.
temp_file = tempfile.NamedTemporaryFile(delete=False)
temp_file.write(bytes(password, encoding="UTF-8"))
temp_file.close()

# List of VBoxVM objects.
vms = [
    VBoxVM(name="vm-1", headless=True, encrypted=True, password_file=temp_file),
    VBoxVM(name="vm-2", encrypted=True, password_file=temp_file),
    # "headless" & "encrypted" default to False, "password_file" not needed unless encrypted.
    VBoxVM(name="vm-3")
]

try:
    vbox_vm_multistart.run(vms=vms)

except Exception as e:
    raise e

finally:
    # Delete temp file if successful or exception.
    os.unlink(temp_file.name)

Other potentially useful functions:

vbox_vm_multistart.start_all_vms(vms=vms)
vbox_vm_multistart.kill_all_vms(vms=vms)

vms[0].start()
vms[0].kill()

Example output:

Password:
11/25/2021 07:09:15 | INFO | Starting VM: 'vm-1'
11/25/2021 07:09:15 | DEBUG | "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" startvm "vm-1" --type headless
11/25/2021 07:09:23 | INFO | VBoxManage.exe: Waiting for VM "vm-1" to power on...
VM "vm-1" has been successfully started.
11/25/2021 07:09:23 | DEBUG | "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" controlvm "vm-1" addencpassword "vm-1" "%TEMP%\tmpf_iu9sol"
11/25/2021 07:09:23 | DEBUG | "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" controlvm "vm-1" reset
11/25/2021 07:09:23 | INFO | Starting VM: 'vm-2'
11/25/2021 07:09:23 | DEBUG | "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" startvm "vm-2" 
11/25/2021 07:09:32 | INFO | VBoxManage.exe: Waiting for VM "vm-2" to power on...
VM "vm-2" has been successfully started.
11/25/2021 07:09:33 | DEBUG | "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" controlvm "vm-2" addencpassword "vm-2" "%TEMP%\tmpf_iu9sol"
11/25/2021 07:09:33 | DEBUG | "C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" controlvm "vm-2" reset
Kill VMS? Y/n
> n
Done, press enter to continue

No log output:

Password:
Kill VMS? Y/n
> n
Done, press enter to continue