CameraKit for calibrated multi-camera TRACX workflows.
CameraKit is the open capture and calibration toolkit around TRACX Studio. Use it to discover cameras, prepare calibration TOML files, and record synchronized USB footage for multiview tracking.
Quickstart
List connected USB cameras and verify frame rates before recording.
Solve intrinsics and extrinsics from checkerboard or scene references.
Record synchronized multi-camera footage for Studio and cloud jobs.
Setup
Install, initialize, calibrate, and capture from the CLI.
CLI
python -m venv .venv
# activate your venv
pip install camerakitCLI
camerakit devices --max-cameras 6CLI
camerakit init --path /path/to/projectCLI
camerakit calibrate --config /path/to/projectCLI
camerakit report --input /path/to/project/calibration/Calib_board_outer.tomlCLI
camerakit capture --data-dir data --required-fps 60 --max-cameras 6Expected layout
project/
Config.toml
calibration/
intrinsics/
cam_00/intrinsics.mp4
cam_01/intrinsics.mp4
extrinsics/
cam_00/extrinsics.png
cam_01/extrinsics.png
data/
Session_YYYYMMDDTHHMMSS/
Trial_1/
0.mp4
1.mp4
logs.txtEach camera gets a stable folder or file identity. Keep these identities aligned with the calibration TOML and the videos submitted to Studio.
Calibration media can be video or image folders. Sync capture writes organized sessions and trial folders for downstream processing.
Studio-compatible calibration
[cam_00]
name = "cam_00"
size = [1920, 1080]
matrix = [[1420.5, 0.0, 962.1], [0.0, 1418.7, 541.9], [0.0, 0.0, 1.0]]
distortions = [0.01, -0.02, 0.0003, 0.0001]
rotation = [0.02, 0.03, -0.01]
translation = [1.20, -0.02, 0.10]
intrinsics_error_px = 0.42
extrinsics_error_px = 0.88
[metadata]
intrinsics_error_px = [0.42]
extrinsics_error_px = [0.88]Each camera section contains intrinsics, distortion coefficients, extrinsics, and optional reprojection errors. Enterprise Studio expects extrinsics to define camera poses in a shared world coordinate frame.
Calibration
- Use a rigid checkerboard with known square size.
- Capture intrinsics with the board covering the center, corners, near range, and far range.
- Keep the rig fixed after intrinsics before recording extrinsics.
- Use a shared target visible in every camera for extrinsics.
- Review reprojection errors before submitting footage to Studio.
Capture
- Lock exposure, white balance, and focus before recording.
- Warm up cameras for stable frame rates.
- Record a simple sync cue such as a clap or LED flash.
- Leave a few seconds of idle footage before action starts.
- Keep camera IDs consistent with calibration files.
Walkthroughs
Learn the CameraKit workflow by stage.
Video
From connected cameras to a calibration-ready project.
Video
Record checkerboard clips and read the calibration report.
Video
Solve camera poses with a shared target and review alignment.
Video
Capture organized multi-view footage for Studio workflows.
Where CameraKit is heading next.
These items are planned improvements around reliability, synchronization, and device coverage.
Setup support