Skip to content

ZeliardM/homebridge-kasa-python

Repository files navigation

Homebridge Kasa Python Plug-In

mit license latest npm version latest PyPI pyversions beta npm version beta PyPI pyversions npm downloads total donate donate homebridge verified

IMPORTANT!!!

With v2.7.0, Support for anything less than Python v3.11 will be dropped.

This is a Homebridge plug-in based on the Python-Kasa API Library to interact with TP-Link Kasa/Tapo Devices.

This plug-in will automatically discover your TP-Link Kasa/Tapo Devices on your network locally only and configure them to be used in HomeKit.

Automatic Discovery may be possible only for some devices. If your device is not discovered automatically, try adding the IP Address into the Manual Devices List. Some newer devices require the Username and Password for your TP-Link Kasa/Tapo Cloud Account. Credentials can be enabled and provided in the plug-in settings.

Current Supported and Tested Devices

  • I currently have used this plug-in with the HS300 (US) Power Strip and the KP115 (US) Plug. All other devices are yet to be tested and fully supported. If you have a device that is a plug or power strip and it does work as expected in HomeKit, please let me know and I can add it to the list of tested and supported devices. I don't have a lot of devices so cannot fully test everything.

Features

  • Automatically discover TP-Link Kasa/Tapo Devices locally only on your network.
  • Currently only Plugs, Power Strips, Wall Switches, Bulbs, and Light Strips are supported by the plug-in and added to Homebridge.
  • This plug-in will by default filter out Native HomeKit/Matter Devices, this can be disabled to implement all supported devices on the network if desired.
  • Change Device States for Plugs, Change Device States for Power Strips, Change Device State and Supports Dimming for Wall Switches, Change Device State and Supports Hue, Saturation, and Value (HSV) and Color Temperature Adjustments, and Dimming for Bulbs and Light Strips that support those options. The KS240 Dual Fan and Light Dimmer Wall Switch is also supported if Native HomeKit/Matter Device Filtering is Disabled.
  • Supported Devices from the API are listed below, Devices with an asterisks ('*') next to the specific firmware will require the Username and Password for your TP-Link Kasa/Tapo Cloud Account to connect and function correctly. If your device is not listed below, it does not mean it won't work, but there may be issues.

    NOTE - Not All Devices Listed Below Are Supported By This Plug-In. These Devices Are Supported By The Python-Kasa API Library And Could Be Supported By The Plug-In In The Future.

Kasa devices

Some newer Kasa devices require authentication. These are marked with [*] in the list below.
Hub-Connected Devices may work across TAPO/KASA branded hubs even if they don't work across the native apps.

Plugs

  • EP10
    • Hardware: 1.0 (US) / Firmware: 1.0.2
  • EP25
    • Hardware: 2.6 (US) / Firmware: 1.0.1[*]
    • Hardware: 2.6 (US) / Firmware: 1.0.2[*]
  • HS100
    • Hardware: 1.0 (UK) / Firmware: 1.2.6
    • Hardware: 4.1 (UK) / Firmware: 1.1.0[*]
    • Hardware: 1.0 (US) / Firmware: 1.2.5
    • Hardware: 2.0 (US) / Firmware: 1.5.6
  • HS103
    • Hardware: 1.0 (US) / Firmware: 1.5.7
    • Hardware: 2.1 (US) / Firmware: 1.1.2
    • Hardware: 2.1 (US) / Firmware: 1.1.4
  • HS105
    • Hardware: 1.0 (US) / Firmware: 1.5.6
  • HS110
    • Hardware: 1.0 (EU) / Firmware: 1.2.5
    • Hardware: 4.0 (EU) / Firmware: 1.0.4
    • Hardware: 1.0 (US) / Firmware: 1.2.6
  • KP100
    • Hardware: 3.0 (US) / Firmware: 1.0.1
  • KP105
    • Hardware: 1.0 (UK) / Firmware: 1.0.5
    • Hardware: 1.0 (UK) / Firmware: 1.0.7
  • KP115
    • Hardware: 1.0 (EU) / Firmware: 1.0.16
    • Hardware: 1.0 (US) / Firmware: 1.0.17
    • Hardware: 1.0 (US) / Firmware: 1.0.21
  • KP125
    • Hardware: 1.0 (US) / Firmware: 1.0.6
  • KP125M
    • Hardware: 1.0 (US) / Firmware: 1.1.3[*]
    • Hardware: 1.0 (US) / Firmware: 1.2.3[*]
  • KP401
    • Hardware: 1.0 (US) / Firmware: 1.0.0

