Grunt task to run a weinre server to debug your mobile web site/app.
Last updated 6 years ago by chriswren .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install grunt-weinre 
SYNC missed versions from official npm registry.


Run weinre as a grunt task for easy configuration and integration with the rest of your workflow

NPM version Dependency Status

Getting Started

If you haven't used grunt before, be sure to check out the Getting Started guide, as it explains how to create a gruntfile as well as install and use grunt plugins. Once you're familiar with that process, install this plugin with this command:

npm install grunt-weinre --save-dev

Then add this line to your project's Gruntfile.js gruntfile:




The minimal usage of weinre runs with no options:

weinre: {
  dev: {}

Recommended Usage

The default HTTP port of 8080 is pretty popular, so offsetting it by 2 may help you dodge a collision. Also setting the boundHost to -all- will let your mobile devices connect via your local ip address, since the default localhost won't work for them.

weinre: {
  dev: {
    options: {
      httpPort: 8082,
      boundHost: '-all-'

Usage with all available options(with their default values):

weinre: {
  dev: {
    options: {
      httpPort: 8080,
      boundHost: 'localhost',
      verbose: false,
      debug: false,
      readTimeout: 5,
      deathTimeout: 15

Running weinre concurrently

A common use case is to run weinre with other tasks concurrently. This can be achieved with the following config for the grunt-concurrent plugin which runs weinre, nodemon, node-inspector, and watch in a single terminal tab:

concurrent: {
  dev: {
    tasks: ['weinre', 'nodemon', 'node-inspector', 'watch'],
    options: {
      logConcurrentOutput: true



Type: Number Default: 8080

Port to run the http server on.


Type: String Default: 'localhost'

IP address to bind the server to.


Type: Boolean Default: false

Print more diagnostics.


Type: Boolean Default: false

Print even more diagnostics.


Type: Number Default: 5

Seconds to wait for a client message.


Type: Number Default: 3 * readTimeout

Seconds to wait to kill client.


0.0.2 - Fixed error logging, allowed weinre to be listed as an app dependency.

0.0.1 - Initial release.

Current Tags

  • 0.0.3                                ...           latest (6 years ago)

3 Versions

  • 0.0.3                                ...           6 years ago
  • 0.0.2                                ...           7 years ago
  • 0.0.1                                ...           7 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 2
Dependencies (1)
Dev Dependencies (5)
Dependents (2)

Copyright 2014 - 2016 © |