vibox

Node.js cli helper for VirtualBox management

Usage no npm install needed!

<script type="module">
  import vibox from 'https://cdn.skypack.dev/vibox';
</script>

README

vibox

NPM version Dependency Status Downloads counter

Node.js cli helper for VirtualBox management


vibox is a simple manager for your VirtualBoxes' VMs.

In facts, it's just a wrapper over VBoxManage, but simplier and with completion (if you enable it).

Getting Started

Install the module with: npm install vibox

To take the benefits of completion, add the following line to your .profile, or .bash_rc, or whatever : which vibox > /dev/null && . "$( vibox --initpath )"

Usage

vibox [options] [command]

Commands:

    list [options]					list VMs
    show [options] <uid|name> 		show information about specific VM
    start [options] <uid|name> 		start VM
    headless <uid|name>             start VM headlessly (no GUI)
    stop [options] <uid|name> 		stop VM (if ACPI support is enabled)
    control <uid|name> <action> 	control VM (start|headless|pause|resume|stop|reset|poweroff)

Options:

    -h, --help     output usage information
    -V, --version  output the version number

History

v0.0.3 (09/05/13): Add headless command & completions for control subcommands

Next…

However it's functionnal, there still some work to do : error handlers, some optimization.

In the future, i'll probably add support to more commands of VBoxManage.

License

Copyright (c) 2013 Leny (http://flatland.be)

Licensed under the MIT license.


ps: I am very sorry for my horrible english (I came from Belgium, I speak french). I will correct this document soon.