# freemocap | The FreeMoCap Project | Knowledge Base | Instagit

Free Motion Capture for Everyone 💀✨

GitHub Stars: 5.2k

Repository: https://github.com/freemocap/freemocap

---

## Articles

### [How Freemocap Handles SIGINT Signals for Clean Shutdown](/freemocap/freemocap/how-does-system-handle-sigint-signals-for-clean-shutdown)

Learn how Freemocap gracefully handles SIGINT signals using QApplication.quit() for a clean shutdown, preventing abrupt process termination. Discover the implementation details.

- Tags: internals
- Published: 2026-02-19

### [Testing Framework and Data Shape Validation in FreeMoCap: A Complete Guide](/freemocap/freemocap/what-testing-framework-is-used-and-what-are-key-test-cases-for-data-shape-validation)

FreeMoCap leverages pytest for robust testing. Learn how this framework validates 3D skeleton data, 2D tracking, and COM trajectories against video frame counts for data integrity.

- Tags: tutorial
- Published: 2026-02-19

### [Understanding the freemocap queue_logger: Bridging Process Logs to the GUI](/freemocap/freemocap/what-is-purpose-of-queuelogger-and-how-does-it-interface-with-gui-log-view)

Discover the freemocap queue_logger's role in forwarding process logs to the GUI for real-time display. Understand its `QueueHandler` integration for seamless monitoring.

- Tags: internals
- Published: 2026-02-19

### [How the FreeMoCap Welcome Screen Dialog Guides New Users](/freemocap/freemocap/how-does-welcome-screen-dialog-guide-new-users)

Discover how the FreeMoCap welcome screen dialog guides new users through interactive documentation and preference settings for an intuitive onboarding experience.

- Tags: how-to-guide
- Published: 2026-02-19

### [Geometric Transformations in FreeMoCap: A Complete Guide to the utilities/geometry Module](/freemocap/freemocap/what-geometric-transformations-are-available-in-utilitiesgeometry-module)

Explore geometric transformations in freemocap utilities/geometry. Learn about rotate_by_90_degrees_around_x_axis and project_3d_data_to_z_plane for 3D motion capture skeleton manipulation.

- Tags: deep-dive
- Published: 2026-02-19

### [How Jupyter Notebook Generation Works in FreeMoCap: A Technical Deep Dive](/freemocap/freemocap/how-does-jupyter-notebook-generation-work-for-data-analysis)

FreeMoCap automates motion capture analysis by generating Jupyter notebooks. Explore the technical deep dive into the generate_jupyter_notebook function and streamline your data workflow.

- Tags: deep-dive
- Published: 2026-02-19

### [How the kill_event Enables Graceful Termination of Long-Running Tasks in Freemocap](/freemocap/freemocap/what-is-role-of-killevent-in-gracefully-terminating-longrunning-processing-tasks)

Discover how Freemoc"s kill_event enables graceful termination of long-running tasks. Safely abort heavy computations without orphaned processes. Learn more.

- Tags: internals
- Published: 2026-02-19

### [How Skellytracker Is Integrated into the Freemocap Core Processing Workflow](/freemocap/freemocap/how-is-skellytracker-integrated-into-core-processing-workflow)

Discover how Skellytracker integrates into the Freemocap core processing workflow. Learn how it powers 2D skeleton detection for efficient motion capture.

- Tags: how-to-guide
- Published: 2026-02-19

### [How FreeMoCap Handles Welcome Screen and Release Notes Popups on Startup](/freemocap/freemocap/how-does-gui-handle-welcome-screen-and-release-notes-popups-on-startup)

Discover how FreeMoCap manages startup popups like Welcome Screen and Release Notes. Learn about its GUI state management and conditional dialog display for a seamless user experience.

- Tags: how-to-guide
- Published: 2026-02-19

### [How FreeMoCap Image Tracking Pipeline Functions Handle 2D Skeleton Detection](/freemocap/freemocap/how-do-image-tracking-pipeline-functions-handle-2d-skeleton-detection)

