Empty Action Cleaner add-on for Blender

This add-on deletes Blender Actions that do not contain meaningful animation keyframe data. It is useful after importing or combining animation files, because Blender and importers can sometimes leave behind placeholder Actions, failed import Actions, one-frame pose Actions, or source Actions that no longer hold useful curves.

In Blender, an Action is the container for animation curves. If an Action has no keyframes, or only has keys on one frame, it does not actually animate over time. Keeping those Actions around makes the Action Editor harder to read and can make export/debugging more confusing.

Files

• Add-on: blender_empty_action_cleaner_addon.py
• Panel location: 3D View > Sidebar > Animation > Empty Action Cleaner
• Operator: Delete Empty Actions

Workflow

1. Install and enable blender_empty_action_cleaner_addon.py.
2. Open the Blender file that contains the Actions.
3. Open 3D View > Sidebar > Animation > Empty Action Cleaner.
4. Choose Active Action or All Actions.
5. Leave Dry Run enabled first.
6. Run Delete Empty Actions to see what would be removed.
7. If the result looks right, disable Dry Run and run it again.

Settings

• Scope: check either the active Action or every Action in the file.
• Armature: used only when scope is Active Action.
• Dry Run: reports empty Actions without deleting them.
• Min Keyed Frames: Actions with fewer distinct keyed frames than this are deleted. The default is 2.
• Print Details: prints Action names to the console as they are reported or deleted.

What counts as non-animating

By default, an Action is considered non-animating when it has fewer than two distinct keyed frames. This removes Actions with zero keyframes and Actions that only store a single pose on one frame. The add-on supports both older Blender Actions and Blender 5.x layered Actions.

What it does not delete

• Actions with at least two distinct keyed frames by default.
• Meshes, armatures, materials, or other scene objects.
• Actions that have multiple keyed frames but visually do not move. For those, inspect the curves directly.

Typical use

Run this after using the FBX Animation Combiner or after importing several animation files by hand. It keeps the Action list focused on animation clips that actually contain data.