Repository navigation
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.
- The Flow Exchanger
- AVD icons
- Custom icons
- Custom lists
- Reflection sources
- JavaScript functions
- Next steps
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.
- Open Flow Exchanger → Export.
- Select the Flows to include.
- Choose whether the output should be minified or compressed, if useful.
- Create the TEF and copy it from the text field.
- Use Post Template to open the matching community sharing topic, then explain the required apps, devices, and setup.
- Open Flow Exchanger → Import and paste the TEF.
- Choose Read Flows to inspect the referenced Flows and Homey objects.
- Map the creator's devices, zones, users, variables, app tokens, and other objects to items on your Homey where appropriate.
- Review the generated content. The importer prepares a script for the Homey API Playground; read it before running it.
- 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.
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 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.
Create a custom list when an AVD List field needs choices that are specific to your setup.
- Open Lists, enter a list name, and choose Add custom list.
- Add each option with a stable ID and a readable title. IDs are case-sensitive.
- Add translated titles for the languages you use, then save the list.
- Select the list in an AVD List field and save the device.
- 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.
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.
- Better Logic Library can provide supported values and BLL expressions. See its App Settings and BLL coding guide.
- Chronograph can provide supported timer and stopwatch values. See its setup guides for Timer devices and Stopwatch devices.
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.
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.
-
In app settings, open Functions and enter a unique Function name, such as
double. -
Choose Add function, then Edit beside the new entry.
-
Enter an anonymous JavaScript function and save it. For example, with the name
double, use:(function (value) { return value * 2; })
-
In an expression card, call it by its saved name, for example
double(21). The expression returns42; 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.
Support development - If Device Capabilities is useful to you, you can support its
continued development through GitHub Sponsors,
Patreon,
PayPal, or
bunq.
Thank you!