nvk_FOLDER_ITEMS

Videos

Basics

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.

• 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 and 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.

Known Issues

• 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

Show changelog

2.15.0

• Compatibility with nvk_SHARED 4.0.0. Make sure to update all your scripts to the latest version.
• Extra keyboard shortcut for deleting a word from the input text treating underscores and hyphens (ctrl-delete still functions as normal)
• Rename: shortcut for toggling capitalization

2.14.1

• Option to store script settings with project in rename script

2.14.0

• New option to specify track names should be excluded from contributing to folder item size calculations. Requires nvk_SHARED 3.6.0

2.13.1

• Improvements to Join script

2.13.0

• IMPORTANT: Removing support for Reaper 6. To use this script, you must upgrade to REAPER 7 or higher. Older versions can be downloaded from the full repository: https://raw.githubusercontent.com/nickvonkaenel/nvk-ReaScripts/main/index.xml
• Store render variant paths separately from render paths (they will still show up in the render path list but normal render paths won't show up in render variant list)
• Disable prefix/suffix for initial name on items that already have a name
• Improve rename script behavior with names that end in numbers without separator characters beforehand
• Ignore join items in 'Name selected folder items from child items' script
• Fix for folder item fade automation not working with fader scaling
• Folder items render no longer overrides user settings for silence trim/padding options

2.12.1

• Moving 'Include automation items in folder items' to 'Experimental' section. When a track is collapsed/hidden and an automation item is larger than the size of the item in it's track, it won't move with the item. There doesn't seem to be a way to fix this, so I'm leaving it in the experimental section for now.
• Partially fix some visual glitches in rename script with certain strings that get processed after input
• Fix regression when rendering sausage items

2.12.0

• New option: Include automation items in folder items
  • Use automation items when calculating the size of folder items
  • Select overlapping automation items when selecting folder items
  • Select overlapping automation items when selecting items
  • Note: automation will not move with items unless you have the "Move envelope points with media items setting enabled"
  • Note: automation items will not move if there are no items on the same track as the automation item
  • Pitch shift will affect automation items within the item or folder items bounds
• Rename "Deselect..." scripts to "Unselect..." to match Reaper terminology
• Ignore overlapping items as well as items contained by folder items when determining render items
• MM Reposition scripts now zoom to the time selection after repositioning
• New script: Shuffle - Shuffles the order of selected columns of items, useful for changing the order of folder items or individual items by shuffling their positions
• New option: Include muted tracks. If enabled, items on muted tracks will be included in folder item calculations. Avoids situations where folder items were accidentally deleted when muting layers for preview. This will be enabled by default for new users.
• New script: Name selected folder items from child items.
• Volume automation items are only trimmed automatically now when volume envelope fades are enabled

2.11.4

• Rename reset button in match mode also resets the input name
• Keyboard shortcut for Rename reset button
• Change Match/Replace button icon to asterisk from magnifying glass

2.11.3

• Error when enabling render variants and trying to render without changing any render variant settings

2.11.2

• Refactoring - support for latest versions of nvk_TAKES and nvk_SUBPROJECT

2.11.1

• Changing default behavior of reposition script when applying settings without closing the script. Now after repositioning, it will unselect all items and keep the current settings.
• To revert to the previous behavior, you can toggle the "Preserve item selection" option in the preferences.
• Better handling of numbers when rendering sausage files

2.11.0

• Adding back legacy script "Add new items to existing folder - Rename" by special request
• Add new items to existing track now groups items on collapsed tracks
• Fixing edge case error with trim scripts
• Rename after folder creation not working properly

2.10.2

• Add option to preserve metadata when rendering
• Fix for render settings not being initialized properly in persistent mode

2.10.1

• Use current render format and bit depth settings when switching to presets made in older versions of Render SMART

2.10.0

• Render Smart:
  • Better warnings when trying to render unnamed folder items
  • Add keyboard shortcut to open rename script from render smart
  • No longer render muted items by default, can be enabled in preferences
  • Tooltips for muted item rendering options

2.9.9

• Only remove last matching appended numbers in sausage file in render script

2.9.8

• Refactoring for less code duplication - update shared library

2.9.7

• Capitalize first no longer capitalizes letters after numbers (i.e. 9mm was being capitalized to 9Mm)
• Disable hyphens in UCS since it breaks the parser (this probably shouldn't be allowed by the spec anyways)

2.9.6

• Refactoring - make sure to update all other scripts to latest
• Removing logic in render item selection that prevented items on muted tracks from being selected since it could prevent items on tracks with certain types of automation from being selected

2.9.5

• Added option to disable numbering for single item in rename script

2.9.4

• Shared library dependency

2.9.3

• Keep tracks with items in order by time now allows for selecting multiple tracks for more specific sorting.

2.9.2

• Bug in fade scripts where folder items weren't changing selection properly
• Fade SMART script added

2.9.1

• Added option to reset name to initial name in rename script (default local shortcut R). Useful when changing item selection without closing and re-opening the script.
• Persistent mode now resets name properly when script is re-opened

2.9.0

• Updated to ReaImgui 0.9.2
• Visual improvements
• Remove script regression - wasn't deleting child tracks of parents like it used to
• With folder item auto-naming disabled and marker variations enabled, sometimes the numbers could be off
• Crash from 0 length items and folder items markers
• Render smart not restoring project settings properly when switching tabs while the script is running

2.8.14

• Render smart crash when closing project tab

2.8.13

• Remove script can now remove FX when hovering over the open FX window
• Added option for proportional fades when using mousewheel pitch shift

2.8.12

• Performance improvements

2.8.11

• Render: handle switching between projects while script is open
• Reposition script accepts comma key for decimal when not focused
• New keyboard shortcut: Ctrl+N to toggle numbering on/off in rename script

2.8.10

• Crash when selecting markers/regions in rename script

2.8.9

• Crash from ReaPack update not removing old files

2.8.8

• Improving performance of render script

2.8.7

• Adding persistent mode to rename script
• Adding persistent mode to render script

2.8.6

• Projects with render settings not set to render with items could cause render item mismatch popup when loading the script
• Crash when renaming from the results table directly in the rename script
• New option to add custom UCS user categories in preferences

2.8.5

• Fixing bug introduced in 2.8.2 where item settings were getting saved before rendering
• Backwards compatibility for SWS 2.14 functions since it's still in beta
• Compatibility with updated nvk_PROPAGATE script
• Possible fix for crash when adding markers with nvk_FOLDER_ITEMS

2.8.4

• Fixing unnecessary undo points when using mousewheel volume script (requires nvk_SHARED v1.1.0)

2.8.3

• Improvements to mousewheel pitch shift behavior. Items on the same track that don't overlap will now use the non-column pitch shift

2.8.2

• Possible fix for script rendering certain sets of items in multiple groups when not necessary
• Stats
• Render SMART: Tail on/off setting not reset properly when closing the script without rendering
• Rename: new option to rename track in addition to items
• Rename: new items options - tracks, markers, regions

2.8.1

• Crash when using normal render script

2.8.0

• Dependencies moved to nvk_SHARED
• Improved render item selection
• New render settings: format and bit depth (can be set per item too)
• Deprecated "Show preferences in main window" option
• Join items were not being removed from render list and rename list
• Crash in rename script when no items or tracks selected

2.7.5

• Folder items crash when tracks deleted in larger projects

2.7.4

• Updating to ReaImGui v9
• Better crash handling

2.7.3

• Non-active but hidden item lanes could create folder items
• Folder items could crash when switching between projects with a large number of items immediately after making a change

2.7.2

• Fixed: rename script allows for naming conventions with multiple numbers at the end of the name i.e. "My Sound_01_01"

2.7.1

• Fixed: crash when using join script with default color track

2.7.0

• New script: Join - Joins selected folder items into a single folder item by creating a new empty item in a new track in the folder.

2.6.1

• Fixed: folder tracks with multiple nested folder tracks could have their depths altered when rendering a sausage item from one of the nested folder track parents
• Script UI is now resizable and settings is a popup window (old settings tab can still be enabled with shortcut for now, but will probably remove later)
• Greatly improved UI performance when using scripts with thousands of items (rename, render)
• Fixed rename track after folder creation not working properly

2.6.0

• Fixed: experimental automatic item grouping not grouping nested folders properly
• Fixed: repositioning scripts and hidden tracks
• New scripts for cut/copy/paste to handle v7 hidden tracks option
• Additional subproject markers settings
• Notes from first item used for sausage files now usable for $itemnotes wildcard and metadata
• Notes can now be added to folder items if 'big names' and 'render settings in notes' are not enabled

2.5.13

• Fixed: console logging during use of reposition script (whoops!)
• Fixed: divide by zero error when percentage is set to 0 in reposition script

2.5.12

• Trial improvements

2.5.11

• Fixed: Sample rate not being set properly when using loopmaker on a project with use project sample rate enabled

2.5.10

• Fixed: new option for repositioning across tracks button (right-click to ignore tracks)

2.5.9

• New wildcard for render directory: $projectrenderdirectory (will use the project render directory instead of custom preset directory, essentially the same behavior as the default tab)

2.5.8

• Fixed: when copying files, if the user selected the option to number different versions, instead of replacing then only the first file would be copied

2.5.7

• Fixed: issue with certain keyboard shortcuts not working after opening preferences

2.5.6

• Theme import not working on Windows

2.5.5

• Shared code fix for duplicate takes bug
• Adding option to import/export themes and global themes for imgui scripts

2.5.4

• Refactoring debugging code

2.5.3

• Fixed: bug with imgui scripts where main action could be run twice

2.5.2

• Fixed: function in folder items caused crash in subprojects

2.5.1

• Fixed: possible crash on load with certain machines

2.5.0

• User-assignable keyboard shortcuts for scripts
• Fixing incorrect positioning with repositioning script when using frames while groups are enabled
• Reposition across tracks setting added to reposition script
• Rename script now removes number from end of name when it's loaded regardless of remove extensions setting
• New shortcut to rename items/track with Ctrl+Enter. The first item track will be renamed to the new name without numbers appended.
• UI improvements and additional options for reposition script
• Fixed reposition presets not working
• Improved behavior when selecting child items with folder items (affects editing scripts and main folder items script)
• Fixed: offline authorization not working properly for v2

2.4.3

• Support for takes settings
• Increasing font size on reposition script
• Fixing crash with certain folder item names

2.4.2

• Improvement: numbering no longer increments on numbers followed by non-separator characters i.e "Loop_120bpm" will not increment but "Loop_01" or "Loop_01_Start" will

2.4.1

• Reposition: added option to reposition using frames

2.4.0

• Settings: Track selection follows item selection -- added as an option since 3rd-party scripts that create unnecessary undo points can cause issues
• Experimental: automatic grouping of items to allow default Reaper actions to be used for collapsing folder tracks. Note: this will disable the ability to manually group/ungroup items.
• Settings: improving naming of settings

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
• Fixed: Trim scripts not working properly with hidden tracks in Reaper 7

2.0.26

• 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