nvk_WORKFLOW 2

User Guide


nvk_WORKFLOW

Introduction


First of all, thank you so much for your support. You are awesome! I hope you enjoy this product and make some amazing sounds with it :)

With your purchase of a license, you are entitled to free updates + exceptional support from me directly. This user guide should help with the most common issues, so please look for help here before emailing me.

Your license key will activate up to 3 computers (more activations can be provided at my discretion). Your license key is for your own personal use and may be used for commercial or non-commercial work. If you share your license key with anyone else, it will be revoked and you will not get a refund.

For a site license, just purchase as many copies as you need and activations will be added to the same license key.

Requirements

  • REAPER
  • ReaPack
  • ReaImgui (install via ReaPack)
  • js_ReaScript API (install via ReaPack)
  • SWS/S&M Extension
  • Installation

    Trial

    All scripts come with a free 14-day trial. In order to start the trial, follow the instructions below to install the script and leave the license key field blank when prompted.

    ReaPack

    In order to install this script you will need to first install ReaPack. It's an amazing way for people to easily share REAPER scripts with other users and will allow for this script and all other scripts to be easily updated from within REAPER. For more info on how to use ReaPack go here.

    ReaPack Repository: https://nvk.tools/index.xml

    1. With ReaPack installed, select Extensions-ReaPack-Import repositories and paste the ReaPack Repository url above.
    2. Locate the scripts to install by selecting Extensions-ReaPack-Browse packages and searching 'nvk'. Then you can select the scripts "nvk_FOLDER_ITEMS", "nvk_TAKES", and "nvk_SUBPROJECT" and install them with Actions-Install and then Apply If you haven't already, you should also install "js_ReaScript API" which can be found in ReaPack as well.
    3. After you finish downloading the scripts, you can find them in your actions list by searching 'nvk'

    Note: If you would like to automatically stay up to date with this and other ReaPack Repositories, you can select Extensions-ReaPack-Manage repositories and then Options-Install new packages when synchronizing. Then, when you select Extensions-ReaPack->Synchronize packages it will automatically install all new scripts.

    ReaImgui

    Install ReaImgui from the ReaTeam Extensions Repository. This repository is included with ReaPack by default so you should have it already. The instructions are the same as installing the main script, just make sure you have the repository enabled, search for 'ReaImgui' in ReaPack and install it.

    js_ReaScript API

    Install js_ReaScript API from the ReaTeam Extensions Repository. This repository is included with ReaPack by default so you should have it already. The instructions are the same as installing the main script, just make sure you have the repository enabled, search for 'js_ReaScript API' in ReaPack and install it.

    SWS/S&M Extension

    Download SWS/S&M Extension and follow the instructions to install

    Activating the License Key

    Once you have the script installed, load your actions list and search "nvk" to locate the script. Double-click it or assign it to a hotkey and run the script. You will be prompted to input your license key, which you should have recieved immediately after purchasing the script.

    This script is only guaranteed to work on the latest version of REAPER and SWS/S&M 64-bit. 32-bit is not supported. Make sure you are up to date before contacting support.

    Basics

    About

    nvk_WORKFLOW is a collection of scripts for REAPER designed for extremely fast game audio workflows. It comes with three different sets of scripts that all work together

    nvk_FOLDER_ITEMS: Organize your projects with folder items: blank items which represent groups of items in a folder. These scripts allow for quick manipulation, renaming, and rendering of your assets with very little work on your end.

    nvk_TAKES: Embed take markers in your assets that have more than one variation, allowing you to quickly shuffle through variations.

    nvk_SUBPROJECT: A true swiss-army knife of a script. Create subprojects from either selected items or tracks, automatically trim and rename the variations, and re-render them from your main project with automatically generated start and end markers. Makes subprojects incredibly easy to incorporate in your projects by doing all the manual work for you.

    Folder Items

    nvk_FOLDER_ITEMS

    To get started with folder items, run the script nvk_FOLDER_ITEMS. This script will automatically create folder items that match the length of items inside any folder in your project. You can then use the other scripts to manipulate these folder items. It's recommended to add this script as a startup action so that it runs every time you open Reaper. You could also add it to your toolbar or assign it to a hotkey so you can toggle it on and off.

    nvk_FOLDER_ITEMS - Settings

    This script allows you to customize the behavior of the other scripts in the FOLDER_ITEMS collection. If you create a new preset, the current preset will be saved with the project, so you can have different settings for different types of projects and they will be loaded automatically when you open the project.

    Which script should I use to create Folder Items?

    While nvk_FOLDER_ITEMS is the recommended way to create folder items, there are a couple of other options that might work for your specific workflow. Let's go over them:

    nvk_FOLDER_ITEMS: This script updates the folder items of the entire project each time you make a change. It creates markers and regions if you have those enabled. It also does things like automatically selecting children items when you select a folder item and in the future automatically selected tracks when you select items (just added this). It uses the settings in "nvk_FOLDER_ITEMS - Settings" to determine what to do. It's the most advanced of the 3 scripts the recommended one to use.

    nvk_FOLDER_ITEMS - Update (Manual): This script is the same as the above script except it doesn't automatically update the folder items. You have to run it manually. Recommended for use on extremely large projects where you might have performance issues with the automatic updating. It also doesn't have the automatic selection features but if you still want those you can have nvk_FOLDER_ITEMS running uncheck the Folder Items -> Enable checkbox in the settings.

    nvk_FOLDER_ITEMS - Add new items to existing folder: This is the most minimal script. It only adds new items to the folder track you have selected or the parent track of the items you have selected. If you have a time selection and no items selected it will only create folder items in the parent track that are within the time selection. If you use this, it can work well as either a hotkey or a track double-click mouse modifier. It doesn't create markers and isn't aware of item numbers outside of the current selection. Recommended if you want full control over where your folder items are created and want to keep your project as tidy as possible.

    Takes

    nvk_TAKES

    With version 2 of nvk_WORKFLOW, nvk_TAKES is now a script which runs in the background similar to nvk_FOLDER_ITEMS. It's recommended to add this script as a startup action so that it runs every time you open Reaper. You could also add it to your toolbar or assign it to a hotkey so you can toggle it on and off. While the script is running, take markers will be automatically added to the first selected item in your project. This means that when you import items into your project, you can immediately start using the take markers without having to run the script again. You can then use these take markers to quickly cycle through variations of your assets.

    Essential scripts

    nvk_TAKES: as mentioned above, this script runs in the background and automatically adds take markers to the first selected item in your project.

    nvk_TAKES - Select previous/next take SMART: this script will either move the item contents to the previous/next take marker or if there are no take markers, it will go to the next take. If there are no more takes, then it will go to the start of the first take or the end of the last take depending on which direction you are going. This is the recommended way to shuffle through takes.

    nvk_TAKES - Duplicate items and select next take SMART: this script does exactly what it says, it's great for quickly making variations of a sound.

    nvk_TAKES - Reverse: this is an improved version of the built-in reverse action that works better with the take markers workflow. It preserves the take marker positions and also works with multiple items selected. It's recommended to use this instead of the built-in reverse action.

    Subproject

    nvk_SUBPROJECT

    To use nvk_SUBPROJECT, select the items or tracks you want to create subprojects from and run the script. It will create a subproject for each item or track and automatically trim and rename the variations. While inside the subproject, you can run the script with no items selected and it will automatically fix the start and end markers. If you have your subproject selected from the main project, it will re-render the subproject and automatically split your items for you.

    nvk_SUBPROJECT - Settings

    Hopefully coming soon, this will allow you to customize the behavior of the script. For now, you can edit the script directly to change the settings.

    Known Issues

  • New hidden tracks setting in Reaper 7 can cause issues with certain scripts (if you find any report them)
  • With hidden tracks setting, grouping must be enabled with the setting selecting one item in the group selects them all or else folder items will not move items in hidden tracks.
  • Collapsing tracks with the default Reaper buttons/actions will not group collapsed items with their folder items unless you use the experimental automatic grouping feature
  • Big names setting doesn't make folder items name very big on retina displays
  • Changelog

    Note: these are mostly included here as an archive and there are almost certainly more recent changes. The most recent changelog is included in the script and can be read when updating.

    Folder Items

    • 2.3.2
      • - Fixed: number restart 'Always' setting not working properly
      • + Changing name of 'Render directory' to 'Project renders folder name' for clarity
      • + Adding setting to copy items above or below the video track (any track named video)
      • - Fixed: crash when invalid name for 'Project renders folder name' setting
    • 2.3.1
      • - Fixed: script blocked from rendering when items selected without a file name
      • - Fixed: copy directories could use incorrect project path when using relative paths and multiple project tabs
      • - Fixed: copy directories crash when using relative paths with unsaved project
    • 2.3.0
      • + Settings: New and improved options for editing scripts
      • + Config options in mousewheel pitch shift now editable in settings
      • + Overshoot fade envelopes now disabled by default and can be enabled in settings
      • + Renamed option for creating volume envelopes on folder items with fades to 'Volume envelope'
      • + Option for how folder item fades affect children (child latch)
      • + Minimum fade length setting can now be set to smaller amounts (and also properly affects fade lengths now)
    • 2.2.3
      • - Fixed: pitch scripts not as responsive as they should be
      • - Fixed: numbering issues with certain name formats
      • - Fixed: renaming after creation of folder items selecting all items
      • - Fixed: add new items to existing folder script broken due to function name change
      • - Fixed: selecting UCS category with arrow keys returned incorrect category in rename script
    • 2.2.2
      • + Improvement: Mousewheel pitch shift now only creates single undo point
      • + Rename: manually adding underscore/hyphen at the end of the name will now not get replaced
      • + Rename: separator option added to specify what character to use for separating name and number
      • + Reposition: change time with mousewheel over input box
      • + Settings: new options for overshoot volume envelopes on fades
      • - Fixed: crash when using clean up renders option with track in renders folder selected
    • 2.2.1
      • - Fixed: Deselect non-folder items still not working properly with nvk_FOLDER_ITEMS.lua when used with a hotkey and a single folder item selected
    • 2.2.0
      • + Numpad Enter now works as enter key for scripts with UI
      • - Fixed: Remove script not working with hidden tracks
      • + Can specify paths relative to the project location in copy directories
      • - Fixed: Deselect non-folder items not working properly with nvk_FOLDER_ITEMS.lua when used with a hotkey
      • + Replacing top-level folder items only settings with drop down
      • + New hotkeys for repositioning script
      • - Fixed: the first time you tab in the reposition script it correctly focuses the time input
      • - Fixed: bugs with repositioning script when using hotkeys while changing preset name
    • 2.1.2
      • - Fixed: Renaming reposition presets bug
    • 2.1.1
      • - Fixed: Crash when opening repositioning script the first time with items selected
    • 2.1.0
      • + Reposition presets: create repositioning presets with the Reposition script and assign them to hotkeys with the preset scripts!
    • 2.0.29
      • - Fixed: Incorrect display of leading zeros when switching tabs in folder items settings
    • 2.0.28
      • - Fixed: Trim scripts not working properly on takes with playrate changes
    • 2.0.27
      • + Improved: better handling of multiple numbers in item names
      • + Add new items to existing folder script now compatible with v2 user settings
      • - Fixed: Mouse modifier to toggle track visibility not grouping items properly with new "hidden" track setting
    • 2.0.26
      • - Fixed: Trim scripts not working properly with hidden tracks in Reaper 7
    • 2.0.25
      • - Fixed: item colors not changing region colors properly in certain situations
      • - Fixed: crash when adding new items to a folder track with certain region color settings
      • - Fixed: grouping items not working properly with the new "hidden" track setting in Reaper 7
      • - Fixed: unable to select regions in region render matrix with certain region color settings
      • + Added: Add new items to existing folder no longer removed
    • 2.0.5 Fixing more bugs and improving features
    • 2.0.4 Removing icons so they can be separately synced with nvk_ICONS from ReaPack.
    • 2.0.3 Rename script style improvements
    • 2.0.2 Fix for error when opening rename script with no tracks or items selected
    • 2.0.1 Updating renaming script with a bunch of new features
    • 2.0.0 Render SMART release. Re-doing settings and allowing for per-project settings.
    • 1.9.1 Add custom nvk icons by Øivind Rosvold. Get more colors and other great icons from https://audioikons.com/
    • 1.9.0 New version of Render SMART (v2 beta), new rename advanced and reposition scripts (also in beta)
    • 1.8.6 New version of Render SMART beta
    • 1.8.5 Beta of Render SMART v2 (make sure you have ReaImgui and Reaper 6.64 to test), removing experimental render script
    • 1.8.4 All Caps setting for rename, minor improvements, new experimental render script for testing
    • 1.8.3 Minor fixes, rename settings now stored with project, item colors enabled for markers now properly display for variations
    • 1.8.2 Better fix for buffer error, new scripts: Shuffle pitch shift selected items SMART, Random pitch shift selected items +- 2 semitones
    • 1.8.1 Fix for error after leaving render smart script open for a while
    • 1.8.0 Render Smart improvements:
      • -New option to copy rendered files to additional folders after rendering
      • -Can select different render folder or file name pattern
      • -Advanced options to rename copied files with lua string patterns
      • -Render as Source - renders into user set source folder and can copy above track for immediate use
      • -Fix for items without takes (thanks Luca!)
      • -Fix for incompatibility with MB_Superglue regions and nvk_FOLDER_ITEMS
    • 1.7.1 Quick fix for issue with folder items and duplicating folder items with drag action
    • 1.7.0 New Mousewheel volume script, licensing improvements, trial
    • 1.6.2 Improving responsiveness of folder items, fixing bug with fade automation due to different envelope volume scaling settings
    • 1.6.1 Licensing improvements
    • 1.6.0 Folder Items optimization pass. Settings load instantly, item numbering persists throughout track. Everything is more responsive and uses less cpu. No cpu use during playback or record.
    • Fix for rename items text getting cut off on high resolution displays
    • Pitch shift scripts no longer create undo points if nothing has changed
    • 1.5.1 Fixing error if folder created on last track of project
    • 1.5.0 When rendering sausage items sith $track, names weren't being properly applied
    • 1.4.9 Don't update folder items during playback or recording
    • 1.4.8 Fixing bug with reposition groups script and snap offsets
    • 1.4.7 New organization scripts
    • 1.4.6 Licensing improvements
    • 1.4.5 Double click on pooled midi items now opens midi editor
    • 1.4.4 Licensing improvements
    • 1.4.3 Better handling of automatic folder item creation naming with different name schemes. Minor fixes to rename script.
    • 1.4.2 Fix cursor issue in folder items textboxes. Fixing occasional bug with fade in/out scripts and auto-crossfaded items
    • 1.4.1 Minor fixes, Delete key now works in rename items
    • 1.4.0 New setting to add markers for variations, better error handling, fixing issue for user that have updated without opening the settings script, appended number setting not working properly when rendering sausage items, fixing markers and regions updating every loop (performance improved)
    • 1.3.1 Adding back OG Add new items to existing folder - Rename script. Minor fixes
    • 1.3.0 New Render SMART UI and options, moving render settings that were previously in settings script to tab in render script.
    • Fixing bug when adding or deleting folder items with markers enabled
    • Toggling track visibility works better with muted groups or collapsed tracks
    • 1.2.0 Rename script now works with text (empty) items
    • Fixing issue with grouping nested collapsed folders with doubleclick mouse modifiers
    • New setting 'Folder Items - Disable': if you don't want to automatically create and fix folder items but still want to automatically select them (also disables markers)
    • New setting 'Markers - Regions': Automatically create regions for sets of folder items instead of markers
    • New setting 'Markers - Subproject markers: Create markers for subprojects'
    • Validate input with reposition groups
    • Render SMART now allows you to render into your project folder and still copy the media source to the Renders folder
    • All render settings saved with items now, no longer written in item notes, setting name changed
    • Fixing crash when opening subprojects with regions
    • 1.1.0 Select folder items after creating new folder, Rename script takes into account 'name in notes' setting, allow for non-numbered folder item names, better handling of non-named folder items
    • 1.0.1 Fixing bug which caused snap offsets to be removed by some scripts, adding reverse direction mousewheel scripts

    Takes

    • 2.2.0
      • - Fixed: only add take markers to audio items
    • 2.1.0
      • - Fixed: Duplicate items and select next take crash with hidden tracks
    • 2.0.2 nvk_TAKES.lua now automatically adds take markers to the first selected item as a constantly running script.
    • 2.0.1 Minor bug fixes
    • 2.0.0 Compatibility with nvk_WORKFLOW 2.0
    • 1.2.5 Depreciating remove channels script, Reaper update broke it somehow and now that they have the channel mapper it doesn't seem as necessary
    • 1.2.4 Minor fixes and script variations
    • 1.2.3 Add take markers to all variations in selected items takes
    • 1.2.2 Select random take SMART, licensing improvements
    • 1.2.1 Licensing improvements
    • 1.2.0 Compatibility with nvk_CREATE
    • 1.1.1 Duplicate items and select next take now adds more space
    • 1.1.0 Improvements to take marker next/previous scripts with snap offsets
    • 1.0.8 New named take marker script
    • 1.0.7 More licensing improvements
    • 1.0.6 Better handling of empty takes
    • 1.0.5 Licensing improvements
    • 1.0.4 Minor fixes
    • 1.0.3 Renaming toggle width fx, adding script to automatically save last touched parameter as fx to use width width fx script so you don't have to set it manually and your settings won't be overriden with updates.
    • 1.0.2 Fixing spelling of toggle width fx; now it clears track width envelope instead of toggling
    • 1.0.1 Fix for empty items when selecting takes

    Subproject

    • 2.1.0
      • - Fixed: crash when rendering project with folder items from the main project
    • 2.0 Compatibility with nvk_WORKFLOW 2.0
    • 1.1 Ability to add multiple fx to master track
    • 1.0.9 The licensing improvements saga continues
    • 1.0.8 Even more licensing improvements!
    • 1.0.7 More licensing improvements
    • 1.0.6 Licensing improvements
    • 1.0.5 Minor fixes
    • 1.0.4 Fixing issue with loading markers setting
    • 1.0.3 Fix compatibility issues with new folder items settings, licensing improvements
    • 1.0.2 Minor fixes
    • 1.0.1 No longer uses files on VIDEO track or muted track for calculating start and end markers