Skip to main content

Using Bitfocus Companion

Controlling the CaptionKit API with Companion

James avatar
Written by James
Updated this week

Bitfocus Companion is a fantastic free tool which allows users to map many custom actions to controllers such as the Elgato Stream Deck and other USB buttons.

To set up CaptionKit signals with Companion, first you will need a CaptionKit API key. Follow this guide if you haven't set one up yet.

Version 4.x

Bitfocus Companion version 4 now includes a module library, for easy setup of your connections. Thanks to a CaptionKit user, we now have a module available in the module library (thanks RH πŸ™).

Once you have your API key for CaptionKit, open the Companion dashboard to the Module tab. Search for "captionkit" to find the CaptionKit: API module and click on the module label

The module's details will appear on the right, from there click the + button to install.

Once installed, navigate to the Connections tab on the left, then search for "captionkit" in the Add connection panel, then click Add. A confirmation pop-up will appear, just click Add again.

Once CaptionKit: API appears in your connections list, click it to show the Edit connection panel on the right. Scroll to the bottom, paste your CaptionKit API key and click save.

Next, open the Buttons tab and add button for your CaptionKit signal. Give the button a label.

Under the Press actions heading, click the πŸ“‚ icon to add a new action. Select CaptionKit > Send Signal from the dropdown and click Done

Choose a Signal type

Once the action is set up, test your button by clicking ▢️ Test at the top of the button edit panel. If you have CaptionKit open and have turned on Signals, you should see the app respond to the signal almost immediately.

Version 3.x

Once you have your API key for CaptionKit, open the Companion dashboard to the Connections tab. Add a new Generic: HTTP Requests type connection.

On the connection edit panel, label it as CaptionKit and add the following Base Url:

https://api.captionkit.io/v2/signal?key=API_KEY replacing API_KEY with your CaptionKit API key. Click Save.

Open the Buttons tab and add button for your CaptionKit signal. Give the button a label.

Under the Press actions heading, click the πŸ“‚ icon to add a new action. Select CaptionKit > GET from the dropdown.

Within the action edit panel, add your preferred signal parameter. This should be in the format of &event=SIGNAL_NAME, for example: &event=captions:stream:start

You can find a full list of signals here.

Once the action is set up, test your button by clicking ▢️ Test at the top of the button edit panel. If you have CaptionKit open and have turned on Signals, you should see the app respond to the signal almost immediately.

Did this answer your question?