Tapo Schedule is a Python library for controlling TP-Link Tapo P100/P105/P110 plugs and L530/L510E bulbs and scheduling their operation.

The device control portion of the package is a rewrite of PyP100 library.

NOTE: The package will be available in PyPI in due time

pip install https://github.com/pnuu/tapo-schedule.git

The schedules can be defined in a YAML file, and processed using the included script:

run_schedule L530_schedule.yaml

Below is an example configuration for L530E lamp (included in examples/ directory). The available commands are shown in the later sections.

user: place-tapo-username-here
password: place-tapo-password-here
ip_address: place-lamp-IP-address-here

schedule:
    # Set HSV color to (0, 100, 1) (red) and wait 5 seconds
  - method: set_hsv
    delay: 5
    values:
      # Hue, Saturation, Value
    - [0, 100, 1]
  # Set color temperature to 2500 Kelvin (warm white). No delay.
  - method: set_color_temperature
    delay: 0
    values:
    - [2500]
  # Change brightness from 1 % to 100 % in 10 %-unit steps, wait 9 seconds between each step
  - method: set_brightness
    delay: 9
    values:
      # The values are passed to Python range() function, so the end value is exclusive
      range: [1, 101, 10]
  # Change color temperature from warm white (2500 Kelvin) to pure white (5000 K) in 100 K steps
  - method: set_color_temperature
    delay: 1
    values:
      range: [2500, 5100, 100]

Any supported device can be initialized using the Tapo utility class.

from tapo_schedule import Tapo

device = Tapo("192.168.X.X", "[email protected]", "Password123").get_device()

The plug devices have the following methods. Initialize the device as shown above.

# Power on the device
device.turn_on()
# Power off the device
device.turn_off()
# Get a dictionary of device information
device.get_device_info()

In addition to the commands for the plugs above, additional commands are available for light bulbs. Initialize the device as shown above.

# Set brightness level
device.set_brightness(100)
# Set color temperature for the white light (2700 K, warm white)
device.set_color_temp(2700)
# Set hue, saturation and value (HSV colorspace) for L530E
device.set_hsv(240, 100, 100)  # Blue
# Set RGB colors
device.set_rgb(255, 0, 255)  # Purple

In addition to P100 plugs, the following command is available for P110 power monitoring plug. Initialize the device as shown above.

# Returns a dict with all the energy usage statistics
device.get_energy_usage()