Skip to content

Unofficial TP-Link Tapo smart device library for C#.

Notifications You must be signed in to change notification settings

cwakefie27/TapoConnect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TapoConnect

Unofficial TP-Link Tapo smart device library for C#.

NuGet version (TapoConnect)

Tested With

Examples

As of firmware 1.1.0 Build 230721 Rel.224802, KLAP protocol is being used over the secure pass-through protocol. As a result, this API has to attempt to login with one protocol then fallback to the other. By default, KLAP protocol will be used first since it is the new standard.

Build clients to interact with Tapo Cloud or smart device.

TapoCloudClient cloudClient = new TapoCloudClient();
TapoDeviceClient deviceClient = new TapoDeviceClient();

//Specify order of login protocols to try.
TapoDeviceClient deviceClient = new TapoDeviceClient(new List<ITapoDeviceClient>
{
	new KlapDeviceClient(),
	new SecurePassthroughDeviceClient(),
});

Get devices from cloud.

CloudLoginResult cloudKey = await cloudClient.LoginAsync("<Username>", "<Password>");
CloudListDeviceResult deviceResult = await cloudClient.ListDevicesAsync(cloudKey.Token);

Select devices by type.

IEnumerable<TapoDeviceDto> devices = deviceResult.DeviceList
    .Where(x => x.DeviceType == TapoUtils.TapoBulbDeviceType);

Select device by alias.

TapoDeviceDto device = deviceResult.DeviceList.First(x => x.Alias == "<Device Name>")

Login to device by known IP address.

TapoDeviceKey deviceKey = await deviceClient.LoginByIpAsync("<Username>", "<Password>", "<IpAddress>");

Login to device by known MAC address (finds the MAC address on local network through a Windows ARP request).

string ip = TapoUtils.GetIpAddressByMacAddress(device.DeviceMac);
TapoDeviceKey deviceKey = await deviceClient.LoginByIpAsync("<Username>", "<Password>", ip);

Get Device info.

DeviceGetInfoResult deviceInfo = await deviceClient.GetDeviceInfoAsync(deviceKey);

Set Device's power, brightness, color, and state.

await deviceClient.SetPowerAsync(deviceKey, true);

await deviceClient.SetBrightnessAsync(deviceKey, 80);

await deviceClient.SetColorAsync(deviceKey, TapoColor.FromHex("#e8d974"));
await deviceClient.SetColorAsync(deviceKey, TapoColor.FromHsl(200, 100, 100));
await deviceClient.SetColorAsync(deviceKey, TapoColor.FromRgb(100, 25, 32));
await deviceClient.SetColorAsync(deviceKey, TapoColor.FromTemperature(3500));

await deviceClient.SetStateAsync(deviceKey, new TapoSetBulbState(
    color: TapoColor.FromTemperature(3800, brightness: 1),
    deviceOn: true));

Disclaimer

This is an unofficial SDK that has no affiliation with TP-Link. TP-Link and all respective product names are copyright TP-Link Technologies Co, Ltd. and/or its subsidiaries and affiliates.

Credits

Credit to this API go to:

Many thanks to @fishbigger, @K4CZP3R, and others involved for reverse enginering TP-link Tapo API in this post.

For more details, @K4CZP3R has a post on the process of reverse enginering the API.

About

Unofficial TP-Link Tapo smart device library for C#.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages