< HomeKat Help

Buttons & Sensors

Buttons & Sensors proposes three types of HomeKit accessories which can be used to trigger automations, either in Shortcuts (on macOS) or on IFTTT. These accessories are not connected directly to any physical devices.

  • Trigger Button is a one-shot switch which stays on only briefly. On iOS or macOS, it can call an IFTTT Webhook, on macOS, it can launch a named Shortcut. When activated, it can send up to three values from other HomeKit accessories.

  • Smart AC is a virtual Air Conditioner, which controls another HomeKit AC (see Tuya AC Controls). It keeps the room temperature within a user specified range, switching the physical AC device off when cooling or heating isn't needed. It keeps a history of the room temperature and outside temperature if linked, which can be viewed on a daily plot.

  • Weather Sensor is a simple temperature and humidity sensor for HomeKit connected to the weather report at a given location from Apple Weather, most usefully, just outside your home. A SmartAC can use a weather sensor to may better decisions about when to switch an AC on or off.

Trigger Button

To create a trigger button, select Add IFTTT Trigger Button or Add Shortcut Trigger Button from the + menu below the list on the Buttons & Sensors page of Settings.

Name the device and paste the IFTTT Webhook URL or enter the exact Shortcut name. When the button is activated, the webhook or Shortcut is called. You can select up to three characteristics from available HomeKit accessories and send their values as value1, value2 and value3.

For more information on IFTTT Webhooks, see the Documentation link on your Webhooks page.

To access values passed to a Shortcut, use steps such as:

  1. Get Dictionary from [Shortcut input]
  2. Get [Value] for [value1] in [Dictionary]
  3. Set variable [value1] to [Dictionary value]
  4. Get [Value] for [value2] in [Dictionary]
  5. Repeat for value2 and value3 as required.

Shortcut Trigger Buttons require the Home Kat Bridge server to run on macOS. They are unavailable when the server runs on iPhone or iPad because launching a Shortcut would interrupt the server.

To delete or rename the accessory, go back to Buttons Settings and click on the device in the list.

Once added to HomeKit, you may use it as a button to manually activate the IFTTT webhook or Shortcut, or add it to a HomeKit Scene or Automation to trigger the button when the scene is activated.

Smart AC

To create a Smart AC, select Add Smart AC from the + menu below the list on the Buttons & Sensors page of Settings.

Name the device and select the AC to control in the currently selected Home. If you have multiple Homes, you must identify the current Home in the HomeKit settings page. A Smart AC will take its room temperature readings from the selected target AC, but optionally another HomeKit accessory with a teperature characteristic can be used as an override.

A Smart AC estimates if the room would cool or heat up with the AC turned off using either the temperature trend measured while the AC is off, or a measurement of the outside weather temperature (see Weather Sensor below). You can optionally select a HomeKit accessory with a teperature characteristic to determine the outside temperature.

Once added to HomeKit, move the original AC to another room (e.g Default Room) and put the Smart AC in the room it is monitoring. That way the room temperature will be reported to HomeKit via the Smart AC, and you can say "switch on the AC in the Living Room" to Siri and it will switch on the Smart AC.

In the Home app, you set a range of temperatures for the Smart AC, and when turned on it will switch the AC to cool, heat or off depending on the room and outside temperatures.

Smart AC history widget

A Smart AC records its room temperature, optional outside temperature, and heating or cooling deployment over time. Its daily chart is available in Home Kat Bridge, and can also be shown in the Smart Thermostat History Home Screen widget.

Add the widget from the system widget gallery, then choose the Smart AC and chart period: Today or Today + Yesterday. The widget is available in medium and large sizes. A newly created Smart AC needs time to collect temperature history before its chart can be shown.

Weather Sensor

To create a Weather, select Add Weather Sensor from the + menu below the list on the Buttons & Sensors page of Settings.

Name the device and select the location on the map for which to request the weather report from Apple. Click or tap the map to select a location. The blue arrow moves to the current location known by the OS (if Location Services permission is granted). The black target centers the map on the selected location. A search bar is provided to search for a place name.

Home Kat Bridge requests current conditions and the hourly forecast from Apple Weather every three hours. Between those updates, it refreshes the HomeKit sensor every 15 minutes using values interpolated from the hourly forecast. The weather sensor configuration identifies whether its latest value came from current conditions or the interpolated forecast.

Once added to the Home app, best practice is to create a separate room, such as Outside, and place the sensor there.

Connect to HomeKit

To connct Buttons & Sensors to HomeKit, the category needs to activated (see Plans, Purchases and Activated Categories) and enabled in Settings. If the category is enabled without being activated, you can configure its virtual accessories but they are not added to HomeKit. Open Settings > General > Activate Device Categories, or follow Try Now to activate.