MaxLiu22/Motion2MixamoRig

这是什么？

核心功能

• 01从视频或静态照片中提取单人动作。
• 02将动作重定向到 Mixamo 绑定的角色上，也支持从 Cinema 4D 重新导出的 FBX 模型。
• 03输出带蒙皮的 .glb 角色文件和骨骼动作数据。
• 04复用已保存的骨骼数据，快速把同一动作套用到多个角色。
• 05提供 Blender 4.2+ 扩展，无需编码即可运行整个流程。

适用场景

• 为游戏角色快速制作基于参考视频的动作。
• 在 Blender 或 Unity 中为 Mixamo 角色生成动画预览。
• 把一张姿态照片转换为绑定角色上的静态三维姿态。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/MaxLiu22/Motion2MixamoRig.git
2. 2

   创建虚拟环境并安装依赖

   python -m venv .venv && source .venv/bin/activate && pip install --upgrade pip setuptools wheel && pip install "numpy>=1.26" && pip install --no-build-isolation "chumpy==0.70" && pip install -e .
3. 3

   检查素材和环境

   m2mr doctor
4. 4

   对 assets/video/ 中最新的视频运行流程

   m2mr run

使用前须知

• !项目处于实验阶段，README 明确说明目前为实验性质。
• !需要手动下载 SMPL-X 模型（需注册，默认非商业使用）以及 Mixamo 角色。
• !首次运行会下载约 5 GB 推理权重，CPU 上提取动作较慢。
• !仅支持画面中全身可见的单人视频或照片。

标签

常见问题

Motion2MixamoRig 是什么？

将视频或照片中的人体动作迁移到 Mixamo 绑定的 3D 角色上，输出可用的 .glb 模型。 Motion2MixamoRig 可以把视频中单人的动作，或静态照片中的姿态，套用到 Adobe Mixamo 绑定的角色上。输出为带蒙皮的 .glb 角色文件，可导入 Blender 或 Unity，同时生成骨骼和角色的预览视频或图片，以及左右对比效果。

Motion2MixamoRig 可以免费使用吗？用的什么许可证？

Motion2MixamoRig 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

Motion2MixamoRig 还在维护吗？

活跃维护中。Motion2MixamoRig 最近一次提交是在 2026年10月17日。

Motion2MixamoRig 适合用来做什么？

为游戏角色快速制作基于参考视频的动作。 在 Blender 或 Unity 中为 Mixamo 角色生成动画预览。 把一张姿态照片转换为绑定角色上的静态三维姿态。

Motion2MixamoRig 怎么安装和运行？

克隆仓库: git clone https://github.com/MaxLiu22/Motion2MixamoRig.git 创建虚拟环境并安装依赖: python -m venv .venv && source .venv/bin/activate && pip install --upgrade pip setuptools wheel && pip install "numpy>=1.26" && pip install --no-build-isolation "chumpy==0.70" && pip install -e . 检查素材和环境: m2mr doctor 对 assets/video/ 中最新的视频运行流程: m2mr run

在哪里获取 Motion2MixamoRig？

源代码和安装说明在 GitHub 上：https://github.com/MaxLiu22/Motion2MixamoRig