Skip to content

App Settings

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

App Settings

Use the Device Capabilities app settings to exchange Flows, manage icons and custom lists, and enable supported reflection sources. Open the app in Homey and select its Settings screen; the exact navigation label can vary by Homey client.

Contents

The Flow Exchanger

The Flow Exchanger exports and imports TEF files (The Exchanger File). A TEF can contain selected Flows and, depending on the workflow, AVD templates and icons.

Export Flows

  1. Open Flow Exchanger → Export.
  2. Select the Flows to include.
  3. Choose whether the output should be minified or compressed, if useful.
  4. Create the TEF and copy it from the text field.
  5. Use Post Template to open the matching community sharing topic, then explain the required apps, devices, and setup.

Import Flows

  1. Open Flow Exchanger → Import and paste the TEF.
  2. Choose Read Flows to inspect the referenced Flows and Homey objects.
  3. Map the creator's devices, zones, users, variables, app tokens, and other objects to items on your Homey where appropriate.
  4. Review the generated content. The importer prepares a script for the Homey API Playground; read it before running it.
  5. Check every created Flow and test it before enabling automations that control important devices.

An imported Flow can refer to apps, devices, or variables that are not on your Homey. Replacing references does not prove that the Flow behaves identically. Follow the TEF guide for templates and safety checks.

AVD icons

The Your virtual devices section lets you choose a default icon or upload an SVG icon for an Advanced Virtual Device where the editing controls are available. The app asks you to restart Device Capabilities after changing an icon so that it is applied.

Custom icons

Custom Icons manages icons available to supported AVD fields:

  • Double-click an icon name to edit its description.
  • Use the upload control to replace an icon with an SVG.
  • Use the search control to select a built-in icon.
  • Restart Device Capabilities after changing an icon.

Field-icon selectors appear only for supported field representations. The AVD's device icon is managed separately. See field configuration for the controls available for each field type.

Custom lists

Create a custom list when an AVD List field needs choices that are specific to your setup.

  1. Open Lists, enter a list name, and choose Add custom list.
  2. Add each option with a stable ID and a readable title. IDs are case-sensitive.
  3. Add translated titles for the languages you use, then save the list.
  4. Select the list in an AVD List field and save the device.
  5. Use the AVD Set List actions or the List is value condition to select or check an option.

Use short IDs such as home, away, and sleep; use titles such as At home for what readers see. Flow cards compare the stored ID, not its translated title. Editing or removing a list or option can affect AVD fields and Flows that use it, so check those references before making changes.

For examples, see List fields and the AVD's List Flowcards.

Reflection sources

The app's Functions settings screen contains both the Reflection switches and custom JavaScript functions. Its Reflection controls enable reflection initialization for supported apps. Enable only the integration you plan to use; basic AVDs, built-in device reflection, and ordinary Flows do not require these optional apps.

The available switches depend on which supported app is installed. After enabling a source, choose it under Reflect in the AVD field settings and verify that the source reports the value you expect.

JavaScript functions

The Functions section lets you save named JavaScript functions for use in the app's JavaScript expression cards. These are optional; ordinary AVDs and Flows do not need a custom function. The app's expressions support Better Logic Library separately, and BLL offers more features.

  1. In app settings, open Functions and enter a unique Function name, such as double.

  2. Choose Add function, then Edit beside the new entry.

  3. Enter an anonymous JavaScript function and save it. For example, with the name double, use:

    (function (value) {
      return value * 2;
    })
  4. In an expression card, call it by its saved name, for example double(21). The expression returns 42; connect the card's result token to a compatible later input.

Keep the function name and expression call identical, use valid JavaScript, and test the result before relying on it in an automation. Deleting or renaming a function can break expressions that call it. If you prefer, use the app's expression cards or the separate BLL expression card.

Next steps

Clone this wiki locally