Skip to main content

Python interface to control HomeKit accessories.

Project description

Author: Henri Dwyer
https://api.travis-ci.org/henridwyer/pyhomekit.png Latest Version Python Versions

PyHomeKit is a set of python libraries that let you control HomeKit compatible accessories, both BLE and HTTP.

For more information about HomeKit, see the Apple Developper HomeKit page.

Bluetooth Low Energy device compatibility is provided by bluepy, which uses bluez.

Important

PyHomeKit is currently in pre-alpha. Many features are not yet implemented or broken.

Getting Started

Usage

Connect to a HAP accessory view its HAP characteristics:

import pyhomekit

device_mac = "aa:aa:aa:aa:aa"
device = pyhomekit.ble.HapAccessory(mac=device_mac)
characteristics = device.discover_characteristics()

print(characteristics)

Interact with HAP characteristics:

# View the value of a characteristic
device.lock_target_state()
>>> 0

# Set the value of a characteristic
device.lock_target_state(value=1)

Installation

pyHomeKit is on Pypi, so you can pip install it:

pip install pyhomekit

If you want to install from source, clone the repository:

git clone git://github.com/henridwyer/pyhomekit.git
cd pyhomekit
pip install -r requirements.txt
pip install -e .

Then you can build the documentation:

make doc

And run the tests:

make tests

Requirements

pyHomeKit is only compatible with python 3.6 for the moment.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyhomekit, version 0.0.1.4
Filename, size File type Python version Upload date Hashes
Filename, size pyhomekit-0.0.1.4.tar.gz (9.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page