What is ha-ecoplug?

HA-EcoPlug is a local integration for Home Assistant, the open source home automation platform, that lets you control ECO Plugs and Dewenwils Wi-Fi outlets and timers without any cloud service or account. It is installed through HACS, a popular add-on manager for Home Assistant. The main device it targets is the TM-050B, a Wi-Fi controlled pool pump timer, but it also works with related outlets sold under names like WiOn, Woods, Workchoice, and KAB. Once installed, each discovered plug shows up as a simple on and off switch in Home Assistant, along with an online or offline status. The integration talks directly to the plugs over the local network using their own protocol, so there is no dependency on the manufacturer's app or servers after initial setup. It automatically finds new plugs added later through the vendor app. There are two versions of the underlying protocol these plugs use, and this integration speaks both, defaulting to trying each automatically. Newer devices use an encrypted protocol called KAB, while older ones use a simpler legacy protocol. A troubleshooting section explains how to check which protocol your device uses if automatic detection has trouble. Because these plugs rely on local network broadcasts, Home Assistant needs to be on the same network segment as the plugs. If you use network segments or VLANs, there are optional settings to point the integration at the right network interface. Two things this integration cannot do: it cannot report power or energy usage, since the hardware has no metering chip, and it cannot manage the plug's built in timer schedules, since those are only accessible through the cloud app. Instead, the README recommends recreating any schedules directly inside Home Assistant, which the author says is more reliable and works entirely on your local network. The project is a near complete rewrite building on protocol reverse engineering from other open source projects, and it is released under the MIT license.