{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "gary149-h3-game-sprites--cut-move-clip-into-sprite-frames",
 "repo": "gary149/h3-game-sprites",
 "repo_url": "https://github.com/gary149/h3-game-sprites",
 "repo_slug": "gary149-h3-game-sprites",
 "title": "Cut a generated move clip into keyed sprite frames",
 "page_title": "How to cut a generated move clip into keyed sprite frames with H3 Game Sprites",
 "summary": "Turn one AI-generated punch or kick clip into transparent, keyed sprite frames you can check.",
 "who": "A solo indie game developer with a 2D fighter or action character who has one generated move clip and needs usable frames for the engine.",
 "problem": "A raw video clip has a flat magenta backdrop, dozens of near-identical frames and no transparency, so it cannot go into a game as is.",
 "outcome": "A folder of keyed frames with a strip, a GIF and a metrics report showing key purity and how closely the move returns to its starting pose.",
 "steps": [
  "Generate the character still on a flat magenta backdrop in side view, then generate the move clip with the first and last frame set to the same idle still (the idle pin).",
  "Save the clip as clips/punch.mp4.",
  "Run `python3 scripts/sprite_cut.py clips/punch.mp4 sprites/punch --frames 12`.",
  "Open the strip, the GIF and the metrics report in sprites/punch and check key purity per frame and the return-to-start figure.",
  "If the pose extremes look wrong, change the --frames value and run the same command again."
 ],
 "agent_prompt": "Using the h3-game-sprites repo, cut the move clip at <path to clip.mp4> into 12 keyed frames with scripts/sprite_cut.py, writing to sprites/<move-name>. Report the output folder contents and the key purity and return-to-start numbers from the metrics report, and confirm the first and last frames match the idle still.",
 "agents": [
  "claude-code"
 ],
 "difficulty": "Advanced",
 "time": "2 hours",
 "basis": "readme",
 "caveat": "The README gives the chroma-key and clip recipe but does not promise that any generated clip will return cleanly to idle, so check the metrics report before trusting a move.",
 "category": "Games and hobbies",
 "tags": [
  "Games and hobbies"
 ],
 "lang": "python",
 "requirements": [
  "ffmpeg installed locally",
  "Python 3 with Pillow and numpy",
  "A video model such as H3 / Hailuo 3 via OpenRouter, fal or MiniMax, or an ordinary video file you already have",
  "An image model or illustrator for the character still (gen_still.py defaults to Nano Banana through OpenRouter and reads OPENROUTER_API_KEY)",
  "Budget of roughly $0.60-0.70 per five-second clip plus a few cents per still, varying by provider"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "If you use the bundled gen_still.py for the character still, it reads OPENROUTER_API_KEY, so keep that key in your environment and out of the repo and your commits."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/gary149-h3-game-sprites/cut-move-clip-into-sprite-frames/",
 "md": "https://dedupedai.com/use-cases/gary149-h3-game-sprites/cut-move-clip-into-sprite-frames/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/gary149-h3-game-sprites--cut-move-clip-into-sprite-frames.json",
 "api_version": "v1"
}