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

  npm install tp-link-tapo-connect

Usage

Discovery

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

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:

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:

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):

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

Load videos from tapo-care cloud

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

Migrating from version 1 to 2

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.

const deviceToken = await loginDeviceByIp(email, password, deviceIp);
await turnOn(deviceToken);

is now

const device = await loginDeviceByIp(email, password, deviceIp);
await device.turnOn();

Cloud passthrough

It is now possible to turn on & off devices using the cloud api (Doesn't require to be on the same network as the device). This functionality is limited at this time and only seems to work for older Kasa (HS100) devices.

const cloudApi = await cloudLogin(email, password);
    
const devices = await cloudApi.listDevicesByType('IOT.SMARTPLUGSWITCH');

const cloudDevice = cloudApi.getTapoDevice(devices[0]);
await cloudDevice.turnOn();

Tapo Hub device

Support for the Tapo Hub (H100) is now availaible and can be accessed as follows:

const device = await loginDeviceByIp(email, password, deviceIp);
await device.playAlarm(AlarmTone.DoorbellRing8, AlarmVolume.high);

const hubDevices = await device.getHubDevices();
const hubDeviceId = hubDevices[0].deviceId;
const eventLogs = await device.getEventLogs(hubDeviceId);

Credits

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/petretiandrea/plugp100