Skip to content

Latest commit

 

History

History
61 lines (46 loc) · 1.46 KB

README.md

File metadata and controls

61 lines (46 loc) · 1.46 KB
Raw

pyhomebridge

python library to control a Homebridge server

Setup

Install homebridge-config-ui-x on your HomeBridge.

Make sure you run HomeBridge in Insecure Mode. (This can be changed in the Web Settings at top right corner) API control is only allowed in this mode. Thats starting HomeBridge with the -I flag.

Installation

Pypi package for pyhomebridge

pip3 install pyhomebridge

Usage

Python usage:

from homebridge import HomeBridgeController

controller = HomeBridgeController(host="homebridge.local", port=80, auth="123-45-678")
print(controller.accessories)
controller.print_accessories()
controller.accessory_exists("light_hallway")
controller.get_value("light_hallway")
controller.set_value("light_hallway", True)

In the repo you can find a python script to use for CLI execution. control-homebridge.py

python3 control-homebridge.py --list
python3 control-homebridge.py --name light_hallway --off

# you will need to set url, port and code in the script
# or use the --server, --port, --auth options

Development

Currently supported devices:

  • Lights
  • Switches
  • Outlets

TODO

  • add timeouts
  • support more device types
  • write documentation
  • write tests
  • much much more

Inspiration

HomeScript by menahishayan

License

MIT

Free Software, Hell Yeah!