Skip to content
This repository has been archived by the owner on Dec 13, 2023. It is now read-only.

Commit

Permalink
Add README
Browse files Browse the repository at this point in the history
  • Loading branch information
langovoi committed Jan 13, 2019
1 parent aa6792b commit c668792
Showing 1 changed file with 54 additions and 0 deletions.
54 changes: 54 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# UPnP for Homebridge

[Universal Plug and Play (UPnP)](http://upnp.org/resources/documents/UPnP_UDA_tutorial_July2014.pdf) is a set of networking protocols that permits networked devices to seamlessly discover each other's presence on the network and establish functional network services.

## Supported devices types

### [MediaRenderer v1](http://upnp.org/specs/av/UPnP-av-MediaRenderer-v1-Device.pdf)

Most of Smart TV supports this device type.

It requires implementation of [RenderingControl v1](http://upnp.org/specs/av/UPnP-av-RenderingControl-v1-Service.pdf) service,
which allow control Volume and Mute states.

Current implementation of plugin automatically discover UPnP devices and add Lightbulb accessory
which allow to control Volume by slider and mute by on/off.


## Install

```bash
$ npm install -g homebridge-upnp
```

## Usage

Simply add to your Homebridge config new platform called "UPnP" and restart Homebridge.

```json
{
"platforms": [
{
"platfrom": "UPnP"
}
]
}
```

Also you can provide custom config for [upnp-device-client](https://github.com/langovoi/node-upnp-device-client#readme) by `ssdpClient` and `ssdpServer` options:

```json
{
"platforms": [
{
"platfrom": "UPnP",
"ssdpClient": {
"interfaces": ["br0"]
},
"ssdpServer": {
"interfaces": ["br0"]
}
}
]
}
```

0 comments on commit c668792

Please sign in to comment.