A simple app to control TPLink HS100 and HS110 devices.
Sometimes it is just easier to use a simple cli tool to turn the lights on and off. This is that tool.
There are two ways to control TP-Link HS1x0 devices, firstly by TP-Links cloud infrastructure, or alternatively by sending commands directly to the devices.
The cloud method is slower and relies on internet access, sending commands directly to each device is quicker and the method this tool uses.
The TP-Link devices have port 9999/tcp open which allows properly constructed and encrypted json to issue commands and get responses. The encryption method is simple and well documented, further details are available in the Credit section.
You can install a few ways:
- Download the binary for your OS from https://github.com/smford/tplink-hs1x-cli/releases
- or use
go installgo install -v github.com/smford/tplink-hs1x-cli@latest - or clone the git repo and build
git clone git@github.com:smford/tplink-hs1x-cli.git cd tplink-hs1x-cli go get -v go build
Create a configuration file called config.yaml an example is available below:
---
devices:
small: 192.168.10.44
large: 192.168.10.127
The configuration file has a list of devices, a human readable name, and the IP address of the device. The human readable name is used to issue commands against the devices.
When tplink-hs1x-cli runs it checks the current directory for a config.yaml, if you wish to use a different configuration file use the command --config /path/to/file.yaml
--config [file] Configuration file: /path/to/file.yaml (default: "./config.yaml")
--debug Display debug information
--device [string] Device to apply "do action" against
--displayconfig Display configuration
--do <action> on, off, status, info, cloudinfo, ledon, ledoff, wifiscan,
getaction, gettime, getrules, getaway, reboot, antitheft,
factoryreset, energy (default: "on")
--help Display help
--list List devices
--version Display version
| Action | Details |
|---|---|
| antitheft | Display anti-theft configuration |
| cloudinfo | Display TP-Link cloud information |
| energy | Display energy information |
| factoryreset | Factory reset the device |
| getaction | Display actions |
| getaway | Display configurared away information |
| getrules | Display configured rules |
| gettime | Display configured time |
| info | Display detailed information on a device |
| ledon | Turn LED on (night mode) |
| ledoff | Turn LED off (night mode) |
| off | Turn off |
| on | Turn on |
| reboot | Reboot device |
| status | Display current status of a device |
| wifiscan | Display wifi networks that the device can see |
| Command | Details |
|---|---|
tplink-hs1x-cli --do on |
Turn all relays on |
tplink-hs1x-cli --do off --device kitchen-lamp |
Turn kitchen-lamp off |
tplink-hs1x-cli --config ~/myconfig.yaml --list |
Load config from ~/myconfig.yaml and list all devices |
tplink-hs1x-cli --displayconfig |
Use the default config.yaml from current directory and display |