OpenHAP

HomeKit Accessory Protocol for OpenBSD

OpenHAP bridges MQTT-connected Tasmota devices to Apple HomeKit, enabling control via the iOS Home app.

Features

• HomeKit: Full HAP implementation with secure pairing
• Crypto: SRP-6a, Ed25519, X25519, ChaCha20-Poly1305
• Thermostats: Control Tasmota heaters with temperature sensors
• MQTT: Connects HomeKit to MQTT-based devices
• OpenBSD: Native with pledge(2)/unveil(2) support

Quick Start

make deps
make install
cp /etc/examples/openhapd.conf /etc/openhapd.conf
vi /etc/openhapd.conf
rcctl enable mosquitto openhapd
rcctl start mosquitto openhapd

See INSTALL.md for complete installation instructions.

Documentation

• openhapd(8) - Daemon and command-line options
• openhapd.conf(5) - Configuration file format
• hapctl(8) - Control utility

Development

make deps-develop  # Install all dependencies
make test          # Run test suite
make lint          # Check code style
make man           # Build man pages

See .github/copilot-instructions.md for coding style.

Architecture

iOS Home App
     │
     │ TCP/TLS (HAP)
     ▼
┌─────────────┐     ┌───────────┐     ┌─────────────┐
│  openhapd   │◄───►│ mosquitto │◄───►│   Tasmota   │
│  :51827     │     │  :1883    │     │   Devices   │
└─────────────┘     └───────────┘     └─────────────┘

License

ISC License. See LICENSE.