Skip to content
Projects

xianfei/SysMocap has 3,246 GitHub stars and 491 forks. GitHot measured +2 stars in 24 hours. Last checked 2026-11-05 21:12 UTC. Last push 2026-06-10.

How these counts are measured

A real-time motion capture system for 3D virtual character animating.

Measured star growth

in 24h
+2
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

banner

SysMocap

GitHub Actions release forks stars

English Version | 中文版本

A cross-platform real-time video-driven motion capture and 3D virtual character rendering system for VTuber/Live/AR/VR.

Available for Windows, macOS (including Apple Silicon & Intel) & Linux (source code only)

Download Now

(This is a multi-language software, including English and Chinese. )

Highlights

🌟 Beautiful GUI with Material Design 3 Color System, with Dark Mode supported.

UI UI-dark

🌟 Easy to used. You can import 3D models just with drags.

https://user-images.githubusercontent.com/8101613/167257555-8b8d4b99-f99f-4b79-8891-967b8723e3f8.mp4

🌟 Support WebXR API on Mocap Forwarding (HTTPS only)

https://user-images.githubusercontent.com/8101613/167257906-596919a5-4c0e-4795-865f-384a15c0d39f.mp4

🌟 Model viewer with bones & dressing controller

Model viewer

🌟 Support OBS live-streaming

OBS

🌟 Support full-body motion capture

Full-body

Full-body-animotion

🌟 Support Auto Skeleton Detection for All VRM files (including VRM 0.x and VRM 1.0) and Mixamo Format FBX files

fbx-mixamo-animotion

🌟 Support Any Skeleton Structure with Manual Mapping

bdd-animotion

🌟 You can use VRoid Studio to create your avatar very easily. Supporting VRM 0.x & 1.0!

vroid

More Effect Demonstration

🌟 Facial

Facial-animotion

🌟 Half-body

Half-body-animotion

🌟 Half-body with Hands

Half-body with Hands animotion

🌟 Full-body

Full-body-animotion

System architecture

System architecture

How to Download prebuilt package (Windows & macOS):

Download Now

1. Windows Portable Version: Simply extract the archive and run SysMocap.exe.

  • SysMocap-Windows-x64-<version>.7z: Windows 64-bit version, suitable for x86_64 processors (AMD, Intel, etc.) running 64-bit Windows 10 & 11.

  • SysMocap-Windows-arm64-<version>.7z: Windows ARM 64-bit version, suitable for ARM64 processors (such as Qualcomm Snapdragon) running 64-bit Windows 10 & 11.

2. Windows Installer: Double-click to install.

Snipaste_2024-07-07_20-56-11
  • SysMocap-Windows-x64-installer-<version>.msi: Windows 64-bit version, suitable for x86_64 processors (AMD, Intel, etc.) running 64-bit Windows 10 & 11.

  • SysMocap-Windows-arm64-installer-<version>.msi: Windows ARM 64-bit version, suitable for ARM64 processors (such as Qualcomm Snapdragon) running 64-bit Windows 10 & 11.

3. macOS DMG Image: Drag SysMocap.app to the Applications folder.

Snipaste_2024-07-07_20-56-11
  • SysMocap-macOS-x64-<version>.dmg: Suitable for Apple computers with Intel chips and Hackintosh devices, running macOS 10.15 or later.

  • SysMocap-macOS-arm64-<version>.dmg: Suitable for Apple computers with M series chips (Apple Silicon).

Note for user on macOS:

  • You need set Gatekeeper to Anywhere in System Settings (using sudo spctl --master-disable)

    image
  • If you got “SysMocap” is damaged and can’t be opened. You should move it to the Trash. Please run sudo xattr -r -d com.apple.quarantine /Applications/SysMocap.app in your terminal

How to run from source code (need lastest Node.js):

git clone https://github.com/xianfei/SysMocap.git
cd SysMocap
npm i
npm start

Notice

  1. HTTP & HTTPS will use same port in Mocap Data Forward.

Required Skeleton Node in glTF/glb/FBX Model File for Macap:

(If not same as above, you need rebind them manually.)

  • Hips (Main Node, both Position and Rotation. Ratation only for other nodes)

  • Neck

  • Chest

  • Spine

  • RightUpperArm

  • RightLowerArm

  • LeftUpperArm

  • LeftLowerArm

  • LeftUpperLeg

  • LeftLowerLeg

  • RightUpperLeg

  • RightLowerLeg

Star History

Improve Translate

If you want to contribute language translation, you can add translation in utils/language.js

Then modify mainview/framework.html

 <div class="settings-item">
  <i class="mdui-icon material-icons" style="margin-right: 10px; margin-top: -3px">language</i>
  <span>{{language.tabSettings.ui.language}}</span>
  <select v-model="settings.ui.language" class="mdui-select" style="float: right; margin-right: 10px" id="demo-js-2">
    <option value="zh">简体中文</option>
    <option value="en">English</option>
  </select>
</div>

Fonts

Nowar Rounded for East Asian languages (汉语、漢語、日本語、한국어)

Quicksand for English and etc.

Thanks

You can see all dependencies in package.json

Cite

@INPROCEEDINGS{9974484,
  author={Song, Wenfeng and Wang, Xianfei and Gao, Yang and Hao, Aimin and Hou, Xia},
  booktitle={2022 IEEE International Symposium on Mixed and Augmented Reality Adjunct (ISMAR-Adjunct)}, 
  title={Real-time Expressive Avatar Animation Generation based on Monocular Videos}, 
  year={2022},
  volume={},
  number={},
  pages={429-434},
  doi={10.1109/ISMAR-Adjunct57072.2022.00092}}

SysMocap

Explore related projects