A CLI and go package to control devices from Velux, Somfy and other vendors using the Overkiz platform.

• Executable kizcool/exe/kizcmd is a command-line utility to control devices.
• Package kizcool provides a high-level client with structs for events and devices. Documentation.
• Package kizcool/api provides a lower-level api client that returns the raw responses from the server without parsing. Documentation.

go get -u github.com/sgrimee/kizcool/cmd/kizcmd
go install github.com/sgrimee/kizcool/cmd/kizcmd

kizcmd configure

kizcmd get labels

kizcmd on "my light"
kizcmd off "my light"
kizcmd instensity "my light" 50

kizcmd open "my window"
kizcmd close "my window"

kizcmd open "my blind"
kizcmd close "my blind"
kizcmd closure "my blind" 75

kizcmd get devices

kizcmd get device "parents window" -ojson | jq

kizcmd listen

As an alternative to the config file, configuration items can be given as environment variables:

• KIZ_USERNAME
• KIZ_PASSWORD
• KIZ_BASE_URL

Golang >= 1.13

This packages interacts with the Overkiz API, as used by Somfy's Tahoma devices. It should work with other controllers but only Tahoma was tested.

Support is provided for the following devices:

• Velux Integra electric window: GGL-GGU
• Velux Integra electric roller shutter: SML
• Velux Integra spotlight: KRA-100 (hard to find)

However, the Overkiz system supports many more devices from several vendors. Some may work out of the box. Support for others should be easy to add. Please file an issue to report other working devices or request the addition of new devices.

This should work wherever go works. Tested on mac and linux. Efforts were made to support windows but it is not tested.

Upcoming features include:

• KNX bridge to control velux devices from a KNX system (the main goal for this project).

We are not affiliated, associated, authorized, endorsed by, or in any way officially connected with Overkiz, Velux, Somfy, any other trademark mentioned in this project, or any of its subsidiaries or its affiliates. We are grateful for the great products and services they provide.

Please see the License and Disclaimer notice.