Start free trial — 7 days free

No credit card required

← Back to docs

Voco Docs

Stream Deck and remote control

Control Voco from a Stream Deck button, ProPresenter action, or any URL trigger using the Signal API.

The Signal API

Voco's Signal API lets external devices send commands to the active stream without opening the admin dashboard. It is available on Voco Church and Network plans.

The API supports five actions: stream:start, stream:stop, captions:clear, captions:hide, and captions:show.

Stream Deck setup (URL action)

Stream Deck's Website button opens a URL — which is enough to trigger the Signal API's GET endpoint. No plugin needed.

  1. 1Find your API keyOpen Settings → API in the Voco dashboard and copy your church API key.
  2. 2Add a Website buttonIn Stream Deck, add an action and choose the System → Website action type.
  3. 3Paste the trigger URLUse the URL format below, replacing YOUR_KEY with your actual key.
  4. 4Set open in backgroundEnable 'open in background' so the URL fires silently without opening a browser tab.
  5. 5Repeat for each actionCreate one button per action — start, stop, captions on/off, clear.
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=stream:start
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=stream:stop
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=captions:hide
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=captions:show
https://voco.church/api/v1/signal?api_key=YOUR_KEY&action=captions:clear

Bitfocus Companion

Bitfocus Companion supports HTTP request actions, which work with the Signal API's POST endpoint. Use a Generic HTTP Request button and set the method to POST, the URL to https://voco.church/api/v1/signal, and add a JSON body with your API key and action.

Companion is useful when you need a full button grid controller rather than a consumer Stream Deck, or when integrating with ATEM, vMix, or ProPresenter control workflows.

ProPresenter URL actions

ProPresenter slides can fire URL actions when shown. Add a URL action to any slide using the Signal API GET endpoint — for example, a pre-service slide that starts the Voco stream automatically when it is put to screen.

Keep your API key private

Do not paste your API key into shared documents, volunteer group chats, or livestream recordings. Rotate it from Settings → API if it is exposed.

Related guides