Rename-Names Ease Add-on Documentation

Rename-Names Ease is a powerful batch renaming tool for Blender created by Tri-vima Studio. This add-on streamlines the renaming process for Blender users, allowing for quick, consistent, and organized naming of objects in your scene. Here’s a detailed guide on how to use each feature of this add-on.

Installation

1. Download the Rename-Names Ease add-on `.zip` file.
2. Open Blender, go to Edit > Preferences.
3. In the Preferences window, click on Add-ons and then Install….
4. Select the downloaded `.zip` file and click Install Add-on.
5. Enable the add-on by checking the box next to Rename-Names Ease.

Accessing the Add-on

Once installed, go to the 3D View - Properties Panel (N) and look for the Rename-Names Ease tab. You’ll find all the options and controls here for renaming objects in your scene.

Features and Options

1. Batch Rename Settings

New Name
- Purpose: Define a new name template for selected objects.
- Usage: Enter a name in this field. This name will be used as the basis for renaming, with additional options applied to it (e.g., numbering, prefix, suffix).

Find Text and Replace Text
- Purpose: Search and replace specific text in object names.
- Usage: Enter text in Find Text to locate matching text in object names, and Replace Text for what you want to substitute it with. If the text is found, it will be replaced according to the Case Sensitivity setting.

Case Sensitivity
- Purpose: Toggle case-sensitive searches when using Find & Replace.
- Usage: Enable or disable case-sensitive matching for Find & Replace. When enabled, exact case matching is required.

Change Case
- Purpose: Adjust the case style of object names.
- Options:
- Original: Keep the current case.
- Uppercase: Change to UPPERCASE.
- Lowercase: Change to lowercase.
- Title Case: Capitalize the first letter of each word.

2. Additional Options

Prefix, Separator, and Suffix
- Purpose: Add specific text to the start (Prefix) and end (Suffix) of object names, with a customizable Separator between parts.
- Usage: Enter text for Prefix and Suffix, and choose a Separator (default is `_`). The final name structure will follow this format: `Prefix_Separator_Name_Separator_Suffix`.

Add Punctuation and Punctuation
- Purpose: Add punctuation at the end of each object name.
- Usage: Enable Add Punctuation and enter a punctuation mark (e.g., `.` or `-`). This will be appended to each name after other options are applied.

3. Incremental Numbering Options

Add Numbering
- Purpose: Enable automatic numbering for renamed objects.
- Usage: Toggle this option to add incremental numbering to the object names.

Digits
- Purpose: Control the number of digits used for numbering.
- Usage: Enter a digit count (e.g., `3` for `001`). This sets a fixed number of digits for consistent alignment in names.

Start Number
- Purpose: Set the starting number for the numbering sequence.
- Usage: Choose the first number to begin the sequence with.

Step Size
- Purpose: Set the increment between numbers.
- Usage: Choose a value (default `1`) to control the count interval. E.g., with Step Size `2`, numbering goes `1, 3, 5…`.

How to Use the Add-on

1. Select Objects: In your scene, select the objects you wish to rename.
2. Open Rename-Names Ease: In the 3D View properties panel, go to the Rename-Names Ease tab.
3. Enter Settings:
- Define the New Name if starting from a fresh name.
- Adjust Find & Replace settings if modifying existing names.
- Choose case preferences, add prefixes or suffixes, punctuation, or enable incremental numbering.
4. Apply Renaming: Click the Apply Batch Rename button to execute the renaming operation.

Example Usage

- Scenario: You have selected five objects and want to rename them to "Tree_001" through "Tree_005", while making the name uppercase.
- Steps:
1. Set New Name to `Tree`.
2. Select Change Case to `UPPERCASE`.
3. Set Prefix to `Tree` and enable Add Numbering.
4. Set Digits to `3`, Start Number to `1`, and Step Size to `1`.
5. Click Apply Batch Rename.

- Result: Objects are renamed to `TREE_001`, `TREE_002`, … `TREE_005`.

Benefits

- Quick Workflow: Batch rename large numbers of objects in seconds.
- Organized Naming: Creates consistent, logical naming conventions across projects.
- Flexibility: Adaptable to different workflows with a range of customizable options.

For support or updates, check out Tri-vima Studio on social media or contact us directly. Happy renaming! 🎉