Find and read your output

Every recording, calibration or motion capture, gets its own folder in freemocap_data/recordings in your home folder. To jump to a recording's folder, open it in the Playback tab and click Open folder in file explorer.

What's in a recording folder

freemocap_data/recordings/
└── {recording_name}/
    ├── synchronized_videos/          # Original videos, one per camera
    │   └── timestamps/               # When each frame was captured
    ├── annotated_videos/             # Videos with the tracked points drawn on
    ├── output_data/                  # The motion capture data
    │   ├── *.npy
    │   ├── *.csv
    │   └── freemocap_data_by_frame.parquet
    ├── saved_data/                   # A second copy of the data, split by body part
    ├── 3d_models/                    # FBX and BVH files, after a Blender export
    ├── tracker_schema.json           # Which points were tracked and how they connect
    ├── {name}_camera_calibration.toml
    ├── {name}_info.json              # Camera settings used for the recording
    └── {name}.blend                  # The Blender scene, after a Blender export

A processed recording's folder in Finder, after a Blender export.FreeMoCap 2.0.0-alpha.25

• synchronized_videos/ holds your original footage, lined up in time across cameras.
• annotated_videos/ holds the same footage with the tracked points drawn on top. It's the quickest way to check tracking by eye.
• output_data/ holds the motion capture data in three formats: .npy for Python, .csv for spreadsheets, and freemocap_data_by_frame.parquet, which has every point of every frame in one table. See array shapes and units for what each file holds.
• saved_data/ holds a second copy of the data, split by body part into csv/ and npy/ folders, with the trajectory names and metadata in info/. Two README files in the folder explain how it is laid out.
• {name}_camera_calibration.toml is the calibration used for this recording.
• {name}.blend and 3d_models/ appear only after a Blender export.

Other locations

What	Where, in your home folder
All recordings	freemocap_data/recordings/
Your latest calibration	freemocap_data/calibrations/last_successful_camera_calibration.toml
Log files	skellylogs_data/logs/

Next steps

• Analyze your data in Python
• The FreeMoCap output data model
• Open your recording in Blender