by xdissent

xdissent / iectrl

Command line interface and Node module for managing ievms virtual machines

204 Stars 17 Forks Last release: Not found MIT License 68 Commits 6 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Command line interface and Node module for managing ievms virtual machines.

NPM version


For ievms:

  • VirtualBox
  • Curl (Ubuntu:
    sudo apt-get install curl
  • Linux Only: unar (Ubuntu:
    sudo apt-get install unar

For iectrl:



$ sudo npm install -g iectrl


$ npm install iectrl


Command Line Interface


command provides various sub-commands for manipulating one or many ievms virtual machines. The optional
argument may be a comma-separated (no spaces) list of virtual machine identifiers. The identifiers consist of a number representing a given version of IE, an OS name (
), or an exact virtual machine name (
IE6 - WinXP
IE7 - Vista
). See
iectrl  --help
for more information:
$ iectrl --help

Usage: iectrl [options] [command]


clean [names] restore virtual machines to the clean snapshot
close [names] close all running IE processes in virtual machines
install [options] [names] install virtual machines with ievms
nuke [names] remove all traces of virtual machines
list         list available virtual machines
open [options] [names] [url] open a URL in IE
rearm [options] [names] rearm virtual machines
reinstall [options] [names] reinstall virtual machines
restart [options] [names] restart virtual machines
screenshot [names] [output] save screenshots for virtual machines
shrink [options] [names] shrink disk usage for virtual machines
start [options] [names] start virtual machines
status [options] [names] report the status of one or more vms
stop [options] [names] stop virtual machines
uninstall [options] [names] uninstall virtual machines
uploaded [names] report the last time the VM was uploaded to


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

Node Module

See the annotated source or karma-ievms for usage examples.


Install all

virtual machines from ievms (
IE6 - WinXP
IE7 - WinXP
IE8 - WinXP
$ iectrl install WinXP

Reinstall all

virtual machines, plus IE 6 (
IE6 - WinXP
$ iectrl reinstall 6,Win7

Shrink the disk usage for IE10 by removing the

file used during install:
$ iectrl shrink 10

Open IE version 6 and 8 and navigate to
auto-starting the virtual machines if necessary:
$ iectrl open -s 6,8

Take a screenshot of the

IE7 - Vista
virtual machine, saving it to
./shots/IE7 - Vista.png
$ iectrl screenshot 'IE7 - Vista' ./shots

Close all open IE browser windows:

$ iectrl close

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.