{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "squall01337-mixamo-llm-mocap--video-to-mixamo-fk-animation",
 "repo": "squall01337/mixamo-llm-mocap",
 "repo_url": "https://github.com/squall01337/mixamo-llm-mocap",
 "repo_slug": "squall01337-mixamo-llm-mocap",
 "title": "Turn a locked-camera video into a Mixamo animation",
 "page_title": "How to turn a locked-camera video into a Mixamo animation with Mixamo LLM Mocap",
 "summary": "Retarget a single-performer video onto your Mixamo rig as a headless FK clip in Blender.",
 "who": "A 3D animator or indie game developer with a Mixamo character who needs a motion clip from a video and has no mocap suit.",
 "problem": "Hand keyframing a short action is slow, and a mocap suit is not available for a one-off clip.",
 "outcome": "A saved .blend with the action keyed on your Mixamo rig, plus a motion file, produced without opening the Blender UI.",
 "steps": [
  "Build your rig scene from your Mixamo download: `blender --background --python pipeline\\setup_rig.py -- --fbx ybot.fbx --out ybot_rest.blend`",
  "Write an action spec in action_specs\\ with name, action_name, clip_dir, landmarks and fps (schema in docs/PIPELINE.md section S).",
  "Estimate the pose from the plate: `tools\\GVHMR\\.venv\\Scripts\\python.exe pipeline\\estimate_pose_gvhmr.py --video plates\\<clip>.mp4 --out plates\\<clip>\\landmarks.json --smplx-only` (inferred, check the README)",
  "Retarget the SMPL-X rotations onto your rig: `python pipeline\\retarget_smplx.py --spec action_specs\\<clip>.json` (inferred, check the README)",
  "Key the action and save the .blend headless: `blender -b ybot_rest.blend -P pipeline\\bl_motion.py -- apply --motion clips\\<clip>\\motion.npz --save clips\\<clip>\\<clip>.blend` (inferred, check the README)"
 ],
 "agent_prompt": "In the squall01337/mixamo-llm-mocap repo, take the video at <video path> and an action spec for it, then run the SMPL-X path (estimate_pose_gvhmr.py --smplx-only, retarget_smplx.py, bl_motion.py -b apply) onto the rig <rig .blend path>. Expected output: a saved .blend with the action keyed on the Mixamo rig. Verify the .blend exists and the action name in the spec matches the action in the file.",
 "agents": [
  "any"
 ],
 "difficulty": "Advanced",
 "time": "4 hours",
 "basis": "readme",
 "caveat": "GVHMR, its checkpoints and the SMPL-X body model are separate downloads that are not in this repo, and Adobe terms do not allow redistributing Mixamo characters.",
 "category": "Content",
 "tags": [
  "Content"
 ],
 "lang": "python",
 "requirements": [
  "Blender 5.1 or newer",
  "A Mixamo character downloaded as FBX Binary in T-pose from mixamo.com",
  "GVHMR cloned into tools/GVHMR with its checkpoints (about 5 GB), set up per docs/INSTALL.md",
  "SMPL-X v1.1 body model (free research registration at smpl-x.is.tue.mpg.de), placed as SMPLX_NEUTRAL.npz",
  "A GPU with about 8 GB VRAM (developed on an RTX 4080)",
  "A locked-camera video plate (filmed or AI-generated)"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/squall01337-mixamo-llm-mocap/video-to-mixamo-fk-animation/",
 "md": "https://dedupedai.com/use-cases/squall01337-mixamo-llm-mocap/video-to-mixamo-fk-animation/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/squall01337-mixamo-llm-mocap--video-to-mixamo-fk-animation.json",
 "api_version": "v1"
}