Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build Status npm version


Fake WeMo device ported to NodeJS. Allows Alexa to make api calls.

Based on the work of makermusings and n8henrie but written from scratch for NodeJS.

What does it do?

This service will setup the required UDP listener and HTTP listeners that support the SSDP that Amazon Echo (Alexa) uses in order to discover Belkin WeMo smart switches.

With this module you can hook up your own NodeJS code to run in response to an Alexa command such as: "Alexa, turn office light on". In this statement office light is the device name and on is the action.


npm install fauxmojs

How do I use it?

Usage is simple. The heavy lifting is handled by this library so that all you need to do is create a new FauxMo class and pass in some options.

Below is a fully working example of two virtual devices. To use the first device through Alexa simply run the example and say "Alexa, turn office light on".

'use strict';

const FauxMo = require('fauxmojs');

let fauxMo = new FauxMo(
    ipAddress: '',
    devices: [
        name: 'office light',
        port: 11000,
        handler: (action) => {
          console.log('office light action:', action);
        name: 'office fan',
        port: 11001,
        handler: (action) => {
          console.log('office fan action:', action);
        name: 'kitchen light',
        port: 11002,
        handler: (action, name, callback) => {
          console.log('kitchen light action:', action);
          let status = action === 'on' ? true : false;



ipAddress - this is the ip address of the computer running FauxMo.

devices - an array of device definitions (see below).

The device object needs the following properties:

name - the name of the device, this is the name you will use when asking Alexa to control the device. E.g. if your name is office light you will say 'Alexa, turn office light on'.

port - each fake device needs to have a unique port. The amazon echo does not send back the device id in the action requests so the device is determined by the port number. FauxMo listens for actions on each device port.

handler - a function that will be called when the echo is attempting to perform the action. This functions first parameter 'action' which, when called, will be on or off or status. The second parameter is the device name e.g office light. The third parameter is a callback function that responds to Alexa with the device status true or false.


Fake WeMo device ported to NodeJS. Allows Alexa (Amazon Echo) to make api calls.






No packages published