PXLtools — Tool guide
Batch Renamer — rename hierarchies, fast
Rename a whole hierarchy in one pass. Batch Renamer composes new names from a prefix, base name and suffix, adds zero-padded sequential numbers, and does scene-wide find-and-replace — namespace-aware, undo-wrapped, deepest-child-first so nothing collides. For one object or a hundred, your naming convention applied consistently every time.
The interface
01
Overview
Batch Renamer renames a selected hierarchy in a single operation. It builds each new name from an optional prefix, a base name (or the original name kept as-is), and an optional suffix, then appends a zero-padded sequential number when you want one. A separate Search & Replace pass swaps text in existing names across the selection.
It is namespace-aware, wraps every change in an undo chunk, and renames deepest-child-first so parent renames never break the paths beneath them. It shares the same UI kit as the rest of PXLtools and auto-updates from GitHub on launch.
02
Requirements
- Autodesk Maya 2025
- Python 3
Maya 2025 already includes PySide6. You do not install it, you do not pip anything, you do not touch your Python environment.
03
Availability
Batch Renamer is part of Cristian's PXLtools production toolkit and isn't publicly downloadable yet. The TurnTable tool is the first public PXLtools release; the rest of the suite is rolling out gradually. Want early access, or to be notified when it ships? Get in touch.
04
Using Batch Renamer
Two independent tools in one window: a RENAME composer and a SEARCH & REPLACE pass.
Rename a hierarchy
- Select objects in the scene. Pick the top of the hierarchy you want renamed.
- Compose the name. Fill any of
Prefix (optional),Base Name(leave empty to keep the original names), andSuffix (optional). The output order is prefix + base + suffix + number. - Add numbering (optional). Tick
Add Sequential Numbers, then setStart(default 1) andPadding(default 3, e.g. 001, 002…). - Rename. Press
Rename Selected Hierarchy. The status line confirms the result; the whole rename is a single undo step.
Search & replace
- Open the
SEARCH & REPLACEsection. - Enter the text to
Findand the text toReplace With. - Press
Search and Replaceto swap it across the selected names.
Tip: Reset All Fields clears everything back to defaults. Names are sanitised to valid Maya identifiers (non-alphanumeric characters become underscores), so you never end up with an illegal name.
05
Troubleshooting
Nothing renamed.
Select the objects in the scene first — Batch Renamer acts on the current selection (and its hierarchy).
My names came out with underscores I did not type.
Names are sanitised to valid Maya identifiers: spaces and other illegal characters are replaced with underscores so Maya accepts them.
A name could not start with a number.
Maya node names cannot begin with a digit. Add a prefix (or a base name) so the result starts with a letter; the tool warns and continues on the rest.
I want to undo a big rename.
Each rename pass is wrapped in a single undo chunk — one Ctrl+Z reverts the whole operation.