gitwtfhub

wtf is arkit-pose-recorder-for-blender?

harlynkingm/arkit-pose-recorder-for-blender — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · designerComplexity · 2/5Setup · easy

TL;DR

A Blender addon that lets animators build the 52 standard ARKit face expressions by posing bones instead of sculpting, then bakes them into shape keys, with left/right mirroring and reusable presets.

Mindmap

mindmap
  root((repo))
    What it does
      Pose based blendshapes
      Bakes to shape keys
      52 ARKit expressions
      Left right mirroring
    Tech stack
      Python
      Blender addon
      Pillow optional
    Use cases
      Rig game character faces
      Reuse poses across characters
      Build ARKit compatible rigs
    Audience
      3D animators
      Game riggers
      Character artists
    Setup
      Blender 4.0 plus
      Zip and install addon
      Pillow for gif preview

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build all 52 ARKit facial blendshapes on a character by posing bones instead of sculpting each shape by hand.

REASON 2

Mirror a saved facial pose from the left side of the face to the right side automatically.

REASON 3

Export saved pose data as a JSON preset and reuse it on other characters sharing the same rig.

REASON 4

Preview an animated reference GIF for each ARKit shape to check the pose is correct.

What's in the stack?

PythonBlenderPillow

How it stacks up

harlynkingm/arkit-pose-recorder-for-blender0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedesignergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires Blender 4.0 or newer, the optional GIF preview needs Pillow installed into Blender's own bundled Python.

The README does not state a license, so usage terms are unclear.

Wtf does this do

This is an addon for Blender, the free 3D modeling program, aimed at people who rig and animate character faces for games or animation. It helps you build the 52 standard ARKit face shapes, the set of facial expressions Apple's face tracking system uses, by posing a character's face bones directly rather than sculpting the mesh by hand for each one. Once you have posed and saved a shape, the addon can bake all of them into real shape keys on the mesh in a single step. The workflow starts by picking the face armature, meaning the bone rig, and the face mesh that will receive the finished shapes. The 52 ARKit shapes then show up automatically in a list inside the addon's panel. For each one, you pose the relevant bones in the viewport by hand and click Save Pose, and only the bones you actually moved get recorded, so you do not need to touch every bone for every shape. A preview button lets you recall a saved pose to check it, and a reset button returns the rig to its resting position without losing any saved data. A useful feature is left and right mirroring. Many face shapes come in pairs, like a smile on the left side and a smile on the right side, and the addon can reflect a saved pose from one side to its counterpart using the bone's own natural orientation rather than a simple flip. Saved pose data can also be exported to a JSON preset file and reused on other characters that share the same rig and bone names, so the work only has to be done once per rig. Each shape's description panel can show an animated reference GIF explaining how that expression should look, though this feature needs the Pillow image library installed into Blender's own bundled Python rather than the regular system Python. Everything else in the addon works without that extra step. The project targets Blender version 4.0 and above and was tested on version 5.1. The author credits an existing VRoid blendshape reference project and a related Google document for background information used in building this addon.

Yoink these prompts

Prompt 1
Walk me through installing this ARKit pose recorder addon into Blender and enabling it.
Prompt 2
Explain how the Save Pose and Apply All Saved to Mesh buttons work together in this workflow.
Prompt 3
Help me install Pillow into Blender's bundled Python so the animated GIF previews work.
Prompt 4
Show me how to set up the Bone Mirror Map so left and right facial shapes mirror correctly.
Prompt 5
Explain how to export a JSON preset from this addon and reuse it on a second character with the same rig.

Frequently asked questions

wtf is arkit-pose-recorder-for-blender?

A Blender addon that lets animators build the 52 standard ARKit face expressions by posing bones instead of sculpting, then bakes them into shape keys, with left/right mirroring and reusable presets.

What language is arkit-pose-recorder-for-blender written in?

Mainly Python. The stack also includes Python, Blender, Pillow.

What license does arkit-pose-recorder-for-blender use?

The README does not state a license, so usage terms are unclear.

How hard is arkit-pose-recorder-for-blender to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is arkit-pose-recorder-for-blender for?

Mainly designer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.