Repolode
MaxLiu22

MaxLiu22/Motion2MixamoRig

Переносит движения человека с видео или фото на 3D-персонажа с ригом Adobe Mixamo и экспортирует его в формате .glb с привязанной скелетной анимацией.

Звёзды
1,374
Форки
173
Открытые issues
10
Последний коммит
3 дня назад

Что это?

Motion2MixamoRig переносит движения одного человека с видео или позу с фотографии на персонажа с ригом Adobe Mixamo. На выходе получается файл персонажа с привязанной скелетной анимацией (.glb), который можно импортировать в Blender или Unity, а также видео или изображения для предварительного просмотра скелета, персонажа и их сравнения рядом.

Проект представляет собой конвейер на Python с интерфейсом командной строки (`m2mr`): он извлекает позу человека, переносит повороты на скелет Mixamo и рендерит превью. Если сохранить скелет и указать его через `--skeleton`, можно применить те же движения к другому персонажу, не повторяя медленный этап извлечения. Также в комплект входит расширение для Blender 4.2+, которое запускает тот же конвейер во внешней среде Python и позволяет работать без программирования.

Модель тела SMPL-X и FBX-файл персонажа Mixamo нужно скачать отдельно из-за условий их лицензий. Веса для инференса скачиваются автоматически при первом запуске и занимают около 5 ГБ. Рекомендуется установить ffmpeg, чтобы выходные видео содержали аудиодорожки и воспроизводились в браузерах.

Ключевые возможности

  • 01Извлекает движения одного человека из видео или позу с фотографии.
  • 02Переносит движения на персонажей с ригом Mixamo, в том числе на модели FBX, повторно экспортированные из Cinema 4D.
  • 03Экспортирует персонажа с привязанной скелетной анимацией в формате .glb и данные движения скелета.
  • 04Позволяет повторно использовать сохранённые скелеты, чтобы быстро применить одни и те же движения к нескольким персонажам.
  • 05Предоставляет расширение для Blender 4.2+, которое запускает конвейер без программирования.

Сценарии использования

  • Добавление игровым персонажам движений, снятых с эталонных видео.
  • Создание превью анимации персонажей Mixamo в Blender или Unity.
  • Преобразование фотографии с одной позой в статичную 3D-позу на персонаже с ригом.

Быстрый старт

  1. 1

    Клонируйте репозиторий

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

    Создайте virtualenv и установите зависимости

    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

    Запустите pipeline на самом новом видео из assets/video/

    m2mr run

Что важно знать

  • Экспериментальный проект; в README указано, что сейчас он находится на экспериментальной стадии.
  • Необходимо вручную скачать модель SMPL-X (требуется регистрация; по умолчанию разрешено только некоммерческое использование) и персонажа Mixamo.
  • При первом запуске скачивается около 5 ГБ весов для инференса, а обработка на CPU выполняется медленно.
  • Поддерживаются только клипы с одним человеком, целиком помещающимся в кадр.

Темы

Частые вопросы

Что такое Motion2MixamoRig?
Переносит движения человека с видео или фото на 3D-персонажа с ригом Adobe Mixamo и экспортирует его в формате .glb с привязанной скелетной анимацией. Motion2MixamoRig переносит движения одного человека с видео или позу с фотографии на персонажа с ригом Adobe Mixamo. На выходе получается файл персонажа с привязанной скелетной анимацией (.glb), который можно импортировать в Blender или Unity, а также видео или изображения для предварительного просмотра скелета, персонажа и их сравнения рядом.
Motion2MixamoRig можно использовать бесплатно? Какая у него лицензия?
Motion2MixamoRig распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
Motion2MixamoRig всё ещё поддерживается?
Активно поддерживается. Последний коммит в Motion2MixamoRig — 17 окт. 2026 г..
Для чего можно использовать Motion2MixamoRig?
Добавление игровым персонажам движений, снятых с эталонных видео. Создание превью анимации персонажей Mixamo в Blender или Unity. Преобразование фотографии с одной позой в статичную 3D-позу на персонаже с ригом.
Как установить Motion2MixamoRig?
Клонируйте репозиторий: git clone https://github.com/MaxLiu22/Motion2MixamoRig.git Создайте virtualenv и установите зависимости: 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 Запустите pipeline на самом новом видео из assets/video/: m2mr run
Где скачать Motion2MixamoRig?
Исходный код и инструкции по установке — на GitHub: https://github.com/MaxLiu22/Motion2MixamoRig

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты