Repolode
MaxLiu22

MaxLiu22/Motion2MixamoRig

영상이나 사진의 사람 동작을 Adobe Mixamo 리그 3D 캐릭터에 적용해 스킨이 포함된 .glb 파일로 내보냅니다.

스타
1,374
포크
173
열린 이슈
10
마지막 커밋
3일 전

어떤 프로젝트인가요?

Motion2MixamoRig는 영상 속 한 사람의 동작이나 사진 속 포즈를 Adobe Mixamo용으로 리깅된 캐릭터에 적용합니다. 결과물은 Blender나 Unity에서 가져올 수 있는 스킨이 포함된 캐릭터 파일(.glb)이며, 스켈레톤과 캐릭터 미리보기 영상 또는 이미지, 나란히 비교한 결과도 함께 생성됩니다.

이 프로젝트는 사람의 포즈를 추출하고, 회전을 Mixamo 스켈레톤에 맞게 리타기팅한 뒤 미리보기를 렌더링하는 Python 커맨드라인 파이프라인(`m2mr`)입니다. 저장한 스켈레톤을 `--skeleton`으로 재사용하면 시간이 오래 걸리는 추출 단계를 반복하지 않고 같은 동작을 다른 캐릭터에 적용할 수 있습니다. 코딩 없이 사용할 수 있도록 별도의 Python 환경에서 동일한 파이프라인을 실행하는 Blender 4.2+ 확장 기능도 제공합니다.

SMPL-X 바디 모델과 Mixamo 캐릭터 FBX는 각각의 라이선스 조건에 따라 별도로 다운로드해야 합니다. 추론 가중치는 첫 실행 시 자동으로 다운로드되며 용량은 약 5 GB입니다. 출력 영상에 오디오 트랙을 포함하고 브라우저에서 재생하려면 ffmpeg를 사용하는 것이 좋습니다.

핵심 기능

  • 01영상이나 사진에서 한 사람의 동작을 추출합니다.
  • 02Cinema 4D에서 다시 내보낸 FBX 모델을 포함해 Mixamo 리그 캐릭터에 동작을 리타기팅합니다.
  • 03스킨이 포함된 .glb 캐릭터와 스켈레톤 동작 데이터를 내보냅니다.
  • 04저장된 스켈레톤을 재사용해 하나의 동작을 여러 캐릭터에 빠르게 적용합니다.
  • 05코딩 없이 파이프라인을 실행할 수 있는 Blender 4.2+ 확장 기능을 제공합니다.

활용 사례

  • 참고 영상에서 캡처한 동작을 게임 캐릭터에 적용하기.
  • Blender나 Unity에서 Mixamo 캐릭터의 애니메이션 미리보기 만들기.
  • 한 장의 포즈 사진을 리깅된 캐릭터의 정적인 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

    assets/video/에서 가장 최근 동영상으로 파이프라인을 실행합니다

    m2mr run

사용 전 알아둘 점

  • 실험적인 프로젝트입니다. README에도 현재 실험 단계라고 안내되어 있습니다.
  • SMPL-X 모델(등록 필요, 기본적으로 비상업적 용도만 허용)과 Mixamo 캐릭터를 수동으로 다운로드해야 합니다.
  • 최초 실행 시 추론 가중치를 약 5GB 다운로드하며, CPU에서 추출하는 데 시간이 오래 걸립니다.
  • 사람 한 명의 전신이 프레임 안에 담긴 클립만 지원합니다.

토픽

자주 묻는 질문

Motion2MixamoRig은(는) 무엇인가요?
영상이나 사진의 사람 동작을 Adobe Mixamo 리그 3D 캐릭터에 적용해 스킨이 포함된 .glb 파일로 내보냅니다. Motion2MixamoRig는 영상 속 한 사람의 동작이나 사진 속 포즈를 Adobe Mixamo용으로 리깅된 캐릭터에 적용합니다. 결과물은 Blender나 Unity에서 가져올 수 있는 스킨이 포함된 캐릭터 파일(.glb)이며, 스켈레톤과 캐릭터 미리보기 영상 또는 이미지, 나란히 비교한 결과도 함께 생성됩니다.
Motion2MixamoRig은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Motion2MixamoRig은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Motion2MixamoRig은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Motion2MixamoRig의 마지막 커밋은 2026년 10월 17일입니다.
Motion2MixamoRig은(는) 어디에 사용할 수 있나요?
참고 영상에서 캡처한 동작을 게임 캐릭터에 적용하기. Blender나 Unity에서 Mixamo 캐릭터의 애니메이션 미리보기 만들기. 한 장의 포즈 사진을 리깅된 캐릭터의 정적인 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 assets/video/에서 가장 최근 동영상으로 파이프라인을 실행합니다: m2mr run
Motion2MixamoRig은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/MaxLiu22/Motion2MixamoRig

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트