Tapo-ESP32

Unofficial Tapo API Client for ESP32.

Device support

• Supports Tapo P-series smart plugs and L-series smart lights.
• Compatible with the latest Tapo firmware that uses the KLAP algorithm.
• (Not supports Passthrough algorithm used in the older firmwares.)
• Simple, lightweight, and easy-to-use API.

Prerequisites

• Arduino IDE or PlatformIO.

Installation

Copy the following files into your project:

• tapo_device.h
• tapo_protocol.h
• tapo_cipher.h

Example

#include <Arduino.h>
#include <WiFi.h>

#define TAPO_DEBUG_MODE // Comment this line to disable debug messages
#include "tapo_device.h"

TapoDevice tapo;

void setup() {
    Serial.begin(115200);

    // Connect to WiFi
    WiFi.begin("wifi-ssid", "wifi-password");
    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }

    // Initialize Tapo device
    tapo.begin("device-ip-address", "tapo-username", "tapo-password");
    // Example: tapo.begin("192.168.1.100", "abc@example.com", "abc123");
}

void loop() {
    // === Common controls (Plugs & Lights) ===
    tapo.off(); // Turn the device OFF
    delay(3000);
    tapo.on(); // Turn the device ON
    delay(3000);

    // === Light-specific controls ===
    tapo.set_brightness(100);          // Set brightness (1–100%)
    tapo.set_color(0, 100);            // Set color: hue (0–360°), saturation (0–100%)
    tapo.set_color_temperature(2500);  // Set color temperature in Kelvin (e.g., 2500–6500)
    tapo.set_hue_saturation(120, 100); // Same as set_color()
}

Contributing

Contributions are welcome and encouraged!

Credits

Inspired by mihai-dinculescu/tapo.