MaxLiu22/Motion2MixamoRig

O que é?

Recursos principais

• 01Extrai o movimento de uma pessoa em um vídeo ou foto.
• 02Transfere o movimento para personagens com rig do Mixamo, incluindo modelos FBX reexportados do Cinema 4D.
• 03Exporta um personagem .glb com malha deformável, além dos dados de movimento do esqueleto.
• 04Reutiliza esqueletos salvos para aplicar rapidamente um movimento a vários personagens.
• 05Oferece uma extensão para Blender 4.2 ou posterior que executa o pipeline sem exigir programação.

Casos de uso

• Adicionar aos personagens de jogos movimentos capturados de vídeos de referência.
• Criar prévias de animação de personagens do Mixamo no Blender ou no Unity.
• Transformar a pose de uma foto em uma pose 3D estática em um personagem com rig.

Início rápido

1. 1

   Clone o repositório

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

   Crie um virtualenv e instale as dependências

   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

   Verifique os recursos e o ambiente

   m2mr doctor
4. 4

   Execute o pipeline com o vídeo mais recente de assets/video/

   m2mr run

Antes de usar

• !É um projeto experimental; o README informa que ele está atualmente em fase experimental.
• !É necessário baixar manualmente um modelo SMPL-X (é preciso se cadastrar e, por padrão, o uso é apenas não comercial) e um personagem do Mixamo.
• !Na primeira execução, são baixados cerca de 5 GB de pesos de inferência, e a extração pela CPU é lenta.
• !Só oferece suporte a clipes com uma única pessoa e o corpo inteiro dentro do quadro.

Tópicos

Perguntas frequentes

O que é Motion2MixamoRig?

Transfere movimentos humanos de um vídeo ou foto para um personagem 3D com rig do Adobe Mixamo e exporta um arquivo .glb com malha deformável. Motion2MixamoRig captura o movimento de uma pessoa em um vídeo ou a pose em uma foto e aplica esse movimento a um personagem com rig do Adobe Mixamo. O resultado é um arquivo de personagem com malha deformável (.glb), que pode ser importado no Blender ou no Unity, além de vídeos ou imagens de prévia do esqueleto, do personagem e de uma comparação lado a lado.

Motion2MixamoRig é gratuito? Qual é a licença?

Motion2MixamoRig é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

Motion2MixamoRig ainda é mantido?

Manutenção ativa. O último commit de Motion2MixamoRig foi em 17 de out. de 2026.

Para que posso usar Motion2MixamoRig?

Adicionar aos personagens de jogos movimentos capturados de vídeos de referência. Criar prévias de animação de personagens do Mixamo no Blender ou no Unity. Transformar a pose de uma foto em uma pose 3D estática em um personagem com rig.

Como instalar Motion2MixamoRig?

Clone o repositório: git clone https://github.com/MaxLiu22/Motion2MixamoRig.git Crie um virtualenv e instale as dependências: 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 . Verifique os recursos e o ambiente: m2mr doctor Execute o pipeline com o vídeo mais recente de assets/video/: m2mr run

Onde consigo Motion2MixamoRig?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/MaxLiu22/Motion2MixamoRig