GUtilitiesPlus
A quick guide to using my GUtilitiesPlus scripts for Cockos Reaper
Intro
GUtilitiesPlus is a collection of plugins to assist editing in Reaper. It was initially a C++ only extension, but I refactored it to provide a reusable API, implemented the rest of the business-logic in Lua, and open sourced the whole lot. This is what the ‘Plus’ is referring to.
Feel free to poke about the code if you’re inclined to use it for more than just audio editing.
Original forum post https://forum.cockos.com/showthread.php?t=287724
Main ReaPack/scripts repo https://github.com/gu-on/GUtilitiesPlus
C++ extension backend https://github.com/gu-on/GUtilitiesAPI
Installation
Installing and updating GUtilitesPlus is best handled via ReaPack. If you don’t already have this, check out the user guide for installation instructions.
Once ReaPack is installed - in the title bar, navigate to Extensions -> ReaPack -> Import repositories and paste in the following url:
1
https://github.com/gu-on/gutilitiesplus/raw/master/index.xml
To install everything, you can use ReaPack’s ‘Install new packages when synchronizing’ option and run ‘Synchronize packages’ (refer to the user guide). If you only intend to choose some of my scripts, be sure to install ‘GUtilitesAPI’ and ‘GUtilities libraries (essential)’. These are the basis of all of my scripts.
Scripts
GU_Batch importer
Recursively imports all media from within a specified folder. It also creates a Track structure that mimics the folder depth of the files imported, meaning imported files can be re-exported with the same folder structure.
You can use the $folders and $track wildcards in the Render to File dialog to render out the folder structure. Folders that don’t exist will be created automatically.
GU_Item alias generator
Creates empty Items in the top-most parent Track for selected Items, based on whether the Items are overlapping in time.
These blank Items can be used like 2D Regions for rendering purposes.
GU_Item fader
Fades selected Items as a percentage of their length.
GU_Item renamer
Batch renames selected Items’ active Takes, roughly following the supported wildcard in Reaper’s own Render to File dialog.
As a quality-of-life feature, wildcards which support round brackets can be scrolled through in the dropdown to view the various options specific to the project. This can be especially helpful in large projects that make liberal use of the special $region() wildcard.
Further, wildcards which support incremental numbers, such as $itemnumber, can use square brackets to create leading zeros. So “$itenumber[025]” will start from 025, and count up for each item. In this example, numbers bigger than 3 digits will print regularly, e.g. 999, 1000, 1001…
GU_Set item length (before/after snap offset)
Sets selected Items’ lengths before or after their snap offsets.
Useful for when you want consistent attack times across Items, snapping neatly to the grid - while also allowing a customisable “pre-entry” for audio which swells or builds.
GU_Source validator
A powerhouse tool for viewing info about your Source Audio at a glance. A non-GUI version of the script is also provided to allow direct export to .csv for use in a separate spreadsheet software.
GU_Source validator only inspects Source Audio as it appears on disk. It doesn’t take FX or mix adjustments into account. It’s intended to be used as the last step in the chain for QA purposes.
If you’re working on a project with a strict style guide, you can pull up the Set Validation Settings menu to colour/highlight any divergence in the main view. Most of this is self-explanatory, allowing you to inspect properties such as the number of channels, sample rate, loudness, etc.
Silence Intro/Outro indicates if there is lengthy silence taking up valuable space, and Zero Start/End shows whether your Source starts and ends on a zero-crossing to ensure discontinuity-free playback.
The settings for these can be adjusted in the Settings → Detection menu. Discontinuities may be so small as to be completely inaudible, so this can be used to dial in a more sensible threshold.
The Regions column indicates whether a Source file has embedded loop markers. Handy for ensuring your loops have been exported correctly.
Finally, Is Mono assists in quickly checking if a file is effectively monophonic. Any single-channel file will of course be monophonic, but it’s easy to accidentally export something as a multichannel file with identical channels.