System Configuration

To start using CueCollab, you need to configure the timecode input and, optionally, the video recording settings.
This only needs to be done once after installation.

To begin configuration, open the Administration section of the application.

Timecode Input

Configure how CueCollab receives timecode for synchronization under Administration > Timecode Config.

Set the following parameters according to your setup:

• Timecode Source: Select the type of timecode input you are using (e.g., MIDI/MTC, ArtNet).
• MIDI > Prefer Input Number: Force the preferred MIDI input number, or
• MIDI > Interface Name: Select the MIDI interface by name.

Note

Ensure that your timecode source is properly connected and configured (for example, the Source Selection of your MIDI interface).

Recording Device

Configure video recording settings for CueCollab under Administration > Recording Config.

To enable the advanced video recording features of CueCollab, add a local OBS installation:

1. Install & Setup OBS

   1. Install Open Broadcaster Software (OBS) on the same machine where CueCollab is running.
   2. Launch OBS.
   3. Go to Menu Tools > WebSocket Server Settings.
   4. Enable the checkboxes Enable WebSocket server and Enable Authentication.
   5. Click Generate Password to create a secure password.
   6. Click Apply to save the settings, then open the Show Connect Info dialog to view the connection details.
   7. Copy the Server Password to use in CueCollab (needed for step 3).
   8. Close both dialogs.
   9. Open the Settings dialog in OBS.
   10. Navigate to the Output section and set Recording Format to Hybrid MP4 (.mp4).
   11. Navigate to the Video section and set Base (Canvas) Resolution and Output (Scaled) Resolution according to your requirements (1920x1080 30fps recommended).
   12. Click OK to save the settings.

2. Configure OBS Input/Content

   1. Find the Sources panel at the bottom of the OBS window.
   2. Click the + button to add a new Browser source named CueCollab Overlay.
   3. In the Properties dialog, set URL to http://localhost:3000/recording/overlay and Width/Height to match your video resolution (1920x1080 recommended).
   4. Click OK to add the source.
   5. Right-click the newly created CueCollab Overlay source and select Transform > Fit to Screen to ensure it fills the entire canvas.
   6. Click the + button to add a new Video Capture Device or Blackmagic Device source.
   7. In the Properties dialog, set Device to your preferred video capture device.
   8. Click OK to add the source.
   9. Right-click the newly created … Device source and select Transform > Fit to Screen to ensure it fills the entire canvas.
   10. Arrange the sources in the Sources panel so that the CueCollab source is above the video capture source.

3. Configure CueCollab

   1. In CueCollab, navigate to Administration > Recording Config.
   2. Click the Add Device button and set the following parameters:
      • Device Label: A descriptive name for your OBS instance (e.g., “Local OBS”)
      • Device Type: Select Open Broadcaster Software (WebSocket)
      • Server Endpoint: Set to ws://127.0.0.1:4455
      • Server Password: Paste the password you generated in step 1
   3. Click Save to add the OBS device.
   4. To allow web-based access to local recordings (needed for Review and enhanced Notes features), enable the checkbox Allow Access to Local Recordings.
   5. Click Save Config to save the recording configuration.
   6. The OBS device should now show as Connected (green icon) in CueCollab.

Note

You can add multiple OBS instances or other supported recording devices as needed, but these will only be used to trigger start/stop of recordings.
The built-in video player of CueCollab will always use the local recordings stored on the server machine.