Power Strips

  • EP40
    • Hardware: 1.0 (US) / Firmware: 1.0.2
  • EP40M
    • Hardware: 1.0 (US) / Firmware: 1.1.0[*]
  • HS107
    • Hardware: 1.0 (US) / Firmware: 1.0.8
  • HS300
    • Hardware: 1.0 (US) / Firmware: 1.0.10
    • Hardware: 1.0 (US) / Firmware: 1.0.21
    • Hardware: 2.0 (US) / Firmware: 1.0.12
    • Hardware: 2.0 (US) / Firmware: 1.0.3
  • KP200
    • Hardware: 3.0 (US) / Firmware: 1.0.3
  • KP303
    • Hardware: 1.0 (UK) / Firmware: 1.0.3
    • Hardware: 2.0 (US) / Firmware: 1.0.3
    • Hardware: 2.0 (US) / Firmware: 1.0.9
  • KP400
    • Hardware: 1.0 (US) / Firmware: 1.0.10
    • Hardware: 2.0 (US) / Firmware: 1.0.6
    • Hardware: 3.0 (US) / Firmware: 1.0.3
    • Hardware: 3.0 (US) / Firmware: 1.0.4

Wall Switches

  • ES20M
    • Hardware: 1.0 (US) / Firmware: 1.0.11
    • Hardware: 1.0 (US) / Firmware: 1.0.8
  • HS200
    • Hardware: 2.0 (US) / Firmware: 1.5.7
    • Hardware: 3.0 (US) / Firmware: 1.1.5
    • Hardware: 5.0 (US) / Firmware: 1.0.11
    • Hardware: 5.0 (US) / Firmware: 1.0.2
    • Hardware: 5.26 (US) / Firmware: 1.0.3[*]
  • HS210
    • Hardware: 1.0 (US) / Firmware: 1.5.8
    • Hardware: 2.0 (US) / Firmware: 1.1.5
    • Hardware: 3.0 (US) / Firmware: 1.0.10
  • HS220
    • Hardware: 1.0 (US) / Firmware: 1.5.7
    • Hardware: 2.0 (US) / Firmware: 1.0.3
    • Hardware: 3.26 (US) / Firmware: 1.0.1[*]
  • KP405
    • Hardware: 1.0 (US) / Firmware: 1.0.5
    • Hardware: 1.0 (US) / Firmware: 1.0.6
  • KS200
    • Hardware: 1.0 (US) / Firmware: 1.0.8
  • KS200M
    • Hardware: 1.0 (US) / Firmware: 1.0.10
    • Hardware: 1.0 (US) / Firmware: 1.0.11
    • Hardware: 1.0 (US) / Firmware: 1.0.12
    • Hardware: 1.0 (US) / Firmware: 1.0.8
  • KS205
    • Hardware: 1.0 (US) / Firmware: 1.0.2[*]
    • Hardware: 1.0 (US) / Firmware: 1.1.0[*]
  • KS220
    • Hardware: 1.0 (US) / Firmware: 1.0.13
  • KS220M
    • Hardware: 1.0 (US) / Firmware: 1.0.4
  • KS225
    • Hardware: 1.0 (US) / Firmware: 1.0.2[*]
    • Hardware: 1.0 (US) / Firmware: 1.1.0[*]
  • KS230
    • Hardware: 1.0 (US) / Firmware: 1.0.14
    • Hardware: 2.0 (US) / Firmware: 1.0.11
  • KS240
    • Hardware: 1.0 (US) / Firmware: 1.0.4[*]
    • Hardware: 1.0 (US) / Firmware: 1.0.5[*]
    • Hardware: 1.0 (US) / Firmware: 1.0.7[*]

