Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/leny/vibox

Node.js cli helper for VirtualBox management
https://github.com/leny/vibox

Last synced: 7 days ago
JSON representation

Node.js cli helper for VirtualBox management

Awesome Lists containing this project

README

        

# vibox

![NPM version](http://img.shields.io/npm/v/vibox.svg) ![Dependency Status](https://david-dm.org/leny/vibox.svg) ![Downloads counter](http://img.shields.io/npm/dm/vibox.svg) [![No Maintenance Intended](http://unmaintained.tech/badge.svg)](http://unmaintained.tech/)

> 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] show information about specific VM
start [options] start VM
headless start VM headlessly (no GUI)
stop [options] stop VM (if ACPI support is enabled)
control 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.