Skip to content

License requirement

The functionality described requires a MANUS Bodypack or a MANUS license dongle with one of the following licenses: Core Pro Core Xsens Pro Core Qualisys Pro Core OptiTrack Pro Demo, or a Feature license with the Recording and Exporting features enabled.

Remote recording start/stop triggering over UDP

When creating a recording pipeline using MANUS gloves in conjunction with body data, it's generally a good idea to include remote triggering of MANUS Core recordings for easier post processing. The functionality works via a UDP message coming over the network to a pre-specified port.

In the settings panel there is a section for recording settings. Here you can configure the remote triggering functionality. Below follows resources on how the functionality works specifically and how to set it up for each supported application.

UDP Packet

The payload is an XML file and includes a CaptureStart or CaptureStop element. If the Name or DatabasePath is omitted, the MANUS Core wide default settings for naming and autosaving are used. If the name and path attributes are sent in both the start and stop commands, the value used in the stop command override the start values.

CaptureStart

CaptureStart example
<?xml version="1.0" encoding="UTF-8"?>
<CaptureStart>
    <Name VALUE="TakeName"/>
    <DatabasePath VALUE="C:/Recording"/>
</CaptureStart>

CaptureStop

CaptureStop example
<?xml version="1.0" encoding="UTF-8"?>
<CaptureStop>
    <Name VALUE="TakeName"/>
    <DatabasePath VALUE="C:/Recording"/>
</CaptureStop>

Naming

The filename the recording will be saved with is built up as follows:

Example name
"C:/Recording/Take001_2024-05-01_12:00:00_MANUS.mrec"
{{DatabasePath}}/{{Name}}_{{yyyy-MM-dd_HH-mm-ss}}_MANUS.mrec

Integrations

MANUS Core has triggered recording functionality for the following software packages:

  • Xsens MVN
  • Vicon Shogun Live
  • Qualisys QTM
  • Optitrack Motive:Body
  • PeelCapture
  • Rokoko Studio

Default settings

The following ports are the default ports for each application:

Application Default trigger port Default send port
Xsens MVN 6004 N/A
Vicon Shogun Live 30 N/A
Qualisys QTM 8989 N/A
OptiTrack Motive:Body 1515 N/A
PeelCapture 1212 1213
Rokoko Studio 14048 N/A

These ports may be different for your specific setup, so please refer to your application's documentation below on specific instructions.

Xsens MVN

Enables start and stop triggering in Movella's Xsens MVN. Please refer to Movella's documentation for detailed instructions on how to set up remote triggering in MVN.

Vicon Shogun Live

Enables start and stop triggering in Vicon's Shogun Live. The Vicon Shogun Live may additionally send a delay element. The value will be used to delay the start command by as many milliseconds as stated. Please refer to Vicon's documentation for detailed instructions on how to set up remote triggering in Shogun Live.

Qualisys QTM

Enables start and stop triggering in Qualisys's Qualisys Track Manager (QTM). Please refer to QTM's documentation for detailed instructions on how to set up remote triggering in QTM.

OptiTrack Motive

Enables start and stop triggering in Optitrack's Motive:Body. Please refer to Optitrack's documentation for detailed instructions on how to set up remote triggering in Motive.

PeelCapture

The PeelCapture integration differs a a bit from the other integrations. MANUS Core will communicate back its current status so it can be displayed within PeelCapture. Please refer to our peelcapture documentation for detailed setup instructions.

Rokoko Studio

Enables start and stop triggering in Rokoko's Studio software. Please refer to Rokoko's documentation for detailed instructions on how to set up remote triggering in Rokoko Studio.

Timecode

It's highly advised to have all recordings (MANUS and others) timecoded for easy merging. Please refer to our article on timecode for more information on how to set this up in MANUS Core.