Bulbs

  • KL110
    • Hardware: 1.0 (US) / Firmware: 1.8.11
  • KL120
    • Hardware: 1.0 (US) / Firmware: 1.8.11
    • Hardware: 1.0 (US) / Firmware: 1.8.6
  • KL125
    • Hardware: 1.20 (US) / Firmware: 1.0.5
    • Hardware: 2.0 (US) / Firmware: 1.0.7
    • Hardware: 4.0 (US) / Firmware: 1.0.5
  • KL130
    • Hardware: 1.0 (EU) / Firmware: 1.8.8
    • Hardware: 1.0 (US) / Firmware: 1.8.11
  • KL135
    • Hardware: 1.0 (US) / Firmware: 1.0.15
    • Hardware: 1.0 (US) / Firmware: 1.0.6
  • KL50
    • Hardware: 1.0 (US) / Firmware: 1.1.13
  • KL60
    • Hardware: 1.0 (UN) / Firmware: 1.1.4
    • Hardware: 1.0 (US) / Firmware: 1.1.13
  • LB110
    • Hardware: 1.0 (US) / Firmware: 1.8.11

Light Strips

  • KL400L5
    • Hardware: 1.0 (US) / Firmware: 1.0.5
    • Hardware: 1.0 (US) / Firmware: 1.0.8
  • KL420L5
    • Hardware: 1.0 (US) / Firmware: 1.0.2
  • KL430
    • Hardware: 2.0 (UN) / Firmware: 1.0.8
    • Hardware: 1.0 (US) / Firmware: 1.0.10
    • Hardware: 2.0 (US) / Firmware: 1.0.11
    • Hardware: 2.0 (US) / Firmware: 1.0.8
    • Hardware: 2.0 (US) / Firmware: 1.0.9

Hubs

  • KH100
    • Hardware: 1.0 (EU) / Firmware: 1.2.3[*]
    • Hardware: 1.0 (EU) / Firmware: 1.5.12[*]
    • Hardware: 1.0 (UK) / Firmware: 1.5.6[*]

Hub-Connected Devices

  • KE100
    • Hardware: 1.0 (EU) / Firmware: 2.4.0[*]
    • Hardware: 1.0 (EU) / Firmware: 2.8.0[*]
    • Hardware: 1.0 (UK) / Firmware: 2.8.0[*]

Tapo devices

All Tapo devices require authentication.
Hub-Connected Devices may work across TAPO/KASA branded hubs even if they don't work across the native apps.

Plugs

  • P100
    • Hardware: 1.0.0 (US) / Firmware: 1.1.3
    • Hardware: 1.0.0 (US) / Firmware: 1.3.7
    • Hardware: 1.0.0 (US) / Firmware: 1.4.0
  • P110
    • Hardware: 1.0 (EU) / Firmware: 1.0.7
    • Hardware: 1.0 (EU) / Firmware: 1.2.3
    • Hardware: 1.0 (UK) / Firmware: 1.3.0
  • P110M
    • Hardware: 1.0 (AU) / Firmware: 1.2.3
    • Hardware: 1.0 (EU) / Firmware: 1.2.3
  • P115
    • Hardware: 1.0 (EU) / Firmware: 1.2.3
    • Hardware: 1.0 (US) / Firmware: 1.1.3
  • P125M
    • Hardware: 1.0 (US) / Firmware: 1.1.0
  • P135
    • Hardware: 1.0 (US) / Firmware: 1.0.5
    • Hardware: 1.0 (US) / Firmware: 1.2.0
  • TP15
    • Hardware: 1.0 (US) / Firmware: 1.0.3

Power Strips

  • P210M
    • Hardware: 1.0 (US) / Firmware: 1.0.3
  • P300
    • Hardware: 1.0 (EU) / Firmware: 1.0.13
    • Hardware: 1.0 (EU) / Firmware: 1.0.15
    • Hardware: 1.0 (EU) / Firmware: 1.0.7
  • P304M
    • Hardware: 1.0 (UK) / Firmware: 1.0.3
  • P306
    • Hardware: 1.0 (US) / Firmware: 1.1.2
  • TP25
    • Hardware: 1.0 (US) / Firmware: 1.0.2

Wall Switches

  • S210
    • Hardware: 1.0 (EU) / Firmware: 1.9.0
  • S220
    • Hardware: 1.0 (EU) / Firmware: 1.9.0
  • S500D
    • Hardware: 1.0 (US) / Firmware: 1.0.5
  • S505
    • Hardware: 1.0 (US) / Firmware: 1.0.2
  • S505D
    • Hardware: 1.0 (US) / Firmware: 1.1.0

