Integración domótica HomeKit Controller, gratuita y de código abierto
Pair and control your HomeKit Wi-Fi/Ethernet accessories from Gladys, no Apple hub needed.
Publicado por prohand
- Dispositivos
- Versión 1.0.3
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
This integration turns Gladys into a HomeKit controller: it pairs directly with your Wi-Fi / Ethernet HomeKit accessories and controls them locally, without an iPhone, Apple TV or HomePod, and without any cloud.
Before you start
- A HomeKit accessory accepts only one controller at a time. If it is already in Apple's Home app (or in Home Assistant…), remove it there first. Otherwise, factory-reset the accessory.
- Have the 8-digit setup code (
123-45-678) at hand: it is printed on the accessory, its box or its manual. - The accessory must be on the same local network as Gladys.
- Only IP accessories (Wi-Fi, Ethernet) are supported. Bluetooth and Thread accessories are not.
- Gladys 5.1.0 or later is required.
Pair an accessory
- Open the Configuration tab of the integration.
- Click Search for accessories. The list shows, for each accessory: its
name, type, HomeKit ID, IP address and status (
ready to pair,paired elsewhere,paired with Gladys). - Click Pair an accessory and fill in:
- Accessory: the name, ID or IP address shown by the search. If the
search does not find it, type its address as
IP:port(for example192.168.1.20:51826); - Setup code: the 8 digits, with or without dashes.
- Accessory: the name, ID or IP address shown by the search. If the
search does not find it, type its address as
- Pairing takes a few seconds (up to a minute on small modules). Then open the Discovery tab: the accessory's devices are ready to be added.
A HomeKit bridge gives one Gladys device per bridged accessory.
Supported devices
| HomeKit service | In Gladys |
|---|---|
| Lightbulb | On/off, brightness, color, color temperature |
| Switch, outlet, valve | On/off |
| Fan | On/off, speed |
| Thermostat | Temperature, target temperature, humidity |
| Window covering, window, door | Position, open / stop / close |
| Lock | Locked / unlocked |
| Sensors | Temperature, humidity, illuminance, motion, |
| occupancy, contact, leak, smoke, CO, CO2, | |
| PM2.5 / PM10 particles | |
| Battery | Level, low battery |
Programmable buttons and doorbells are not devices: their presses trigger scenes (see below).
Other services (cameras, televisions…) are ignored for now.
Settings
- Refresh interval: HomeKit pushes changes in real time. Gladys also re-reads the whole accessory at this interval, as a safety net (60 s by default).
- Search duration: how long the network is listened to during a search (10 s by default).
Actions
- Search for accessories: lists the HomeKit accessories on the network.
- Pair an accessory: see above.
- Identify a device: the accessory signals itself (blinks, beeps…), handy to spot it.
- Unpair an accessory: removes the pairing from the accessory and from Gladys. For a bridge, all its devices are affected. Then delete the devices in Gladys.
Scenes
Triggers ("When…"):
- HomeKit button pressed: a button or a doorbell was pressed. Optional filters: the device, the press type (single, double, long) and the button number (for a remote with several buttons). Variables: accessory, button, button number, press, doorbell.
- HomeKit accessory offline / back: an accessory became unreachable, or came back. Optional filters: the device and the status. For a bridge, each bridged device sends its own event.
To pick a button in the "Device" filter, the accessory must have created a device in Gladys (for example through its battery). Otherwise, leave the filter empty.
Actions ("Then…"):
- Identify a HomeKit device: the accessory signals itself.
- Re-read a HomeKit device: reads all its values right away (handy before a condition).
Dashboard widget
The HomeKit accessories widget shows how many accessories are online and offline, the list of accessories (unreachable ones first) and, when one is offline, a Reconnect button.
Troubleshooting
- The accessory is not found by the search: check that it is powered on
and on the same network (same VLAN) as Gladys. Try a longer search
duration, or pair it with
IP:port. - "paired elsewhere": remove it from the Home app or factory-reset it.
- Unreachable accessory: the Configuration screen shows which accessories are offline. The integration retries on its own and finds the accessory again if its IP address changed. To avoid it, give the accessory a fixed IP address (DHCP reservation).
- Pairings are stored in the integration's
/datavolume: they are kept across updates. - For details, check the integration logs (
LOG_LEVEL=debug).
Parámetros de configuración
Estos son los parámetros que HomeKit Controller te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Getting started | section | No | 1. Remove the accessory from Apple Home (a HomeKit accessory accepts only one controller). 2. Click "Search for accessories" below. 3. Click "Pair an accessory" with its name and the 8-digit setup code printed on it. 4. Add its devices from the Discovery tab. |
| Refresh interval (s) | number | No | HomeKit pushes changes in real time; this full refresh is only a safety net. |
| Search duration (s) | number | No | How long Gladys listens for HomeKit accessories on the network. |
Cómo instalar HomeKit Controller en Gladys
- En Gladys, abre Integraciones: HomeKit Controller aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-homekitcontroller:1.0.3), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-homekitcontroller.
HomeKit Controller requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
HomeKit Controller es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación