Tapogo

A golang library (and CLI) to control your Tapo SmartPlugs P100 / P110 with latest firmware versions

At this moment, the library is not covering the whole API as it is discovered by reverse engineering If you want to cover more things, consider contributing

Motivation

I own several Tapo P100/P110 at home to control some appliances using custom automations for example for the heater. Honestly, I completely forgot to disable firmware updates, and before Matter disabling updates is almost a requirement as automation manufacturers tends to modify their closed APIs in a way they change almost everything from time to time, forcing you to do some reverse engineering.

As you can imagine, this project was created because of that, when some days ago, TPLink decided to switch from securePassthrough protocol to KLAP on P100 / P110 plugs, and the library I use under the hood does not seem to be actively maintained, so I decided to research and craft a new one on my own.

This library does not pretend to cover all devices, not even all the protocol versions, but always the latest ones. As the project will use releases, you can select which version fit your needs

Library

    import (
        "github.com/achetronic/tapogo/pkg/tapogo"
    )

    var tapoClient  *tapogo.Tapo
    var err error

    tapoClient, err = tapogo.NewTapo("192.168.0.100", "username", "password", &tapogo.TapoOptions{})

    // Perform actions over the plug
    response, err := tapoClient.TurnOn()
    response, err  = tapoClient.TurnOff()

    // Get data from device
    response, err  = tapoClient.GetEnergyUsage()
    response, err  = tapoClient.DeviceInfo()

CLI

go install github.com/achetronic/tapogo

Usage

tapogo <ip-address> <username> <password> [on, off, energy-usage, device-info]

For example:

tapogo 192.168.0.100 email@address thepassword energy-usage
{
  "error_code": 0,
  "result": {
    "current_power": 0,
    ...
    "month_energy": 10000,
    "month_runtime": 10000,
    "today_energy": 400,
    "today_runtime": 300
  }
}

How to contribute

Of course, we are open to external collaborations for this project. For doing it you must:

Open an issue to discuss what is needed and the reason
Fork the repository
Make your changes to the code
Open a PR. The code will be reviewed and tested (always)

We are developers and hate bad code. For that reason we ask you the highest quality on each line of code to improve this project on each iteration.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Special mention

This project was done using IDEs from JetBrains. They helped us to develop faster, so we recommend them a lot! 🤓

kabukky/tapogo