# mewo

> A node-based WeMo emulator intended for use with the Amazon Echo

Latest version **1.2.1** (published 2019-03-05) · WTFPL license · 0 weekly downloads

## Install

```sh
npm install mewo
pnpm add mewo
yarn add mewo
bun add mewo
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.1 |
| Published | 2019-03-05 |
| First published | 2016-06-05 |
| Weekly downloads | 0 |
| License | WTFPL |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 13.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Matt Hackmann |
| Maintainers | dxprog |
| Keywords | echo, alexa, javascript, node |

## Links

- npm: https://www.npmjs.com/package/mewo
- npm.io page: https://npm.io/package/mewo

## Dependencies (4)

- [bluebird](https://npm.io/package/bluebird.md) ^3.5.1
- [freeport](https://npm.io/package/freeport.md) ^1.0.5
- [node-uuid](https://npm.io/package/node-uuid.md) ^1.4.7
- [handlebars](https://npm.io/package/handlebars.md) ^4.0.5

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 1.2.1 (latest) — 2019-03-05
- 1.2.0 — 2018-02-23
- 1.1.1 — 2018-01-10
- 1.1.0 — 2018-01-10
- 1.0.0 — 2016-06-05

## README

# MeWo

A node-based WeMo emulator intended for use with the Amazon Echo. Largely ported from the python [fauxmo](https://github.com/makermusings/fauxmo).

## What?

MeWo is the jumping off point for building custom on/off home automation scripts in node. It provides an interface for connecting to an Amazon Echo and performing whatever (on/off) tasks you want.

## Installation

You will need to be running node 6 or later as MeWo makes use of ES6 features.

`npm install --save mewo`

## Example Usage

```javascript

const { UPnpBroadcastResponder, MeWoDevice } = require('mewo');

class MyUPnpDevice extends MeWoDevice {
  constructor(...args) {
    // Super must be called
    super(...args);
  }

  // Called when "alexa turn 'device' on" is said
  on() {
    return new Promise((resolve, reject) => {
      resolve();
    });
  }

  // Called when "alexa turn 'device' off" is said
  off() {
    return new Promise((resolve, reject) => {
      // Do something when the device is turned off
      resolve();
    });
  }
}

const responder = new UPnpBroadcastResponder();
responder.init({
  // These are the default options
  port: 1900,
  iface: 'eth0',

  // You may need to play around with this...
  multicastAddress: '239.11.3.8'
}).then(() => {
  // Create the new device with a name that will show up in the Alexa app
  const myDevice = new MyUPnpDevice('my-upnp-device', responder);
  // Register with the UPnP responder
  responder.registerDevice(myDevice);
});
```

---
_Source: https://npm.io/package/mewo · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
