26.3 26.2 26.1 25.3 25.2 25.1 24.3 24.2 24.1 23.4 23.3 23.2 23.1
26.3 26.2 26.1 25.3 25.2 25.1 24.3 24.2 24.1 23.4 23.3 23.2 23.1

Trigger control panel actions with Bitfocus Buttons

Each Stream Deck key sends a Remote Call to a control panel. The panel then clicks one of its own buttons, so the Stream Deck and the panel always run exactly the same logic.

This page only covers what is specific to this approach. Set up the Buttons connection and learn how to create keys in Using Buttons with Pixotope

Learn more about how to Remote control the control panel

Prerequisites

  • The Pixotope connection set up in Buttons

  • A control panel whose buttons already work in LIVE mode

    • Test every panel button by clicking it in LIVE mode first. If it does not work from the panel, it will not work from the Stream Deck either

Set up the control panel

Add a Remote Call widget

  1. Open the control panel in Edit mode

  2. Press T to open the Widgets Toolbox, select Remote Call, click Confirm and drag a rectangle on the canvas to place the widget

    • One Remote Call widget per panel is enough. It is not shown in LIVE mode

    a_01_widgets_toolbox-20261103-143827.png
  3. Give the widget a clear Name in Properties, for example StreamDeck

    • Names typed in the editor cannot contain spaces. The field reverts to the previous name without a warning

Define the call keys

A call key is the name Buttons sends to trigger something on the panel. Add one call key per Stream Deck key.

  1. Right click the Remote Call widget and click OPTIONS next to Methods in the popup

    • The Options list already contains one call key, METHOD_1

    a_02_remote_call_methods-20261103-145904.png
  2. Click + Add new option (2) for every additional key you need

    • New options are named option_value until renamed

  3. Double click each option and enter its Call Key (1), for example SD_POS1 or SD_WIND_ON

  4. Click Confirm

    a_03_call_keys-20261103-143827.png

Use short upper-case names with a common prefix such as SD_. Call keys must be unique, and Buttons has to send them with exactly the same spelling and case.

Instead of rebuilding the logic on the call key, let each call key click the matching panel button. The button keeps its actions, and changing what a button does later needs no change in Buttons.

  1. Double click the Remote Call widget to focus its actions

  2. In the Actions section, select the first call key (1)

  3. Right click the panel button this call key should press and scroll down to its CLICK event

    a_04_button_click_trigger-20261103-153758.png
  4. Drag the CLICK event onto the action list of the call key

    • The action reads the button's Name followed by .CLICK (2). The button's Text is not used

    a_05_call_key_mapping-20261103-143827.png
  5. Repeat this for all call keys

  6. Save the control panel

Learn more about how to Trigger using another widget

Set up the keys in Buttons

  1. Create a key as described in Using Buttons with Pixotope

  2. Under Press, add the Pixotope: Raw API Request action

  3. Fill in the fields (1)

  4. Click the lightning icon (2) to fire the call once

    • The matching panel button reacts

    a_06_raw_api_request-20261103-145804.png
  5. Click Apply

Field

Value

Topic Type

Update

Target

ControlPanel

Name (for Set/Get)

Leave empty

Method (for Call)

The call key, for example SD_POS1. The field is labelled for Call, but it is used for Update as well

Message (JSON object)

{}

Topic Type must be Update. The control panel only listens for Update messages addressed to ControlPanel, and ignores Call.

Duplicate the finished key for the other call keys, and change only Method, Text and colour.

Operate

  1. Launch the control panel in LIVE mode, either in Director or in a browser

    1. Select the panel (1)

    2. Click Launch LIVE (2)

    a_07_launch_live-20261103-143827.png
  2. Press the keys on the Stream Deck

    • The Remote Call widget is not drawn in LIVE mode, but it still receives the calls

    a_08_panel_live-20261103-143827.png

Remote Calls only fire while the panel is open in LIVE mode. A panel in Edit mode, or a closed panel, ignores them.

Keep the panel LIVE in one place only. Every LIVE instance reacts to each call, so two open instances run every action twice. That is harmless for absolute actions like Pos 1, but doubles relative ones like Sun +10.

a_09_finished_layout-20261103-145804.png

Troubleshooting

Symptom

Likely cause

Fix

Log shows 200, nothing happens

The panel is not open in LIVE mode

Launch the panel in LIVE mode

Panel is LIVE, still nothing

Method does not match a call key

Compare spelling and case with the call key list

Every action runs twice

The panel is LIVE in two places

Close the extra instance

Panel button works, call key does not

The call key has no action, or clicks the wrong button

Check the call key's action list

Panel button itself fails

An actor was renamed or re-placed

Re-link the button's action to the actor