README

fxos-start

Start a FirefoxOS simulator if no simulator is running.

Install

# Library
$ npm install fxos-start

# Command line
$ npm install -g fxos-start

Usage

Usage: fxos-start [options]

Options:
   -p, --port                   Port of FirefoxOS
   -f, --force                  Kill other simulators on this port
   --verbose                    Set the output level to verbose
   --bin                        Set external B2G bin
   --profile                    Set external B2G profile
   --release <release>          Release of FirefoxOS to filter
   --exit                       Exit after startup
   --stdin <stdin filepath>     The path where stdin of the simulator will be redirected to
   --stdout <stdout filepath>   The path where stdout of the simulator will be redirected to
   --stderr <stderr filepath>   The path where stderr of the simulator will be redirected to
   --timeout                    The timeout time to wait for a response from the Simulator.
   --version                    Print version and exit

Start a simulator on known port, connect and return client

Start a FirefoxOS simulator and connect to it through firefox-client by returning client.

var start = require('fxos-start');
start({port:1234}, function(err, client) {
  // Let's show for example all the running apps
  client.getWebapps(function(err, webapps) {
    webapps.listRunningApps(function(err, apps) {
      console.log("Running apps:", apps);
    });
  });
})

Start a simulator on known port without connecting

Just start a FirefoxOS simulator without opening a connection:

var start = require('fxos-start');
start({port:1234, connect:false}, function(err) {
  // Let's show for example all the running apps
  client.connect(1234, function() {
    client.getWebapps(function(err, webapps) {
      webapps.listRunningApps(function(err, apps) {
        console.log("Running apps:", apps);
      });
    });
  });
})

Start a simulator on any port

Just start a without opening a connection:

var start = require('fxos-start');
start(function(err, client) {
  // Let's show for example all the running apps

  client.getWebapps(function(err, webapps) {
    webapps.listRunningApps(function(err, apps) {
      console.log("Running apps:", apps);
    });
  });
})

Usage with command line

$ fxos-start
Firefox Simulator started on port 8901

$ fxos-start -p 8001
Firefox Simulator started on port 8001

Usage no npm install needed!