toyxyz/toyxyz_RGBMocap

项目介绍

RGB MoCap 是一个原生 Windows 应用，把普通视频中的人物重建为 3D 人体网格和动画骨骼，并整理成可直接使用的角色动画。重建由可切换的 AI 模型在本地完成，应用再提供脚掌/手掌接触修正、人形角色重定向，以及面向 FBX（源动画或带动画/网格的角色）和 VMD（MMD 角色动作）的导出。项目会为每个 AI 模型分别保存结果。另有实验性的 PEAR 预览，可通过摄像头实时查看单人的身体与手指骨骼，但不录制。

适合已经在 Mixamo、VRM、PMX/MMD 或 Blender 流程里工作的动画师和技术美术，用普通视频做无标记捕捉，且不希望把素材上传到云端。

快速使用

需要 64 位 Windows、兼容的 NVIDIA GPU 与驱动，以及 OpenGL 4.3。先安装 Git for Windows，再在可写目录中克隆并启动：

git clone https://github.com/toyxyz/toyxyz_RGBMocap.git
cd toyxyz_RGBMocap
install.cmd
RGBMoCap.cmd

install.cmd 会准备 ExMR、FlowHMR、GVHMR 的运行时及 PEAR 预览支持、Blender、FFmpeg 和原生修正组件，但不会下载 AI 权重；权重需在 Model Manager 中单独准备，部分提供方要求注册账号并手动下载。运行期间保持控制台窗口开启。更新时关闭应用，在同一目录运行 update.cmd。

进入应用后选择模型，用 File > Open Video 打开视频，必要时用 Find person 选定人物，点击 Reconstruct 3D；检查动作、按需编辑接触并应用修正，之后导出 FBX，或导入角色、重定向后导出。多机位捕捉是单独的可选组件，需在基础安装后运行 Setup_MAMMA.cmd。具体控件、默认值和模型文件见用户指南与模型指南。

存储与可选模型

五个离线模型连同运行时约占 63.1 GiB（约 67.8 GB），该数字在不含项目、缓存和保留下载的情况下测得。MAMMA（多视角）和 PromptHMR 需要单独安装脚本并在本地编译，依赖 Visual Studio 2022 C++ Build Tools、Windows SDK 和 CUDA Toolkit 12.8；install.cmd 与 update.cmd 都不会安装它们。PEAR 额外约 2.84 GiB，复用共享运行时。应用源码、编译工具、安装临时文件和保存的作品还需要额外空间，README 的实测大小不是可用空间的保证，详见存储与安装说明。

使用约束

• 仅支持 64 位 Windows，需要兼容的 NVIDIA GPU 与驱动，以及 OpenGL 4.3。
• 模型权重需另行获取，部分要求注册并接受许可；第三方组件沿用各自许可，RGB MoCap 自身代码为 MIT。
• MAMMA 和 PromptHMR 需主动安装且各自需要编译/CUDA 工具链；PromptHMR 不生成手指动作，作者的主观测试中其整体动作质量低于 ExMR，但对单段视频里多人之间的相对位置和互动可能更好。
• PEAR 实时预览为实验性功能，可能不稳定，只提供骨骼预览，不录制、不修正、不导出。
• 建议从 Resource Mode > Automatic 开始；Low Memory 以更慢的加载和更多系统内存换取更低的显存占用。README 中的显存与速度数字来自短片段/配对测试，不代表完整任务的保证。

HotRepo 点评

在 HotRepo 的新项目榜中，该项目于 2026-11-01 出现在 Python 语言榜，统计截至当日 09:45 UTC 的约 24 小时窗口内新增 74 Star。从 2026-10-30 14:45 UTC 的 365 Star 到 2026-11-01 09:45 UTC 的 505 Star，逐小时采样显示的是持续累积而非单点爆发，中间也有停涨区间，例如 2026-11-01 01:45–03:45 UTC。站内没有记录到全部语言日榜名次，也没有 Hacker News 讨论，所以这只是有限的增长信号，不能说明采用率或产出质量。它的实用差异点在于本地、多模型流水线，配合明确的接触修正和 FBX/VMD 目标；但约 63 GiB 的体积和需要注册才能获取的权重，意味着更适合已经确定使用 Windows/NVIDIA 角色动画流程的人再深入评估。