freemocap
Free Motion Capture for Everyone πβ¨
File Explorer
Download Latest Version (.zip)- bug_report.md
- feature_request.md
- build-installers-pyinstaller.yml
- deploy-docs.yml
- test-bucket.yml
- test.yml
- dependabot.yml
- __init__.py
- health.py
- shutdown.py
- __init__.py
- blender_router.py
- __init__.py
- calibration_router.py
- __init__.py
- mocap_router.py
- __init__.py
- playback_router.py
- __init__.py
- posthoc_router.py
- __init__.py
- realtime_router.py
- __init__.py
- telemetry_router.py
- __init__.py
- __init__.py
- add_middleware.py
- cors.py
- __init__.py
- binary_keypoints_protocol.py
- tracker_schema_message.py
- websocket_connect.py
- websocket_message_types.py
- websocket_server.py
- __init__.py
- routers.py
- server_constants.py
- __init__.py
- app.py
- freemocap_application.py
- __init__.py
- bpy_install_addon.py
- get_best_guess_of_blender_path.py
- get_numpy_path.py
- install_blender_addon.py
- run_blender_export.py
- __init__.py
- export_to_blender.py
- __init__.py
- anthropometry.py
- composite_inertia.py
- ground_reference.py
- __init__.py
- streaming_kinematics.py
- __init__.py
- body_kinematics_state.py
- segment_lengths.py
- __init__.py
- aggregator_node_abc.py
- base_node_abc.py
- pipeline_abc.py
- pipeline_ipc.py
- pipeline_manager_abc.py
- source_node_abc.py
- __init__.py
- annotation_style.py
- pipeline_phases.py
- posthoc_aggregation_node.py
- posthoc_pipeline.py
- posthoc_pipeline_manager.py
- progress_messages.py
- task_progress_reporter.py
- video_group_helper.py
- video_node.py
- __init__.py
- camera_node.py
- camera_node_config.py
- charuco_recorder_node.py
- realtime_aggregator_node.py
- realtime_aggregator_node_config.py
- realtime_keypoint_filter.py
- realtime_pipeline.py
- realtime_pipeline_config.py
- realtime_pipeline_manager.py
- realtime_skeleton_inference_node.py
- realtime_skeleton_inference_node_config.py
- __init__.py
- pipeline_stage_timer.py
- pipeline_timing_reporter.py
- __init__.py
- anipose_calibration_helpers.py
- bundle_adjust.py
- camera_model_solver_ops.py
- freemocap_anipose.py
- __init__.py
- run_anipose_calibration.py
- __init__.py
- charuco_board_ops.py
- charuco_corners.py
- charuco_observation_aggregator.py
- __init__.py
- cost_functions.py
- initialization.py
- models.py
- postprocessing.py
- solver.py
- __init__.py
- pyceres_calibration_pipeline.py
- __init__.py
- calibration_paths.py
- calibration_result.py
- calibration_save.py
- calibration_state.py
- camera_extrinsics.py
- camera_id_resolution.py
- camera_intrinsics.py
- camera_model.py
- compare_calibrations.py
- groundplane_alignment.py
- groundplane_math.py
- interpolate_trajectories.py
- transform_math.py
- __init__.py
- calibration_task_config.py
- posthoc_calibration_task.py
- __init__.py
- charuco_model_from_observations.py
- recording_framerate.py
- skeleton_from_mediapipe_observations.py
- triangulate_trajectory_array.py
- __init__.py
- one_euro_filter.py
- realtime_filter_config.py
- realtime_point_gate.py
- __init__.py
- online_segment_lengths.py
- skeleton_rigidifier.py
- __init__.py
- center_of_mass.py
- mocap_task_config.py
- posthoc_mocap_task.py
- __init__.py
- angulation_result.py
- default_triangulation_values.py
- outlier_rejection.py
- project_point_to_camera.py
- project_single_camera.py
- triangulate_simple.py
- triangulation_config.py
- triangulation_result.py
- __init__.py
- triangulator.py
- __init__.py
- __init__.py
- observation_buffer.py
- tracker_definitions.py
- tracker_factory.py
- __init__.py
- type_overloads.py
- __init__.py
- blender_trajectory_loader.py
- __init__.py
- charuco_overlay_data.py
- skeleton_overlay_data.py
- __init__.py
- frontend_keypoints_serializer.py
- frontend_payload.py
- __init__.py
- __init__.py
- pubsub_abcs.py
- pubsub_manager.py
- pubsub_relay.py
- pubsub_topics.py
- __init__.py
- recording_status.py
- __init__.py
- recording_structure.py
- __init__.py
- telemetry.py
- telemetry_config.py
- __init__.py
- default_paths.py
- __init__.py
- test_groundplane_math.py
- __init__.py
- test_calibration_router_recording_state.py
- test_mocap_router_import.py
- __init__.py
- test_anthropometry.py
- test_composite_inertia.py
- test_ground_reference.py
- test_segment_lengths.py
- test_streaming_kinematics.py
- __init__.py
- mock_camera_group.py
- realtime_driver.py
- __init__.py
- anthropometry.py
- conftest.py
- helpers.py
- test_anthropometry_validation.py
- test_calibration_cache_alignment.py
- test_calibration_cache_e2e.py
- test_charuco_recorder.py
- test_posthoc_calibration_pipeline.py
- test_posthoc_mocap_pipeline.py
- test_realtime_keypoint_filter.py
- test_realtime_pipeline.py
- __init__.py
- test_calibration_recording_state_topic.py
- __init__.py
- test_realtime_skeleton_rigidifier.py
- test_rolling_bone_lengths.py
- test_tree_rigidifier.py
- __init__.py
- test_outlier_rejection.py
- __init__.py
- test_binary_keypoints_protocol.py
- test_center_of_mass.py
- __init__.py
- project_3d_data_to_z_plane.py
- rotate_by_90_degrees_around_x_axis.py
- __init__.py
- asyncio_exception_handler.py
- check_main_processs_heartbeat.py
- clean_path.py
- convert_pydantic_to_zod.py
- download_sample_data.py
- extract_camera_id_from_video_path.py
- fix_opencv_conflict.py
- get_number_of_frames_of_videos_in_a_folder.py
- get_process_name.py
- get_video_paths.py
- kill_event_exception.py
- kill_process_on_port.py
- open_file.py
- remove_empty_directories.py
- save_dictionary_to_json.py
- setup_windows_app_id.py
- toml_mixin.py
- update_1_4_path_names.py
- wait_functions.py
- __init__.py
- __main__.py
- build_info.py
- 2026-04-11_welcome.mdx
- api-boundary.mdx
- backend-calibration.mdx
- backend-mocap.mdx
- backend-overview.mdx
- backend-pipeline-architecture.mdx
- backend-pubsub.mdx
- backend-recording-structure.mdx
- backend-websocket-server.mdx
- frontend-backend-communication.mdx
- frontend-component-architecture.mdx
- frontend-state-management.mdx
- frontend-styling-system.mdx
- overview.mdx
- tracking-integration.mdx
- building.mdx
- testing.mdx
- blender-export.mdx
- camera-setup.mdx
- gpu-setup.mdx
- posthoc-mocap.mdx
- api-notes.mdx
- 2026-06-21-phase-1-backend-core.mdx
- 2026-06-21-phase-1-frontend.mdx
- _category_.json
- 00-overview.mdx
- 01-theory-and-math.mdx
- 02-module-architecture.mdx
- 03-data-flow-and-frontend.mdx
- 04-implementation-plan.mdx
- 05-bibliography.mdx
- _category_.json
- _category_.json
- intro.mdx
- AllPlatformsSection.tsx
- CodeBlock.tsx
- CollapsibleSection.tsx
- DownloadCard.tsx
- DownloadSection.tsx
- Footer.tsx
- Header.tsx
- LegacyReleaseView.tsx
- OsNote.tsx
- SystemDetector.tsx
- SystemHelpSection.tsx
- TerminalInstallSection.tsx
- TerminalTip.tsx
- VariantDetector.tsx
- VersionSelector.tsx
- useGpuDetection.ts
- useR2FileSizes.ts
- useReleaseVersions.ts
- useSystemDetection.ts
- DownloadPage.module.css
- DownloadPage.tsx
- downloads.ts
- installInstructions.ts
- systemHelp.ts
- download.tsx
- index.tsx
- roadmap.tsx
- logo.svg
- content.config.tsx
- docusaurus.config.ts
- package-lock.json
- package.json
- sidebars.ts
- tsconfig.json
- example.png
- example.spec.ts
- app-menu.ts
- dependency-manager.ts
- logger.ts
- menu-builder.ts
- python-server.ts
- system-scanner.ts
- update-handler.ts
- window-manager.ts
- api.ts
- app-paths.ts
- base-folder.ts
- index.ts
- ipc.ts
- index.ts
- splashmodal_art.webp
- freemocap-logo.png
- App.css
- App.tsx
- AppContent.tsx
- 2dtracking_active_icon.svg
- 2dtracking_icon.svg
- 3dtracking_active_icon.svg
- 3dtracking_icon.svg
- addsubfolder_icon.svg
- autoexposure_icon.svg
- back_icon.svg
- blender_icon.svg
- calibrate_icon.svg
- calibrated_icon.svg
- calibrating-icon.svg
- camera_icon.svg
- cancelcalibrate_icon.svg
- charuco_active_icon.svg
- charuco_icon.svg
- checkUpdate_icon.svg
- clear_icon.svg
- close_icon.svg
- close_icon_icon.svg
- collapse_icon.svg
- connected_icon.svg
- copied_icon.svg
- copy_icon.svg
- copyover_icon.svg
- discord_icon.svg
- donate_icon.svg
- download_icon.svg
- dropdown_icon.svg
- expand_icon.svg
- explainer_icon.svg
- externallink_icon.svg
- file_icon.svg
- filter_active_icon.svg
- filter_icon.svg
- fit_icon.svg
- frame_icon.svg
- framebackward_icon.svg
- frameforward_icon.svg
- github_icon.svg
- grid2_icon.svg
- grid3_icon.svg
- grid4_icon.svg
- grid_icon.svg
- home_icon.svg
- import_icon.svg
- importfile_icon.svg
- importproject_icon.svg
- importvideo_icon.svg
- importvideos_icon.svg
- learn_icon.svg
- live_active_icon.svg
- live_icon.svg
- liveoff_icon.svg
- load_icon.svg
- loader_icon.svg
- loop_icon.svg
- loopactive_icon.svg
- mic_active_icon.svg
- mic_icon.svg
- minus_icon.svg
- pause_icon.svg
- play_icon.svg
- plus_icon.svg
- processmocap_icon.svg
- recommendexposure_icon.svg
- record_icon.svg
- reset_icon.svg
- rotate_icon.svg
- save_icon.svg
- scan_icon.svg
- scrolldown_icon.svg
- scrollup_icon.svg
- search_icon.svg
- settings_icon.svg
- skeleton_active_icon.svg
- skeleton_icon.svg
- skeletonfilter_active_icon.svg
- skeletonfilter_icon.svg
- skipbackward_icon.svg
- skipforward_icon.svg
- snaptogrid_icon.svg
- sort_icon.svg
- stop_alert_icon.svg
- stop_icon.svg
- stopstreaming_icon.svg
- stream_icon.svg
- streaming_icon.svg
- subcat_icon.svg
- subfolder_icon.svg
- tag_active_icon.svg
- tag_icon.svg
- tomlfile_icon.svg
- triangulate_active_icon.svg
- triangulate_icon.svg
- updateAvailable-icon.svg
- updateAvailable_icon.svg
- upToDate_icon.svg
- video_icon.svg
- warning_icon.svg
- charuco_board.webp
- charuco_settings.webp
- CameraView.tsx
- CameraViewsGrid.tsx
- CameraViewWithOverlay.tsx
- ResizableCameraView.tsx
- CalibrationTomlPicker.tsx
- CollapsibleSidebarSection.tsx
- DirectoryStatusPanel.tsx
- ErrorBoundary.tsx
- PresetPicker.tsx
- RecordingStatusPanel.tsx
- CameraConfigTreeSection.tsx
- CameraConfigTreeView.tsx
- CameraConfigTreeViewHeader.tsx
- CameraGroupTreeItem.tsx
- CameraHeaderActions.tsx
- CameraSettingsModal.tsx
- CameraSummary.tsx
- CameraTreeItem.tsx
- NoCamerasPlaceholder.tsx
- CameraConfigExposure.tsx
- CameraConfigFramerate.tsx
- CameraConfigPanel.tsx
- CameraConfigResolution.tsx
- CameraConfigRotation.tsx
- BlenderSection.tsx
- ImportVideosModal.tsx
- MediapipeConfigPanel.tsx
- MocapPanel.tsx
- MocapTaskTreeItem.tsx
- SkeletonFilterConfigPanel.tsx
- RealtimePipelineConfigTree.tsx
- RealtimePipelineConnectionStatus.tsx
- RealtimePipelineStageTreeItem.tsx
- DelayRecordingStartControl.tsx
- MicrophoneSelector.tsx
- RecordingNamePreview.tsx
- RecordingSettingsSection.tsx
- StartStopRecordingButton.tsx
- ProcessMocapPanel.tsx
- RecordingCompleteDialog.tsx
- RecordingControlPanel.tsx
- RecordingControlsTreeSection.tsx
- RecordingHeaderButton.tsx
- RecordingInfoPanel.tsx
- RecordingPathModal.tsx
- RecordingPathPanel.tsx
- RecordingPathTreeItem.tsx
- RecordingSummary.tsx
- index.ts
- ServerConnectionStatus.tsx
- storage.ts
- types.ts
- useServerPanel.ts
- BaseD3ChartView.tsx
- d3ChartUtils.ts
- FramerateHistogramView.tsx
- FramerateStatisticsView.tsx
- FramerateTimeseriesView.tsx
- FrameRateViewer.tsx
- CherokeeFlag.tsx
- YiddishFlag.tsx
- LanguageSwitcher.tsx
- index.ts
- LogTerminal.tsx
- mocap-3dreconstruction-settings.tsx
- mocap-blender-settings.tsx
- mocap-detector-settings.tsx
- mocap-postprocess-settings.tsx
- mocap-processing-directory.tsx
- mocap-setup-modal.tsx
- mocap-triangulation-settings.tsx
- calibration-module.tsx
- calibration-settings.tsx
- realtimepipeline-3dreconstruction-settings.tsx
- realtimepipeline-mediapipedetector-settings.tsx
- PipelineGroupCard.tsx
- PipelineProgressBar.tsx
- PipelineProgressPanel.tsx
- PipelineProgressSnackbar.tsx
- index.ts
- PlaybackContext.tsx
- PlaybackControls.tsx
- RecordingBrowser.tsx
- RecordingBrowserSection.tsx
- SyncedVideoPlayer.tsx
- usePlaybackController.ts
- ZoomableVideoTile.tsx
- getting-started.ts
- index.ts
- index.ts
- telemetry.ts
- TourController.tsx
- TourNav.tsx
- TourOverlay.tsx
- TourPointerBubble.tsx
- TourPointerFallback.tsx
- TourSpotlight.tsx
- TutorialContext.tsx
- types.ts
- ButtonCard.tsx
- ButtonSm.tsx
- camerasEmptyState.tsx
- Checkbox.tsx
- DropdownButton.tsx
- Footer.tsx
- GridSettingsOverlay.tsx
- Header.tsx
- IconButton.tsx
- MainNavTabs.tsx
- NameDropdownSelector.tsx
- PromptTooltip.tsx
- Row.tsx
- SegmentedControl.tsx
- SettingsModal.tsx
- SettingsOverlay.tsx
- states.ts
- SubactionHeader.tsx
- TabbedContent.tsx
- TextSelector.tsx
- ToggleButtonComponent.tsx
- ToggleComponent.tsx
- types.ts
- UpdateBanner.tsx
- ValueSelector.tsx
- VersionChip.tsx
- WelcomeModal.tsx
- colors.ts
- face-contours.ts
- skeleton-colors.ts
- skeleton-config.ts
- viewport3d-types.ts
- virtual-points.ts
- useCalibrationTomlLoader.ts
- BodyKinematicsRenderer.tsx
- CenterOfMassRenderer.tsx
- ConnectionRenderer.tsx
- FaceRenderer.tsx
- KeypointsRenderer.tsx
- MocapCameraRenderer.tsx
- SceneCamera.tsx
- SceneEnvironment.tsx
- ViewportOverlay.tsx
- ViewportStateContext.tsx
- FileKeypointsSourceProvider.tsx
- index.ts
- KeypointsSourceContext.tsx
- ThreeJsCanvas.tsx
- ThreeJsScene.tsx
- viewport3d.worker.tsx
- worker-polyfill.ts
- WorkerDataContext.tsx
- WorkerDataStore.ts
- external-urls.ts
- server-urls.ts
- AutoUpdateContext.tsx
- floatingOnboarding.tsx
- useAppVersion.ts
- useAutoUpdate.ts
- useBlender.ts
- useCalibration.ts
- useDirectoryWatcher.ts
- useDismissibleTooltip.ts
- useDraggableTooltips.tsx
- useGridLayout.ts
- useKeyboardShortcuts.ts
- useMenuActions.ts
- useMocap.ts
- useRealtimePipelineSync.ts
- useRecordingStatus.ts
- useZoomTransform.ts
- am-amharic.json
- ar-arabic.json
- bn-bangla.json
- ca-catala.json
- chr-tsalagi.json
- cs-cestina.json
- de-deutsch.json
- el-ellinika.json
- en-english.json
- es-espanol.json
- fa-farsi.json
- fr-francais.json
- hi-hindi.json
- hr-hrvatski.json
- hu-magyar.json
- id-bahasa-indonesia.json
- it-italiano.json
- ja-nihongo.json
- ka-kartuli.json
- ko-hangugeo.json
- ms-melayu.json
- my-myanmar.json
- ne-nepali.json
- nl-nederlands.json
- pl-polski.json
- pt-BR-portugues-brasil.json
- ro-romana.json
- ru-russkiy.json
- si-sinhala.json
- sr-srpski.json
- sv-svenska.json
- sw-kiswahili.json
- ta-tamil.json
- th-thai.json
- tl-tagalog.json
- tr-turkce.json
- uk-ukrainska.json
- ur-urdu.json
- vi-tieng-viet.json
- yi-yidish.json
- zh-CN-zhongwen.json
- i18n.ts
- index.ts
- BaseContentRouter.tsx
- BottomPanelContent.tsx
- SidePanelContent.tsx
- BasePanelLayout.tsx
- ActiveRecordingPage.tsx
- PlaybackPage.tsx
- StreamingViewPage.tsx
- electron-ipc-client.ts
- electron-ipc.ts
- index.ts
- binary-frame-parser.ts
- binary-protocol.ts
- frame-decode.worker.ts
- frame-processor.ts
- keypoints-binary-parser.ts
- keypoints-protocol.ts
- charuco-overlay-renderer.ts
- charuco-types.ts
- image-overlay-system.ts
- index.ts
- overlay-renderer-factory.ts
- skeleton-overlay-renderer.ts
- skeleton-types.ts
- canvas-manager.ts
- console-log-bridge.ts
- framerate-store.ts
- log-store.ts
- offscreen-renderer.worker.ts
- tracked-object-definition.ts
- websocket-connection.ts
- websocket-message-types.ts
- index.ts
- server-context.ts
- ServerContextProvider.tsx
- index.ts
- layout-presets.ts
- layout-presets.yaml
- active-recording-slice.ts
- index.ts
- recording-structure.ts
- blender-slice.ts
- blender-thunks.ts
- index.ts
- calibration-slice.ts
- calibration-thunks.ts
- calibration-types.ts
- index.ts
- camera-settings-storage.ts
- cameras-reconcile.test.ts
- cameras-selectors.ts
- cameras-slice.ts
- cameras-thunks.ts
- cameras-types.ts
- index.ts
- connection-selectors.ts
- connection-slice.ts
- connection-types.ts
- index.ts
- index.ts
- locale-selectors.ts
- locale-slice.ts
- locale-types.ts
- index.ts
- mocap-slice.ts
- mocap-thunks.ts
- index.ts
- pipelines-slice.ts
- pipelines-thunks.ts
- playback-data-slice.ts
- index.ts
- realtime-selectors.ts
- realtime-slice.ts
- realtime-thunks.ts
- realtime-types.ts
- getTimestampString.ts
- index.ts
- recording-slice.ts
- recording-thunks.ts
- recording-types.ts
- index.ts
- recording-status-slice.ts
- recording-status-thunks.ts
- index.ts
- theme-selectors.ts
- theme-slice.ts
- theme-types.ts
- index.ts
- videos-selectors.ts
- videos-slice.ts
- videos-thunks.ts
- videos-types.ts
- thunk-helpers.ts
- camera-config-listener.ts
- hooks.ts
- index.ts
- persistence-listener.ts
- persistence.ts
- store.ts
- types.ts
- animation.css
- App.css
- button-sm.css
- calibration-module.css
- calibration.css
- camera.css
- checkbox.css
- color.css
- components.css
- font.css
- framerate.css
- icons.css
- log-terminal.css
- pipelineProgress.css
- playback.css
- reset.css
- toggle.css
- tooltips.css
- tutorial.css
- recording-status.ts
- dataFolder.ts
- gridTiling.ts
- index.css
- main.tsx
- vite-env.d.ts
- .gitignore
- .npmrc
- electron-builder.json
- entitlements.mac.plist
- index.html
- jsconfig.json
- package-lock.json
- package.json
- playwright.config.ts
- README.md
- screenshot.mjs
- tsconfig.json
- tsconfig.node.json
- vite.config.flat.txt
- vite.config.ts
- charuco_board_image.png
- charuco_board_image.svg
- charuco_board_image_highRes.png
- charuco_board_image_highRes_no_border.png
- freemocap-favicon.ico
- freemocap-logo.png
- freemocap-logo.svg
- freemocap.icns
- info.plist
- .flake8
- .gitignore
- .pre-commit-config.yaml
- .python-version
- CITATION.cff
- CODE_OF_CONDUCT.md
- CODEOWNERS
- CONTRIBUTING.md
- freemocap.spec
- LICENSE
- MANIFEST.in
- noxfile.py
- package-lock.json
- poe_tasks.toml
- pyproject.toml
- README.md
- TESTING.md
- uv.lock
π Installation Guide
1. Get the code
git clone https://github.com/freemocap/freemocap
Downloads the entire project code from GitHub to your computer.
cd freemocap
Moves into the project folder you just downloaded.
2. Official Install Script
Easy RecommendedPrerequisites
- Python 3 Python is required to use pip.
pip install freemocap[cuda] # Windows/Linux with an NVIDIA GPU
Installs the package published on PyPI directly β no need to clone the source.
pip install freemocap[cpu] # macOS, or Windows/Linux without a supported GPU
Installs the package published on PyPI directly β no need to clone the source.
After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.
Pulled directly from this repo's README.
3. Node.js
EasyPrerequisites
npm install
Downloads and installs the libraries listed in package.json.
npm run dev
Starts the development/run server.
After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.
Pulled directly from this repo's README.
4. Python
EasyPrerequisites
pip install freemocap[cuda] # Windows/Linux with an NVIDIA GPU
Installs the package published on PyPI directly β no need to clone the source.
pip install freemocap[cpu] # macOS, or Windows/Linux without a supported GPU
Installs the package published on PyPI directly β no need to clone the source.
If it runs without errors and prints output in the terminal, it worked.
Pulled directly from this repo's README.
// repository documentation
Was this content helpful?
(0 ratings)