Bulbs

  • L510B
    • Hardware: 3.0 (EU) / Firmware: 1.0.5
  • L510E
    • Hardware: 3.0 (US) / Firmware: 1.0.5
    • Hardware: 3.0 (US) / Firmware: 1.1.2
  • L530E
    • Hardware: 3.0 (EU) / Firmware: 1.0.6
    • Hardware: 3.0 (EU) / Firmware: 1.1.0
    • Hardware: 3.0 (EU) / Firmware: 1.1.6
    • Hardware: 2.0 (US) / Firmware: 1.1.0
  • L630
    • Hardware: 1.0 (EU) / Firmware: 1.1.2

Light Strips

  • L900-10
    • Hardware: 1.0 (EU) / Firmware: 1.0.17
    • Hardware: 1.0 (US) / Firmware: 1.0.11
  • L900-5
    • Hardware: 1.0 (EU) / Firmware: 1.0.17
    • Hardware: 1.0 (EU) / Firmware: 1.1.0
  • L920-5
    • Hardware: 1.0 (EU) / Firmware: 1.0.7
    • Hardware: 1.0 (EU) / Firmware: 1.1.3
    • Hardware: 1.0 (US) / Firmware: 1.1.0
    • Hardware: 1.0 (US) / Firmware: 1.1.3
  • L930-5
    • Hardware: 1.0 (US) / Firmware: 1.1.2

Cameras

  • C100
    • Hardware: 4.0 / Firmware: 1.3.14
  • C210
    • Hardware: 2.0 / Firmware: 1.3.11
    • Hardware: 2.0 (EU) / Firmware: 1.4.2
    • Hardware: 2.0 (EU) / Firmware: 1.4.3
  • C220
    • Hardware: 1.0 (EU) / Firmware: 1.2.2
  • C225
    • Hardware: 2.0 (US) / Firmware: 1.0.11
  • C325WB
    • Hardware: 1.0 (EU) / Firmware: 1.1.17
  • C520WS
    • Hardware: 1.0 (US) / Firmware: 1.2.8
  • C720
    • Hardware: 1.0 (US) / Firmware: 1.2.3
  • TC65
    • Hardware: 1.0 / Firmware: 1.3.9
  • TC70
    • Hardware: 3.0 / Firmware: 1.3.11

Doorbells and chimes

  • D100C
    • Hardware: 1.0 (US) / Firmware: 1.1.3
  • D130
    • Hardware: 1.0 (US) / Firmware: 1.1.9
  • D230
    • Hardware: 1.20 (EU) / Firmware: 1.1.19

Vacuums

  • RV20 Max Plus
    • Hardware: 1.0 (EU) / Firmware: 1.0.7
  • RV30 Max
    • Hardware: 1.0 (US) / Firmware: 1.2.0

Hubs

  • H100
    • Hardware: 1.0 (EU) / Firmware: 1.2.3
    • Hardware: 1.0 (EU) / Firmware: 1.5.10
    • Hardware: 1.0 (EU) / Firmware: 1.5.5
  • H200
    • Hardware: 1.0 (EU) / Firmware: 1.3.2
    • Hardware: 1.0 (EU) / Firmware: 1.3.6
    • Hardware: 1.0 (US) / Firmware: 1.3.6

Hub-Connected Devices

  • S200B
    • Hardware: 1.0 (EU) / Firmware: 1.11.0
    • Hardware: 1.0 (US) / Firmware: 1.12.0
  • S200D
    • Hardware: 1.0 (EU) / Firmware: 1.11.0
    • Hardware: 1.0 (EU) / Firmware: 1.12.0
  • T100
    • Hardware: 1.0 (EU) / Firmware: 1.12.0
  • T110
    • Hardware: 1.0 (EU) / Firmware: 1.8.0
    • Hardware: 1.0 (EU) / Firmware: 1.9.0
    • Hardware: 1.0 (US) / Firmware: 1.9.0
  • T300
    • Hardware: 1.0 (EU) / Firmware: 1.7.0
  • T310
    • Hardware: 1.0 (EU) / Firmware: 1.5.0
    • Hardware: 1.0 (US) / Firmware: 1.5.0
  • T315
    • Hardware: 1.0 (EU) / Firmware: 1.7.0
    • Hardware: 1.0 (US) / Firmware: 1.8.0

Credits

About

Plugin that uses Python-Kasa API to communicate with Kasa Devices.

Resources

License

Stars

Watchers

Forks

Packages

No packages published