Connect with the OSC Camera Tracker device

What you need

• A Windows workstation running Autodesk MotionBuilder.
• An Android phone running 6DoF Camera Tracker.
• The phone and workstation connected to the same local network.
• The Tech Story MotionBuilder camera plugin installer or binary from GitHub Releases.

Install the plugin

Open GitHub Releases to download the installer or plugin binary →

1. Open the latest entry on the GitHub Releases page and expand its Assets list.
2. Download Setup_TechStoryOSCCamera_MoBu.exe for the guided installation, or the matching device_oscCamera.dll for a manual installation.
3. Run Setup_TechStoryOSCCamera_MoBu.exe and select the MotionBuilder versions where the device should be installed. Administrator permission is required for the standard Program Files location.
4. For a manual installation, copy device_oscCamera.dll into the bin\x64\plugins folder of the matching MotionBuilder installation.
5. Restart MotionBuilder after installation.

Add the OSC Camera Tracker device

1. In the Asset Browser, open Templates → Devices.
2. Drag OSC Camera Tracker Device into the scene.
3. Select the device under Navigator → Devices.
4. On the General tab, set Sampling Rate to the rate used by the Android app. The read-only Receive Rate (Hz) property shows the measured incoming rate once streaming begins.

Configure the phone and UDP port

Use the setup wizard

The app can fill in the recommended MotionBuilder streaming settings for you. Run the setup wizard when the app first opens, or start it again later with the wand button.

1. Select MotionBuilder when the wizard asks where you are streaming.
2. Enter the MotionBuilder workstation's local IP address and the UDP port used by the plugin. The default port is 4000.
3. Continue through the wizard to apply OSC, Unicast, Default axis mapping, and the recommended space scale automatically.

Or configure it manually

Open the device's Communication tab and choose a UDP port. The default is 4000. Use the same value as the app's Target Port.

If you prefer the app's Space scale set to 100, set the device's Space Scale to 1 instead. Apply the centimetre conversion in one place only.

Put the device online and bind a camera

1. Start the OSC stream in 6DoF Camera Tracker.
2. Enable Online on the MotionBuilder device. Its status changes from Listening on UDP port… to Receiving data when valid poses arrive.
3. Open Model binding on the device.
4. Create or select a camera and bind it to the device's Camera template.
5. Press Zero pose in the app at the intended origin and verify the camera follows the phone.

Use lens data and depth of field

Calibrate lens encoders in the app

Open Lens & encoders in 6DoF Camera Tracker to convert raw encoder readings into physical lens values before they are sent to MotionBuilder.

1. Enter the encoder's Min, Max, and Step values for each connected lens control.
2. Enable Calibrate for zoom and enter the lens's minimum and maximum focal length in millimetres.
3. Set the corresponding calibration values for focus and iris when those channels are in use.
4. Move each control through its range and confirm that the values reported by the app match the physical lens.

Adjust lens values from the Lens panel

While tracking or streaming, open the Lens tab on the main screen to control the virtual lens directly from the phone.

• Zoom adjusts focal length in millimetres.
• Focus adjusts focus distance in metres.
• Iris adjusts the lens aperture as an f-number.

The displayed values use the calibration ranges configured in Lens & encoders and are included in the live OSC stream.

Use the calibrated values in MotionBuilder

Zoom, focus, and iris channels calibrated in the app arrive as physical values. Uncalibrated channels can be remapped with the device's Raw Range and Output Range properties.

1. Enable Use Depth of Field in the MotionBuilder camera's Render Options.
2. The device drives camera focal length, Specific distance, and Focus angle.
3. Adjust Focus Angle Scale if the calculated focus cone needs scene-specific tuning.
4. Use the separate Iris output in a relation constraint when another effect needs the incoming f-number.

Open the device's properties to inspect the incoming focal length, focus distance, iris, and focus angle. The same panel provides raw and output ranges for channels that are not calibrated in the phone app.

View MotionBuilder on the phone

You can use the phone as a wireless return viewfinder while it continues driving the MotionBuilder camera. The two connections work independently:

• OSC sends tracking and lens data from 6DoF Camera Tracker to MotionBuilder.
• OBS Studio captures the MotionBuilder viewport and sends the resulting program view back to the phone.

1. In OBS Studio, add a Window Capture or Display Capture source containing the MotionBuilder viewport.
2. Frame that source in the OBS program output at the resolution and frame rate you want on the phone.
3. Send the OBS program output to 6DoF Camera Tracker using native WHIP or NDI through the DistroAV plugin.
4. On the phone, select the OBS or NDI viewfinder mode while leaving the OSC tracking stream active.

Follow the OBS WHIP and NDI setup guide →

Record a tracked take

Record live in MotionBuilder

1. Confirm the device shows Receiving data and the camera moves correctly.
2. Enable Recording on the device.
3. Arm the camera animation nodes you want to capture and use MotionBuilder's normal transport recording controls.
4. Stop recording, take the device offline if you want to review without live input, and play back the take.

The device records incoming poses as animation keys, so the result can be edited with the normal MotionBuilder animation workflow.

Record on the phone and export FBX

For a take that does not depend on live network delivery, record the tracked motion directly in 6DoF Camera Tracker. The app stores the tracking samples locally on the phone, and you can export the completed take as an FBX file for use in MotionBuilder.

1. Start a local recording in 6DoF Camera Tracker before performing the camera move.
2. Stop and review the take on the phone.
3. Export the recording as FBX and transfer the file to the workstation.
4. Import the FBX into MotionBuilder and use the recorded camera animation in the scene.

Troubleshooting

Download installers and prebuilt binaries from GitHub Releases. For source code, build instructions, and issue reporting, visit the mobu-device-camera-plugin repository.