Recording folder structure
For the narrative version of this page, see find and read your output.
Layout
~/freemocap_data/recordings/{recording_name}/
├── synchronized_videos/
│ ├── {recording_name}.id-{camera_id}.idx-{camera_index}.mp4
│ └── timestamps/
├── annotated_videos/
│ └── {video_name}_annotated.mp4
├── output_data/
│ ├── *.npy
│ ├── *.csv
│ └── *.parquet
├── 3d_models/ # FBX/BVH, only if exported
├── tracker_schema.json
├── {recording_name}_camera_calibration.toml
├── {recording_name}_info.json
└── {recording_name}.blend # only if exported
Videos recorded by FreeMoCap itself follow the {name}.id-{camera_id}.idx-{camera_index}
pattern preceding; imported footage with other names (for example camera_0.mp4) is
assigned cameras by filename heuristics instead.
Defaults
| Path | Purpose |
|---|---|
~/freemocap_data/ | Root for all FreeMoCap data |
~/freemocap_data/recordings/ | All recordings |
~/skellylogs_data/logs/ | App logs |
~/freemocap_data/calibrations/last_successful_camera_calibration.toml | Most recent calibration |
Note that the base folder can be overridden with the FREEMOCAP_BASE_FOLDER
environment variable, which the desktop shell sets when you pick a different
data location.
File purposes
| File/folder | Contains |
|---|---|
synchronized_videos/ | Raw, time-aligned per-camera footage, plus capture-time timestamp CSVs under timestamps/ |
annotated_videos/ | Same footage with detected keypoints drawn on top, one {video_name}_annotated.mp4 per camera |
output_data/*.npy | Per-tracker, per-region 3D arrays, see array shapes and units |
output_data/*.parquet | All trajectories combined into one tidy long-format file, freemocap_data_by_frame.parquet, see the output data model |
tracker_schema.json | keypoint names and connections for the tracker that produced the data |
{name}_camera_calibration.toml | Camera intrinsics/extrinsics used for this recording |
{name}_info.json | Camera settings at record time (resolution, exposure, framerate, rotation), plus the recording name, a UUID, and the start timestamp |
{name}.blend | Blender scene, present only after export |
3d_models/ | FBX and BVH files, present only after export |