Pose Library to Action&Pose
姿勢庫到動作與姿勢

One-click database tool for saving, browsing, and applying character Poses and Actions.

• Create folders to organize characters, managing each character's Poses/Actions separately.

• Save the current pose (Pose) or a continuous animation clip (Action) with one click; each is saved as its own file.

• Thumbnail capture: when saving or recapturing, drag out an adjustable square capture frame (scale and position can be adjusted) — the thumbnail is only applied after you confirm.


• Action thumbnails support animated playback (frames are sampled from the Action's actual keyframes and cycled automatically).


• Double-click a button to directly apply a Pose/Action. Applying a Pose supports a 0–1 blend-strength slider, and will automatically insert keyframes according to the scene's Auto Keying setting.



• Mirror Pose / Mirror Entire Action: based on bone naming (.L / .R, or _L / _R, Left / Right), flip a pose or an entire animation left-right to produce a mirrored version.
  ⚠️ Note: this relies on Blender's own built-in pose-flip mechanism, which mirrors each bone in its own local space. If a bone's local axis orientation doesn't follow the usual convention
   (local axis aligned with the character's left/right), the mirrored values may come out wrong (e.g. flipping front-back instead of left-right). See Known limitations below.



• When you open a new or existing .blend file, previously created character folders are loaded automatically.
• Built-in "Open Folder" button in the panel to open the current storage location directly in your system's file explorer.
• Independent language switch: a "Language" (中文 / English) option in the add-on's own Preferences page lets you choose the panel's display language,
  completely independent of Blender's own system language setting. Switching takes effect immediately, no restart needed.
  • Covered by the switch: panel text, buttons, sliders, the Preferences page's own labels, and operator tooltips.
  • Not covered (always shown in a fixed language, regardless of the switch): the info/warning messages shown in Blender's status bar at the bottom (always English),
    and this add-on's one-line description shown at the top of its entry in the Add-ons list (always English — Blender reads this before the add-on is even enabled,
    so there's no way to make it switchable).

• Blender 4.0 or newer (this add-on uses some newer APIs and is not guaranteed to work below 4.0).
• Works on Windows / macOS / Linux.

1. Download pose_library_to_action_pose.zip.
2. In Blender: Edit > Preferences > Add-ons > Install…, and select this file.
3. Enable "Pose Library to Action&Pose" in the add-ons list.
4. A new "PoseLib" tab will appear in the 3D Viewport's N-panel (right sidebar).

By default, data is stored under Blender's user folder in poselib_data (bpy.utils.user_resource('SCRIPTS', path="poselib_data")). You can also set a custom storage path in the add-on's Preferences (Preferences > Add-ons > this add-on > expand settings).

What gets saved:

• Pose/Action transform data (JSON format — raw bone transform values only, no other scene information).
• Thumbnail captures (PNG format, captured from the 3D Viewport).

This add-on makes no network requests and never sends any data anywhere.

• "Mirror Pose" / "Mirror Entire Action" require bones to use a standard left/right naming convention (.L / .R, or _L / _R, Left / Right) to be paired correctly;
  armatures without this naming may see no effect from these two features.
• "Mirror Pose" / "Mirror Entire Action" are built on top of Blender's own native pose-flip feature (the same one behind "Copy Pose" + "Paste Flipped Pose"),
  which mirrors each bone in its own local space rather than computing a true left-right reflection in world/armature space.
  This works correctly for bones set up with a conventional orientation (local axis aligned with the character's left/right side,
  as is standard practice for most rigs), but can produce visibly wrong results — e.g. a bone flipping front-to-back instead of left-to-right —
  for bones whose local axis orientation doesn't follow this convention. This is a known limitation of Blender's own mirror mechanism,
  not specific to this add-on; the usual fix is to correct the bone's roll/orientation in Edit Mode so its local axis lines up with the intended mirror direction.
• Thumbnail capture relies on the current 3D Viewport (not the camera view) — make sure the content you want is visible in the 3D Viewport when capturing.
• The add-on's own language switch (in its Preferences) covers most of the interface, but not everything —
  see the note under "Independent language switch" above for the specific exceptions.
• If the action slot is empty, you must specify one to view the saved action data.

This project is licensed under GPL-3.0-or-later — see the LICENSE file for details.

• Email: [email protected]