# freemocap/freemocap

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/freemocap-freemocap).**

5,216 stars · 419 forks · Python · agpl-3.0

## Links

- GitHub: https://github.com/freemocap/freemocap
- Homepage: https://freemocap.org
- awesome-repositories: https://awesome-repositories.com/repository/freemocap-freemocap.md

## Description

FreeMoCap is an open-source markerless motion capture system that reconstructs 3D human pose from video. It uses a multi-camera setup with ChArUco board calibration to accurately triangulate body landmarks, and it also supports single-camera recording for simpler captures. The system outputs skeleton joint data and generates interactive Jupyter notebooks for each recording, enabling users to explore and analyse motion data directly.

Built around hardware-synchronised video capture and MediaPipe-based 2D pose detection, FreeMoCap supports both calibrated multi-camera recording and real-time 2D/3D capture. It can also extract motion from existing video files. Recorded data is saved as organised files and can be exported to Blender for further editing or animation. The toolkit provides a complete pipeline from calibration through to analysis and export, all accessible without requiring physical markers.

## Tags

### Game Development

- [Motion Capture](https://awesome-repositories.com/f/game-development/tooling-asset-pipeline/motion-capture.md) — Captures 3D human motion from ordinary cameras or video files without markers for biomechanical analysis and animation.
- [Calibrated Multi-Camera Recordings](https://awesome-repositories.com/f/game-development/calibrated-multi-camera-recordings.md) — Synchronizes multiple cameras after calibration to capture 3D motion from multiple angles. ([source](https://freemocap.github.io/documentation/your-first-recording.html))
- [Video-Based Reconstructions](https://awesome-repositories.com/f/game-development/tooling-asset-pipeline/motion-capture/video-based-reconstructions.md) — Extracts 3D human motion from existing video files, a primary capability of the system. ([source](https://cdn.jsdelivr.net/gh/freemocap/freemocap@main/README.md))
- [Markerless Single-Camera Capture](https://awesome-repositories.com/f/game-development/tooling-asset-pipeline/motion-capture/markerless-single-camera-capture.md) — Captures 3D skeletal motion from a single camera without markers or calibration. ([source](https://freemocap.github.io/documentation))

### Artificial Intelligence & ML

- [3D Pose Reconstruction](https://awesome-repositories.com/f/artificial-intelligence-ml/3d-pose-reconstruction.md) — Reconstructs 3D skeletal data from multiple calibrated camera views or existing video files.

### Part of an Awesome List

- [Camera Calibration](https://awesome-repositories.com/f/awesome-lists/ai/pose-estimation/camera-calibration.md) — Uses a printed ChArUco board to calibrate multiple cameras for accurate 3D reconstruction.

### Data & Databases

- [Multi-View Geometry Solvers](https://awesome-repositories.com/f/data-databases/vector-search/vector-magnitude-calculators/vector-magnitude-calculators/spatial-geometry-calculators/multi-view-geometry-solvers.md) — Triangulates corresponding 2D keypoints across calibrated camera views to compute 3D skeleton positions.
- [File-Based Storage Systems](https://awesome-repositories.com/f/data-databases/file-based-storage-systems.md) — Organizes all recording data as local files (calibration, videos, keypoints, skeletons) for offline analysis.
- [3D Scene Exporters](https://awesome-repositories.com/f/data-databases/query-translators/multi-format-exports/3d-scene-exporters.md) — Exports motion capture recordings as complete 3D scenes for editing and animation in Blender. ([source](https://freemocap.github.io/documentation/software-hardware-prerequisites.html))

### Development Tools & Productivity

- [Open Source Toolkits](https://awesome-repositories.com/f/development-tools-productivity/open-source-toolkits.md) — An open-source toolkit that processes video to produce skeleton joint positions and analysis notebooks.

### Education & Learning Resources

- [Project-Specific Notebooks](https://awesome-repositories.com/f/education-learning-resources/jupyter-notebook-curricula/project-specific-notebooks.md) — Generates interactive Jupyter notebooks for each recording to explore and analyze motion data. ([source](https://freemocap.github.io/documentation/software-hardware-prerequisites.html))

### Graphics & Multimedia

- [Motion Data Analysis](https://awesome-repositories.com/f/graphics-multimedia/motion-data-analysis.md) — Generates interactive Jupyter notebooks enabling exploration and analysis of recorded motion data.
- [Real-Time Motion Tracking](https://awesome-repositories.com/f/graphics-multimedia/real-time-motion-tracking.md) — Captures body movements from connected cameras and outputs skeletal reconstructions in real time. ([source](https://freemocap.github.io/documentation/software-hardware-prerequisites.html))
- [Human Pose Detections](https://awesome-repositories.com/f/graphics-multimedia/video-frame-processing/real-time-model-inference-on-frames/human-pose-detections.md) — Detects 2D body landmarks from each camera view using a lightweight machine learning model.
- [Multi-Camera Synchronization](https://awesome-repositories.com/f/graphics-multimedia/video-production/multi-camera-synchronization.md) — Records from multiple cameras simultaneously using a hardware synchronization signal to align frames.