Skip to content

Getting Started

Arie J. Godschalk edited this page Nov 15, 2026 · 4 revisions

Getting Started

This guide covers a basic Advanced Virtual Device (AVD). To learn the app's other Flow-card features, see Flows.

Contents

1. Install the app

Install Device Capabilities from the Homey App Store. The current listing requires Homey 5.0.0 or newer. The Homey app/driver for each real device you want to control must also be installed and working.

2. Add an Advanced Virtual Device

  1. In Homey, start adding a device.
  2. Select Device Capabilities and its virtual-device/Advanced Virtual Device driver.
  3. Choose an available icon or template when offered.
  4. Finish adding the device, then give it a useful name and place it in the appropriate Homey zone.

The exact wording and order of pairing screens may vary between Homey clients and app versions.

3. Configure the AVD

Open the device's settings/repair screen and add only the fields you need. Give each field a name; a field without a configured name is not available to the matching Flow cards. Choose a suitable device class and configure icons and field ordering as needed. See Advanced Virtual Device for the full guide.

4. Connect it to real devices with Flows

A common pattern uses two Flows:

  1. Control: when an AVD button, list, or value changes, send the corresponding command to the real device.
  2. Keep the display current: when the real device reports a state change, update the matching AVD field.

For example, a button on an AVD can request that a curtain open, while a trigger from the curtain device updates the AVD's indicator to match its actual position. A command Flow alone does not guarantee that the AVD stays in sync if the device is also controlled elsewhere.

Avoid feedback loops

If a Flow mirrors a real device's state back to an AVD, and another Flow sends the AVD value to the real device, make sure that a mirrored update does not unintentionally re-send the command. Select Nothing else in the AVD set-field action when the mirrored update should not execute its When cards. Use the field trigger's Changed mode where appropriate, and test both manual AVD changes and external changes to the real device.

5. Show text on the tile

To show text on the tile, select a configured Text field as the tile's status indicator in the device settings in the Homey mobile app. Update it with the Set Text action.

6. Start with a small test

Before building a larger dashboard or importing a shared template:

  • Test one field and one Flow end-to-end.
  • Confirm that the real device exposes the expected capability and accepts the selected value.
  • Confirm that state updates are reflected back to the AVD.
  • Add additional fields and Flows incrementally.

Next steps

Clone this wiki locally