Shape Key Fixer – Installation & Usage Guide (Full PDF Content)

📦 Installation

Method 1: Install from ZIP (Recommended)

1. Download the addon

   • File: shape_key_fixer.zip

   • Do NOT unzip

2. Open Blender

   • Version 2.80 or newer

3. Open Preferences

   • Edit → Preferences → Add-ons

4. Install the Addon

   • Click Install…

   • Select shape_key_fixer.zip

5. Enable the Addon

   • Search: Shape Key Fixer

   • Check the box to enable

   • Appears in 3D Viewport sidebar

6. Optional: Save Preferences

Method 2: Blender Extensions (Blender 4.2+)

1. Edit → Preferences → Get Extensions

2. Click ⚙️ → Install from Disk

3. Select the ZIP → Install

4. Extension will auto-enable (or enable manually)

🚀 Accessing the Panel

1. Open 3D Viewport

2. Press N to show sidebar

3. Find BlendShapes → Shape Key Fixer

🎯 Quick Start (5-Minute Guide)

Step 1: View All Shape Keys

Panel lists every shape key from every object in your scene.

Step 2: Add a Shape Key

• Select objects

• Click + Add New ShapeKey

• Name it → Added to all selected meshes

Step 3: Create a Group

• Click Make Group

• Select keys → OK

Step 4: Use Group Sliders

• Open a group

• Use Group Value slider

• All keys update together

Step 5: Batch Operations

• Batch Add → Add the same key to many objects

• Batch Remove → Remove specific keys from multiple objects

📚 Features in Detail

Scene-Wide Shape Key Browser

• View all shape keys instantly

• Updates in real time

• Excludes Basis automatically

• Filter with Search

• Click a key name to select its object

Smart Grouping System

Create groups like:

• Eyes

• Smile

• Phonemes

• Correctives

• Clothing deformation

Group management includes:

• Expand/collapse

• Rename

• Add/remove members

• Click group name to select related objects

Real-Time Group Sliders

Change one slider → all keys move.
Fantastic for:

• Facial expressions

• Corrective shapes

• Lip sync

Activate on Select Mode:
Click a group name → instantly sets it to 1.0.

Batch Operations

Batch Add

Add the same shape key to many objects at once.

Batch Remove

Select any shape key → remove from multiple objects.

Remove All With Active

Select a key → delete that key from every object in the scene.

Quick Navigation

Click a shape key to:

• Select object

• Make it active

• Set its shape key active

• Frame it in the viewport

Search & Filter

Type keywords:

• "smile"

• "head"

• "left"
  Filters in real time.

Rename Anything

• Pencil icon next to key

• Pencil icon next to group

💡 Workflow Examples

Character Artist

• Create facial expression keys

• Group by eyes, mouth, brows

• Test with sliders

Facial Rigger

• Add phoneme keys to all face objects using batch

• Create groups for A/E/I/O/U

• Test rig quickly

Animator

• Activate on Select

• Click phoneme groups while animating lip sync

Game Developer

• Organize shape keys by LOD

• Clean unused ones with batch remove

🎯 Pro Tips

Organization

Use prefix naming:

• Eye_

• Mouth_

• Brow_

Group by body part or function.

Time Saving

• Use Search

• Group early

• Batch operations frequently

• Activate on Select toggle for animators

⚠️ Important Notes

Works With:

✔ Mesh objects
✔ Multiple objects
✔ Relative & absolute shape keys
✔ Drivers
✔ Custom normals

Limitations:

❌ Cannot create initial Basis key
❌ Meshes only
❌ Cannot edit vertex positions (use Edit Mode)

Safety:

✔ Won’t delete Basis
✔ Undo/Redo supported
✔ No data corruption

🐛 Troubleshooting

Panel Not Showing

• Press N

• Ensure addon enabled

• Try another workspace

• Restart Blender

Shape Keys Missing

• Check mesh type

• Check search filter

• Basis is hidden by design

Group Slider Not Working

• Check group members

• Re-add if deleted

Make Group / Remove All Issues

Fixed in current version.

📞 Support

Email: [email protected]
Include Blender version, addon version, and steps to reproduce.

🎓 Helpful Shortcuts

• N → Toggle sidebar

• Tab → Edit/Object

• Alt + Click (slider) → Reset

• Shift + Drag (slider) → Fine control

📖 Quick Reference

Shape Key Fixer v1.5.1
© 2025 Junaid Alam (Blender Ustad), Salman Naseem (Being Animator)