Action Name Cleaner add-on for Blender
Blender calls reusable animation clips Actions. Other tools and file formats may call the same idea animations, clips, takes, sequences, stacks, or animation layers.
When animation data moves between tools, exporters often wrap the original animation name with extra context. They may include the armature object name, the FBX animation stack, a take name, a layer name, or the name of the imported object that owned the animation. This is why a readable animation name can turn into something like this:
Armature.001|Rifle_StrafeRun135LeftLoop|Rifle_StrafeRun135LeftLoop:BaseAnimation
The useful part is still the animation name. The Action Name Cleaner removes duplicated exporter information and converts the result to snake case:
rifle_strafe_run_135_left_loop
Files
- Add-on: blender_action_name_cleaner_addon.py
- Panel location:
3D View > Sidebar > Animation > Action Name Cleaner - Operator:
Clean Action Names
What it cleans
- Object wrapper names such as
Armature.001. - FBX-style separators such as
|and:. - Duplicated animation segments.
- Generic suffixes such as
BaseAnimation,Layer0, andAnimation. - CamelCase names, which are split into snake case.
- Numbers embedded in words, such as
Run135Leftbecomingrun_135_left.
Workflow
- Install and enable
blender_action_name_cleaner_addon.py. - Open the Blender file that contains the Actions.
- Open
3D View > Sidebar > Animation > Action Name Cleaner. - Choose
Active ActionorAll Actions. - Optionally enable
Print Mappingto print old and new names to the console. - Run
Clean Action Names.
Examples
Armature.001|Rifle_StrafeRun135LeftLoop|Rifle_StrafeRun135LeftLoop:BaseAnimation
-> rifle_strafe_run_135_left_loop
Armature|Walk|Walk:BaseAnimation
-> walk
mixamorig:Hips|RunForward|RunForward:Layer0
-> run_forward
Notes
- The normalized form is always snake case.
- If two Actions normalize to the same name, the add-on appends a numeric suffix such as
_01. - This add-on only renames Actions. It does not modify keyframes, armatures, meshes, or exported animation data.