ProTimer
Stream Deck and show control

Import the ProTimer module package in Companion 4

The dedicated ProTimer module gives Companion named actions, live status, timer variables, and starter presets. Generic HTTP remains a useful zero-install fallback.

Bitfocus CompanionStream DeckLive feedback

Get the connection details

  1. Open ProTimer's Network - OBS / Phone panel.
  2. Find the API row and note the computer IP, port, and the value after t=.
  3. Keep ProTimer and Companion on the same trusted network.
Session token: the token changes whenever ProTimer restarts. Update the Companion connection after an app restart or use the newly shown API URL.

Dedicated module

  1. Download the ProTimer module package.
  2. In Companion 4, open Modules → Import module package.
  3. Select the downloaded protimer-1.1.0.tgz file, add a ProTimer connection, then enter the host, port, and token shown by ProTimer.

This packaged install works now. The official Bitfocus repository has been requested, while catalogue submission remains pending. Follow request #2110 for status; the source repository remains available for development and review.

For current integration status and the Generic HTTP option, see the ProTimer Companion overview.

Core actions include Start/Pause, Reset, GO next cue, Blackout, time adjustment, set duration, mode, on-screen text, and speaker messages. Variables and feedback expose the live timer and connection state.

Suggested first page

ButtonPurpose
START / PAUSEMain transport with green running feedback.
RESETReturns the current timer to its configured duration.
GOLoads and starts the next rundown cue.
+1 MIN / -1 MINFast correction during a live session.
BLACKOUTHides the timer with a red active feedback.
WRAP UP / CLEARSends and clears the speaker message.

Generic HTTP fallback

Add a Generic HTTP connection and send GET requests using the API URL displayed by ProTimer:

http://<protimer-ip>:7878/cmd?type=start&t=<token>
http://<protimer-ip>:7878/cmd?type=go&t=<token>
http://<protimer-ip>:7878/cmd?type=adjust&value=-60&t=<token>

Test the page

  1. Start the timer and confirm the live time variable updates.
  2. Pause and verify running feedback turns off.
  3. Load a two-cue rundown and press GO.
  4. Toggle Blackout twice and verify both the stage output and button feedback.
  5. Restart ProTimer, update the token, and confirm the connection recovers.
Download the Companion moduleDownload ProTimer