Add an adapter

This guide will teach you how to add an adapter to your Formant organization and apply it to your device.

Step 1: Get an adapter

Generally, you will want to reach out to us to get the adapter. You can reach us via the Intercom messenger in the bottom-right corner of this page, or by sending an email to [email protected].

Step 2: Add the adapter to Formant

  1. In Formant, in the upper-left corner, open the menu and click Settings.
  2. Go to Adapters and click Add Adapter.
  3. Configure your adapter as follows:
PropertyUsage
NameGive your adapter a name.
Exec commandEnter the execution command to start this adapter (typically ./start.sh).
  1. Click Upload Zip and upload the zip file containing your adapter to your Formant organization.

Step 3: Apply the adapter to your device

  1. In the Settings window, go to Devices and select the device to which you want to apply the adapter.
  2. Scroll down to Adapter Configuration and click Add Adapter.
  3. You'll see all adapters in your organization in the dropdown. Select the one you want to apply to this device, and then click the check icon.

Step 4 (optional): Configure your adapter

If your adapter has configurable properties, you will be able to edit them after it has been added to the device.

  1. Immediately after Step 3, click the gear icon next to the adapter you just applied to your device.
  2. You will be able to configure any fields which are listed in the config_schema.json file in the zipped folder which you uploaded in Step 2.