Introduction

The following scripts are meant to quickly rename various kind of REAPER elements.

With this system, with one single line of input, you can add prefix and suffix, but you also have access to a large access of wildcards (values that will be replaced with specific elements values (like the volume for items).

The most advanced feature is the counter system: you can have several sets of counters, linked together. This feature was meant for samples pack naming. More details below.

The items version of this scripts was sponsored by Soundiron. Thanks!

Update (2020-09-20): These scripts have now a Version 2, more flexible, and with new wildcards.

Update (2023-01-05): Letter counters in items version of the script. Also, wildcards list is now up to date (addition of Scale counters etc).

Pack Content

Name	Folder	Links	Date	Version	Changes
X-Raym_Rename selected items with patterns.lua	Items Properties		2023-09-23	1.2.7	1.2.7 (2023-09-23) # Remove SWS dependency for the Notes functions 1.2.6 (2020-11-13) + Preset support + Save last input 1.2.5 (2019-01-03) # popup set to true 1.2.4 (2018-06-23) # Non 120 BPM tempo support fro grid unit # "g" as "grid" alias 1.2.3 (2018-04-09) # Recode $scale wildcard 1.2.2 (2018-04-03) # Debug off 1.2.1 (2018-04-03) # First counter overflow reset the counters 1.2 (2018-04-01) + counter distance repeatitor 1.1.1 (2018-03-27) + $scale wildcard interval and repetitor 1.1.0 (2018-03-23) + $scale wildcard 1.0.9 (2018-03-23) + $region wildcard 1.0.8 (2017-09-22) + $name as an alias of $item + Dash - are now possible in pattern names 1.0.7 (2017-08-23) + $peak, $rms, $lufs, $lu wildcards # prevent bug if item has no take 1.0.6 (2017-08-20) + $notes wildcard 1.0.5 (2017-08-19) + `!_` and `!` deletion, for deleting sep character or creating unnamed counters 1.0.4 (2017-08-18) + $marker wildcard 1.0.3 (2017-08-10) + $bpm wildcard 1.0.2 (2017-08-09) + Single quote for numbers + $bpm wildcards + Input aliases # Bug fix with counter without limits 1.0.1 (2017-08-08) # Fix parent track wildcard 1.0 (2017-08-08) + Initial Release
X-Raym_Rename selected items with patterns_v2.lua	Items Properties		2024-01-24	2.11.3	2.11.3 (2024-01-24) 2.11.1 (2024-01-19) 2.11 (2024-01-17) + $ischild[true-str\|optional-false-str] wildcard https://cloud.extremraym.com/sharex/reaper_Uifs3rKFoP.gif + $sep wildcard for printing the separator input by user + remove trailing sep + remove duplicate sep 2.10 (2024-01-12) + Field for repeat for overlapping item if related actions available + Field above call Script: X-Raym_Keep selected only non-overlapping items or first overlapping items.lua + Field above call Script: X-Raym_Set selected overlapping items active take name from first item in their set.lua + New save input vars core 2.9.1 (2024-01-10) 2.9 (2024-01-10) # Code reorganization 2.8 (2024-01-09) + $counter unlinked counter 2.7.5 (2023-12-30) + $parentdown[i] wildcard 2.7.4 (2023-12-29) + Added region id leading zero in user config area 2.7.3 (2023-12-29) + Added $regionid for current region ID 2.7.1 (2023-09-23) # Remove SWS dependency for the Notes functions 2.7 (2023-01-05) + $letter and $uletter for letter counters (https://i.imgur.com/nKNgGu4.gif) 2.6.1 (2021-12-17) # $takemarker now works with first visible take marker 2.6 (2021-12-10) + $takemarker 2.5 (2021-08-03) + Preliminary notes interval support for $scale jump 2.4.7 (2021-05-20) + fixed $parenttrack 2.4.6 (2021-03-08) + $folder wildcard 2.4.5 (2021-03-04) 2.4.4 (2021-02-24) + $parenttop[i] level 2.4.3 (2021-02-24) + $parenttop wildcard 2.4.2 (2021-01-28) + tracknumber leading zeros based on number of track # Fix $item and $itemnumber replacement, same for $track and $tracknumber 2.4.1 (2021-01-28) + $iregiont wildcard for index within region per track + leading zeros for iregion and iregionst 2.4 (2021-01-27) + $iregion wildcard for index within region 2.3.2 (2020-11-13) + Preset support + Save last input 2.3.1 (2018-06-23) # Non 120 BPM tempo support fro grid unit # "g" as "grid" alias 2.3 (2018-04-29) + Pre-abstraction wildcards + @textitem wildcard 2.2 (2018-04-28) + Track jump value as new counter parameter 2.1.2 (2018-04-16) # non scale counter incrementation fixed when scale counter had a limit 2.1.1 (2018-04-16) # counter restart jump parameter fixed if limit is a time distance 2.1 (2018-04-15) + Multiple scales support + Restart jump added as fifth parameter 2.0.1 (2018-04-13) # $scale counters have now same parameters as any other counter. 2.0 (2018-04-13) + New counter engine. Not backward compatible: limits is not longer a destination value, but a counter (see below). # Limit (restart condition) can be increment count or time distance if time unit if specified + Repeatitor (increment condition) can be increment count or time distance if time unit if specified # $scale counters are unliked from other counters + Incrementation value parameter, for decrementation or incrementation by an absolute value greater than 1. 1.2.3 (2018-04-13) # Recode $scale wildcard
X-Raym_Rename markers in time selection or at edit cursor position with patterns.lua	Markers Regions		2020-11-13	1.2.1	1.2.1 (2020-11-13) + Preset support + Save last input 1.2 (2018-04-17) # Rename marker at edit pos if no time selection
X-Raym_Rename markers in time selection or at edit cursor position with patterns_v2.lua	Markers Regions		2024-01-24	2.5	2.5 (2024-01-24) # Remove core: now run as preset script of the region script + $sep wildcard for printing the separator input by user + remove trailing sep + remove duplicate sep + $counter unlinked counter 2.2 (2021-08-03) + Preliminary notes interval support for $scale jump 2.1.3 (2021-06-30) + Allows passing predefined markers array from anither script 2.1.2 (2021-06-12) + $= for equal sign 2.1.1 (2020-11-13) 2.1 (2020-09-17) + $iregion wildcard + Save last input 2.0.2 (2020-01-13) # Pattern for equal sign 2.0.1 (2018-06-23) # Non 120 BPM tempo support fro grid unit # "g" as "grid" alias 2.0 (2018-05-02) + New counter engine. Not backward compatible: limits is not longer a destination value, but a counter (see below). # Limit (restart condition) can be increment count or time distance if time unit if specified + Repeatitor (increment condition) can be increment count or time distance if time unit if specified # $scale counters + Incrementation value parameter, for decrementation or incrementation by an absolute value greater than 1.
X-Raym_Rename markers selected in region and marker manager with patterns_v2.lua	Markers Regions	Screenshot	2024-01-24	2.5	2.5 (2024-01-24) # Remove core: now run as preset script of the region script + $sep wildcard for printing the separator input by user + remove trailing sep + remove duplicate sep + $counter unlinked counter 2.0.3 (2021-06-12) + $= for equal sign 2.0.2 (2021-06-12)
X-Raym_Rename regions in time selection or current region with patterns.lua	Markers Regions		2020-11-13	1.1.1	1.1.1 (2020-11-13) + Preset support + Save last input 1.1 (2017-11-29) # Region index fix + Possibility to clear region names 1.0 (2017-09-22) + Initial Release
X-Raym_Rename regions in time selection or current region with patterns_v2.lua	Markers Regions		2024-01-24	2.5	2.5 (2024-01-24) # Host core for other related regions and marker scripts # New save input vars core # Code reorganization + $sep wildcard for printing the separator input by user + remove trailing sep + remove duplicate sep + $counter unlinked counter 2.2 (2021-08-02) + Preliminary notes interval support for $scale jump 2.1.3 (2021-06-30) + Allows passing predefined markers array from anither script 2.1.2 (2021-03-08) + $folder wildcard 2.1.1 (2021-03-04) 2.1 (2021-02-27) + parrenttop[i] wildcard suppport 2.0.2 (2020-11-13) 2.0.1 (2018-06-23) # Non 120 BPM tempo support fro grid unit # "g" as "grid" alias 2.0 (2018-04-17) + New counter engine. Not backward compatible: limits is not longer a destination value, but a counter (see below). # Limit (restart condition) can be increment count or time distance if time unit if specified + Repeatitor (increment condition) can be increment count or time distance if time unit if specified # $scale counters are unliked from other counters + Incrementation value parameter, for decrementation or incrementation by an absolute value greater than 1. + Multiple scales support + Restart jump added as fifth parameter # $scale counters have now same parameters as any other counter. 1.3 (2018-04-17) + counter distance repeatitor
X-Raym_Rename regions selected in region and marker manager with patterns_v2.lua	Markers Regions	Screenshot	2024-01-24	2.5	2.5 (2024-01-24) # Remove core: now run as preset script of the region script + $sep wildcard for printing the separator input by user + remove trailing sep + remove duplicate sep + $counter unlinked counter 2.0.2 (2020-11-13) 2.0.1 (2020-11-12)
X-Raym_Rename selected tracks with patterns.lua	Tracks		2020-11-13	1.0.1	1.0.1 (2020-11-13) + Preset support + Save last input 1.0 (2017-09-22) + Initial Release
X-Raym_Rename selected tracks with patterns_v2.lua	Tracks	Screenshot	2024-01-25	2.1.1	2.1.1 (2024-01-25) # Fix counter not being restart when launched from external files 2.1 (2024-01-24) + $sep wildcard for printing the separator input by user + remove trailing sep + remove duplicate sep + New save input vars core + $counter unlinked counter # Code reorganization 2.0.4 (2023-04-03) 2.0.3 (2023-04-02) 2.0.2 (2023-04-02) + $folder, $parenttrack and $parenttop[i] wildcard support 2.0.1 (2022-05-25) 2.0 (2022-05-24) # v2 core + $scale counter

Screenshots

Items versions

Items version is very useful for virtual instrument designers. It works on selected items active take.

Regions version

Region/Marker Manager Version (2020-11-12)

This version works on regions selected in region and marker manager.

Markers version

Tracks version

Usage

The scripts works by detecting patterns separated by a separator characters chosen right in the user input window (usually, _). Words followed by =*number* like word=1 create a counter. When the ending number is reached during the count, it will cause the previous counter on the left to increment by 1.

Here are some common cases. Only symbols and wildcards have to match.

Prefix

prefix_$name

Suffix

$name_suffix

Simple Counter

count=1

Offset Counter

count=5

Reverse Counter

count=5-1

Multiple Counters

velocity=1_robin=1

Leading Zeros Counters

count=001

Unnamed Counters

!=1

Wildcards

Common

The following wildcards are common to all scripts in this pack:

$name = insert the current element name.
$number = insert the sequential number from selection order
$project = the name of the project file, without the .rpp extension.
$bpm = the rounded bpm of the project
$blank = extra blank line if needed
!_ and ! = these are deleted. it can be used for deleting sep characters or creating unnamed counters

Items

The item version has specific wildcards:

$itemnumber = insert the sequential number of the item on its track
$track = insert the track name that the item is on
$tracknumber = insert the track number that the item is on, starting from 1 (the top track)
$parenttrack = the name of the parent track that the item’s track is foldered under.
$parenttop[i] = same as parent track with levels from current track. [i] is optional.
$parentdown[i] = same as parent track with levels from top parent of current track. [i] is optional.
$scale = iterate scale notes from note name. Chromatic. Format: A1, A#-1… Case sensitive from user input.
$marker = comma separated list of markers names for markers inside the item edges
$region = last region from item pos if item pos is inside it (aka, current region from item position)
$regionid = current region ID
$notes = item notes
@itemnote = first empty item notes.
$iregion = rename with marker id number within the current region
$iregiont = rename with marker id number within the current region per track
$folder = list of the track names parenting of the item
$takemarker = first take marker
$letter = lowercase letter counter (Screenshot)
$uletter = uppercase letter counter

Tracks

$parenttrack = the name of the parent track that the item’s track is foldered under.
$parenttop[i] = same as parent track but trop level. [i] is optional.
$folder = list of the track names parenting of the item
$tracknumber = track id

Items order

There is several ways to determine items order for your counters:

time = uses absolute timeline position across all tracks. If two items start at the same time, the item on the higher track (lower track number) comes first.
track = counts all items on a single track, then restarts all counters when it moves to items on the next track
wrap = counts all items on a single track from left to right, then continues the count where it left off at the beginning of the next track

New Pattern Format (2020-09-20)

I just released version 2 of this scripts as new actions. They have similar names but “_v2” as suffix.

+ New counter engine. Not backward compatible: limits is not longer a destination value, but a counter (see below).
# Limit (restart condition) can be increment count or time distance if time unit if specified
+ Repeatitor (increment condition) can be increment count or time distance if time unit if specified
+ Incrementation value parameter, for decrementation or incrementation by an absolute value greater than 1.
+ Restart jump added as fifth parameter

There is also new wildcard

iregion for index in region (markers version only currently)
$scale for musical notes like G# etc
@itemnote (item version) first empty item notes. @ are pre-abstraction wildcards (it replaces a part of your input).

Exemples

You can find examples on this Gist page.

Feature Requests

Miss a wildcard? Let me know!

Modding

You can mod these scripts to save custom inputs, deactivate popup or change advanced settings, without altering the main script, by using a Preset script.

Installation

This pack can be installed and auto-updated with the free ReaPack REAPER extension with a custom link related to your licence, or via regular Zip download. After purchase, detailed installation instructions will be provided here and on the dedicated Purchase Confirmation page. License are valid lifetime. You will be able to enjoy updates and new scripts added to the pack.

Notes

By purchasing this product, you are supporting my free scripting. Thanks!

Thanks to Nofish for having set SWS Loudness functions available from ReaScripts!

ExtremRaym

Raymond Radet's website

ReaScripts: Advanced Renamers (Items-Takes, Tracks, Markers, Regions)