Discover how FreeMoCap's image tracking pipeline performs 2D skeleton detection by loading NumPy arrays or using skellytracker, outputting validated 4D arrays for motion capture.

- Tags: internals
- Published: 2026-02-19

### [FreeMoCap Recording Folder Structure and DataLoader Parsing: A Complete Guide](/freemocap/freemocap/what-is-recording-folder-structure-and-how-does-dataloader-parse-it)

Understand the FreeMoCap recording folder structure output_data raw_data and synchronized_videos. Learn how the DataLoader parses motion capture CSV and NumPy files for consistent frame data.

- Tags: how-to-guide
- Published: 2026-02-19

### [How FreeMoCap Headless Mode Enables Batch Processing of Motion Capture Recordings](/freemocap/freemocap/how-does-headless-mode-processrecordingheadless-work-for-batch-processing)

Learn how FreeMoCap headless mode automates batch processing of motion capture recordings without a GUI. Discover its calibration validation, parameter persistence, and core processing capabilities.

- Tags: how-to-guide
- Published: 2026-02-19

### [How Camera Calibration Works in FreeMoCap: Charuco Board Calibration and Diagnostics Explained](/freemocap/freemocap/how-is-camera-calibration-performed-and-what-diagnostics-are-available)

Learn how FreeMoCap camera calibration uses Charuco boards to solve parameters and validates accuracy with neighbor-distance diagnostics. Understand intrinsic and extrinsic values for precise motion capture.

- Tags: deep-dive
- Published: 2026-02-19

### [How FreeMoCap Calculates Center of Mass: Body Segment Analysis and Anthropometric Methods](/freemocap/freemocap/how-does-center-of-mass-calculation-work-and-what-body-segments-are-used)

Discover how FreeMoCap calculates body center of mass using anthropometric methods and segment analysis. Understand the precise two-stage process for accurate motion tracking.

- Tags: deep-dive
- Published: 2026-02-19

### [How the MediaPipe Tracker Integrates with FreeMoCap for Body, Hand, and Face Detection](/freemocap/freemocap/how-does-mediapipe-tracker-integrate-with-freemocap-for-body-hand-and-face-detection)

Discover how FreeMoCap integrates MediaPipe's holistic model to track body, hand, and face landmarks. Learn about 2D to 3D conversion using skellytracker and Anipose for accurate motion capture.

- Tags: how-to-guide
- Published: 2026-02-19

### [ProcessingParameterModel in FreeMoCap: How Recording Processing Is Controlled from 2D Tracking to 3D Output](/freemocap/freemocap/what-are-processingparametermodel-and-how-do-they-control-recording-processing)

Learn how the ProcessingParameterModel in FreeMoCap controls recording processing from 2D tracking to 3D output. This Pydantic dataclass centralizes all configuration for a seamless workflow.

- Tags: internals
- Published: 2026-02-19

### [How Freemocap Implements a Multiprocessing Queue Logging System for Its Processing Pipeline](/freemocap/freemocap/how-is-multiprocessing-queue-logging-system-implemented-for-processing-pipeline)

Discover how Freemocap uses a multiprocessing queue logging system and a custom DirectQueueHandler to achieve unified, process-safe logging across its motion-capture pipeline.

- Tags: internals
- Published: 2026-02-19

### [How the Qt GUI Manages Application State Through the MainWindow Class in FreeMoCap](/freemocap/freemocap/how-does-qt-gui-manage-application-state-through-mainwindow-class)

Learn how the Qt GUI in FreeMoCap centralizes application state in its MainWindow class, managing user actions and persisting data effectively.

- Tags: internals
- Published: 2026-02-19

### [How the FreeMoCap Triangulation Pipeline Reconstructs 3D Positions from Multi-Camera 2D Tracking Data](/freemocap/freemocap/how-does-triangulation-pipeline-reconstruct-3d-positions-from-multi-camera-2d-tracking-data)

Learn how the FreeMoCap triangulation pipeline reconstructs 3D positions from multi-camera 2D tracking. Discover its Anipose CameraGroup integration for accurate skeletal data.

- Tags: internals
- Published: 2026-02-19