weinre - Installing

clone weinre at apache

# weinre - Installing

weinre is implemented as a node.js application, and so you'll need to download and install a node runtime to run weinre.

To install weinre, use `npm`, or download a binary package. weinre is not sensitive to the directory it's installed in, and does not write to any files.

## npm installation

weinre can be installed as an npm package. The `*-bin.tar.gz` urls/files for binary packages can be used as a target of the `npm install` command.

It's likely you will want to install weinre globally instead of locally (in the `npm` sense), which means you will typically want to use the `npm -g` option to install. For *ix and Mac, this also means prefixing your command with sudo. For Windows, AFAIK, you don't need sudo or any equivalent.

Here's an example of installing from a binary package via URL:

    sudo npm -g install http://example.com/path/to/apache-cordova-weinre-X.Y.Z-bin.tar.gz

weinre is also deployed on https://npmjs.org/package/weinre so that you can install it via:

    sudo npm -g install weinre

## Binary Packages

Unofficial binary packages for your convenience:

- http://people.apache.org/~pmuellr/weinre/

The binary packages available are:

- `apache-cordova-weinre-{version}-bin.tar.gz`
- `apache-cordova-weinre-{version}-bin.zip`
- `apache-cordova-weinre-{version}-doc.tar.gz`
- `apache-cordova-weinre-{version}-doc.zip`
- `apache-cordova-weinre-{version}-src.tar.gz`
- `apache-cordova-weinre-{version}-src.zip`

The difference between the `.tar.gz` and `.zip` archives is the archive format only. When expanded, both archives produce the same files.

The `doc` archives contain the stand-alone HTML documentation

The `src` archives contain the ready-to-rebuild source

The `bin` archives contain the ready-to-run binaries

If the `{version}` contains a moniker like `pre`, this is indicative of an unofficial, non-final binary package for your convenience, as opposed to an official release.