Repolode
Enviar
MaxLiu22

MaxLiu22/Motion2MixamoRig

Transfiere movimiento humano de un video o una foto fija a un personaje 3D con rig de Adobe Mixamo y exporta un archivo .glb con skin.

Ver en GitHub
Estrellas
1,351
Forks
172
Issues abiertos
10
Último commit
hace 3 días

¿Qué es?

Motion2MixamoRig toma el movimiento de una persona en un video, o la pose de una foto fija, y lo aplica a un personaje con rig para Adobe Mixamo. El resultado es un archivo de personaje con skin (.glb) que se puede importar en Blender o Unity, junto con videos o imágenes de vista previa del esqueleto y el personaje, además de una comparación lado a lado.

El proyecto es un pipeline de línea de comandos de Python (`m2mr`) que extrae la pose humana, adapta las rotaciones al esqueleto de Mixamo y renderiza vistas previas. Si reutilizas un esqueleto guardado con `--skeleton`, puedes aplicar el mismo movimiento a otro personaje sin repetir el lento paso de extracción. También incluye una extensión para Blender 4.2 o posterior que ejecuta el mismo pipeline en un entorno externo de Python, para que se pueda usar sin programar.

El modelo corporal SMPL-X y el FBX del personaje de Mixamo deben descargarse por separado debido a sus respectivas licencias. Los pesos de inferencia se descargan automáticamente durante la primera ejecución y ocupan unos 5 GB. Se recomienda ffmpeg para que los videos de salida incluyan pistas de audio y se reproduzcan en navegadores.

Funciones clave

  • 01Extrae el movimiento de una persona a partir de un video o una foto fija.
  • 02Adapta el movimiento a personajes con rig de Mixamo, incluidos modelos FBX reexportados desde Cinema 4D.
  • 03Exporta un personaje .glb con skin y los datos de movimiento del esqueleto.
  • 04Reutiliza esqueletos guardados para aplicar rápidamente un movimiento a varios personajes.
  • 05Ofrece una extensión para Blender 4.2 o posterior que ejecuta el pipeline sin necesidad de programar.

Casos de uso

  • Añadir a personajes de videojuegos movimiento capturado de videos de referencia.
  • Crear vistas previas de animación para personajes de Mixamo en Blender o Unity.
  • Convertir una foto con una pose en una pose 3D estática sobre un personaje con rig.

Inicio rápido

  1. 1

    Clona el repositorio

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

    Crea un virtualenv e instala las dependencias

    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

    Comprueba los recursos y el entorno

    m2mr doctor
  4. 4

    Ejecuta el pipeline con el vídeo más reciente de assets/video/

    m2mr run

Antes de usarlo

  • Es un proyecto experimental; el README indica que actualmente está en fase experimental.
  • Debes descargar manualmente un modelo SMPL-X (requiere registro y, por defecto, solo permite uso no comercial) y un personaje de Mixamo.
  • La primera ejecución descarga unos 5 GB de pesos de inferencia, y la extracción con CPU es lenta.
  • Solo admite clips con una persona y el cuerpo entero dentro del encuadre.

Temas

#motion-capture#3d-animation#pose-estimation#mixamo#blender#retargeting#game-development

Preguntas frecuentes

¿Qué es Motion2MixamoRig?
Transfiere movimiento humano de un video o una foto fija a un personaje 3D con rig de Adobe Mixamo y exporta un archivo .glb con skin. Motion2MixamoRig toma el movimiento de una persona en un video, o la pose de una foto fija, y lo aplica a un personaje con rig para Adobe Mixamo. El resultado es un archivo de personaje con skin (.glb) que se puede importar en Blender o Unity, junto con videos o imágenes de vista previa del esqueleto y el personaje, además de una comparación lado a lado.
¿Motion2MixamoRig es gratuito? ¿Qué licencia tiene?
Motion2MixamoRig es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Motion2MixamoRig sigue mantenido?
Mantenimiento activo. El último commit de Motion2MixamoRig fue el 17 oct 2026.
¿Para qué puedo usar Motion2MixamoRig?
Añadir a personajes de videojuegos movimiento capturado de videos de referencia. Crear vistas previas de animación para personajes de Mixamo en Blender o Unity. Convertir una foto con una pose en una pose 3D estática sobre un personaje con rig.
¿Cómo se instala Motion2MixamoRig?
Clona el repositorio: git clone https://github.com/MaxLiu22/Motion2MixamoRig.git Crea un virtualenv e instala las dependencias: 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 . Comprueba los recursos y el entorno: m2mr doctor Ejecuta el pipeline con el vídeo más reciente de assets/video/: m2mr run
¿Dónde consigo Motion2MixamoRig?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/MaxLiu22/Motion2MixamoRig

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados