Stream Deck and Companion

Introduction

PalcoTimer can be controlled by hardware devices like the Elgato Stream Deck or software like Bitfocus Companion. This allows operators to control timers with physical buttons, without navigating through the computer.

Bitfocus Companion

Bitfocus Companion is free software that transforms any device into a control panel. Works with Stream Deck, tablets, phones, and more.

Configuring

1. Download and install Companion from bitfocus.io/companion
2. Open Companion and access the web interface (port 8000)
3. Go to "Connections" and add "Generic HTTP"
4. Configure buttons with the control URLs below

Native Stream Deck

If you use native Stream Deck software (without Companion), you can use the "Web Request" or "Website" plugin to call control URLs.

Using the Website plugin

1. Drag the "Website" action to a button
2. Paste the desired control URL
3. Check "Open in background"
4. Configure the button icon and title

Control URLs

Use these URLs to control your room. Replace ABC123 with your room's Short Code (visible on the Integrations page):

Transport Controls

Time Adjustments

Viewer Controls

Room State

Code Example

// JavaScript/Node.js
fetch('https://app.palcotimer.com/r/ABC123/api/play')
  .then(response => response.json())
  .then(data => console.log(data));

// cURL
curl "https://app.palcotimer.com/r/ABC123/api/play"

// Python
import requests
response = requests.get('https://app.palcotimer.com/r/ABC123/api/play')
print(response.json())