Batch Rename – Catapult Pro Video

The Batch Rename functionality allows users to easily rename multiple tag template buttons, based on predefined presets.

Batch Rename Walkthrough

Useful Tip: To switch the audio track in the video player, click the Settings icon,

select Audio, and choose your preferred language.

Template CSV Structure

Batch Rename functionality uses presets stored in a template CSV file (BatchRename.csv), which can be edited, or imported using a file created from scratch.

The template CSV file is located as follows:

On MacOS

~/Library/Preferences/SBG/TagTemplates/BatchRename.csv

On Windows

C:\ProgramData\SBG\TagTemplates

The BatchRename.csv file follows a simple structure:

The Unique ID column contains the Unique IDs of tag template tags or labels.

The Unique ID can be set in the Behaviour Properties panel for each tag or label button, and can be any alphanumeric value (i.e. numbers, letters, or a combination).

Each subsequent column in the CSV file contains the assigned Preset name in the header, and the desired tag and label names for that preset.

If any of the Unique ID cells are empty, the corresponding row is omitted when Batch Renaming.
If any of the name cells are empty, the corresponding button is renamed to an empty string when using the corresponding preset.

How to Edit Rename CSV

To edit the CSV file, navigate to the menu located in the top-left corner of your tag template designer.

Select Edit Rename CSV. This action will open the BatchRename.csv file in your system’s default CSV reader.

Focus - Batch Rename Edit rename.png

Next, make any desired changes to the presets and save the file. If done correctly, you should be able to Batch Rename based on your presets. There is no need to restart the software - Focus will recognise the changes the next time Batch Rename is clicked.

Important: For most CSV readers the process will be completely seamless, however, it is critical to ensure that the file is saved in the correct directory with the correct extension.

For example, Numbers on MacOS by default saves files in the .numbers extension instead of .csv.

To save a CSV file in Numbers, make sure you select File > Export > CSV from the context menu and replace the BatchRename.csv file stored in the location provided at the top of this guide.

How to Import Rename CSV

This option allows users to import a file stored anywhere on their device and override the BatchRename.csv file where the presets are stored. Whether this option, or Edit Rename CSV is used, is a matter of personal preference.

To use this functionality, first create a CSV file containing your presets, and save it anywhere on your device. Make sure that you strictly follow the CSV structure outlined in the Template CSV Structure section above.

When the file is ready, select Import Rename CSV from the menu in Focus, then navigate to the file and select Open.

If done correctly, you will see a UI message confirming the successful import. You should now be able to Batch Rename based on your presets. There is no need to restart the software - Focus will recognise the changes the next time Batch Rename is clicked.

How to Batch Rename Tag and Label Buttons

Navigate to the Tag Templates window, and choose the Tag Template Designer.

Ensure that the Unique IDs of the tag and label buttons match those in your template CSV file.

Focus - Batch Rename prior to rename.png

Select the Batch Rename from the dropdown menu at the top-left, then confirm the preset that you wish to use to batch rename the buttons.

Focus - Batch Rename confirming preset.png

The tag and label buttons will now show the new names, based on the preset you chose from the batch rename file.