Node.js cli helper for VirtualBox management
JavaScript CoffeeScript Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
bin
shell
src
.gitignore
.jshintrc
.travis.yml
Gruntfile.coffee
LICENSE-MIT
README.md
package.json

README.md

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.