TP-Link Tapo Connect

Unofficial Node.js library for connecting to TP-Link Tapo devices. Currently limited to the:
- P100, P105, P110, P115 smart plugs
- L510E, L530E smart bulbs
- L900-10 smart strip
- P300 smart plug strip
- IP cameras like C320WS

Installation Instructions

``bash
npm install tp-link-tapo-connect
`




Usage

$3

In order to discover your devices it is advisable to login to your TP-Link account and call the listDevices function. To do this:

`ts
const cloudApi = await cloudLogin(email, password);

const devices = await cloudApi.listDevicesByType('SMART.TAPOPLUG');
`

Once you have determined which device you wish to use. You can enquire of its current state using:

`ts
const device = await loginDevice(email, password, devices[0]); // Performs a mac lookup to determine local IP address
// OR
const device = await loginDeviceByIp(email, password, deviceIp); // If you know your local device IP address

const getDeviceInfoResponse = await device.getDeviceInfo();
console.log(getDeviceInfoResponse);
`

To change the device state e.g. turn it on or off use:

`ts
await device.turnOn();
await device.setBrightness(75); // Sets brightness to 75% for smart bulbs only
await device.turnOff();
`

Changing the bulb colour (Colour smart bulbs only):

`ts
await device.turnOn();
await device.setColour('white'); // Sets the colour for colour smart bulbs only
await device.setColour('#FF00FF'); // Sets the colour for colour smart bulbs only using a hex value
await device.turnOff();
`

#### Available Preset Colours

||
| :-: |
| white |
| warmwhite |
| daylightwhite |
| blue |
| red |
| green |
| yellow |




$3


`ts
const cloudVideos = await cloudApi.tapoCareCloudVideos(deviceId); //deviceId from listDevicesByType
`

$3

Version 2 favours returning a device object that has the necessary functions to manipulate the device rather
than passing the device/cloud token.

e.g.
`ts
const deviceToken = await loginDeviceByIp(email, password, deviceIp);
await turnOn(deviceToken);
`
is now
`ts
const device = await loginDeviceByIp(email, password, deviceIp);
await device.turnOn();
``

$3

Credit to this API go to:
* https://github.com/fishbigger/TapoP100
* https://github.com/K4CZP3R/tapo-p100-java-poc
* https://gist.github.com/chriswheeldon/3b17d974db3817613c69191c0480fe55
* https://github.com/mihai-dinculescu/tapo