Repolode
MaxLiu22

MaxLiu22/Motion2MixamoRig

動画や静止画の人物の動きをAdobe Mixamoリグの3Dキャラクターにリターゲットし、スキン付きの.glbファイルとして出力します。

スター
1,351
フォーク
172
未解決の Issue
10
最終コミット
3 日前

これは何?

Motion2MixamoRigは、動画に映る1人の人物の動き、または静止画のポーズを、Adobe Mixamo用にリギングされたキャラクターに適用します。出力されるのはBlenderやUnityにインポートできるスキン付きキャラクターファイル(.glb)で、骨格、キャラクター、および並べて比較したプレビュー動画や画像も生成できます。

このプロジェクトはPython製のコマンドラインパイプライン(`m2mr`)で、人物のポーズ抽出、Mixamo骨格への回転のリターゲット、プレビューのレンダリングを行います。保存済みの骨格を`--skeleton`で再利用すれば、時間のかかる抽出処理を繰り返さずに、同じ動きを別のキャラクターに適用できます。また、Blender 4.2以降の拡張機能も付属しており、外部のPython環境で同じパイプラインを実行できるため、コードを書かずに利用できます。

SMPL-XのボディモデルとMixamoキャラクターのFBXは、それぞれのライセンス上の理由から別途ダウンロードが必要です。推論用の重みは初回実行時に自動取得され、容量は約5 GBです。出力動画に音声トラックを含め、ブラウザーで再生できるようにするには、ffmpegの利用が推奨されています。

主な機能

  • 01動画または静止画から1人の人物の動きを抽出します。
  • 02Cinema 4Dから再エクスポートしたFBXモデルを含む、Mixamoリグのキャラクターに動きをリターゲットします。
  • 03スキン付きの.glbキャラクターと骨格のモーションデータを出力します。
  • 04保存済みの骨格を再利用して、1つの動きを複数のキャラクターにすばやく適用できます。
  • 05コードを書かずにパイプラインを実行できる、Blender 4.2以降の拡張機能を提供します。

ユースケース

  • 参照動画からキャプチャした動きをゲームキャラクターに付ける。
  • BlenderやUnityでMixamoキャラクターのアニメーションプレビューを作成する。
  • 1枚のポーズ写真から、リギング済みキャラクターに静止した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キャラクターを手動でダウンロードする必要があります。
  • 初回実行時に推論用の重みを約5 GBダウンロードします。また、CPUでの抽出には時間がかかります。
  • 全身がフレーム内に収まっている1人の人物のクリップのみをサポートします。

トピック

よくある質問

Motion2MixamoRig とは?
動画や静止画の人物の動きをAdobe Mixamoリグの3Dキャラクターにリターゲットし、スキン付きの.glbファイルとして出力します。 Motion2MixamoRigは、動画に映る1人の人物の動き、または静止画のポーズを、Adobe Mixamo用にリギングされたキャラクターに適用します。出力されるのはBlenderやUnityにインポートできるスキン付きキャラクターファイル(.glb)で、骨格、キャラクター、および並べて比較したプレビュー動画や画像も生成できます。
Motion2MixamoRig は無料で使えますか?ライセンスは?
Motion2MixamoRig は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
Motion2MixamoRig は今もメンテナンスされていますか?
活発にメンテナンス中。Motion2MixamoRig の最終コミットは 2026年10月17日 です。
Motion2MixamoRig は何に使えますか?
参照動画からキャプチャした動きをゲームキャラクターに付ける。 BlenderやUnityでMixamoキャラクターのアニメーションプレビューを作成する。 1枚のポーズ写真から、リギング済みキャラクターに静止した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 の数値は毎日更新されます。

関連プロジェクト