nvk_SEARCH 2 User Guide
Basics
About
nvk_SEARCH finds almost anything in Reaper from one window: FX, chains, actions, projects, project templates, subprojects, takes, take markers, tracks, track templates, regions, markers, and folder items. You don't have to go to the Actions List, FX Browser, or Project Bay, and it adds a few things those windows don't have, like plug-in screenshots and tags that work on any type of result.
Requirements
- Reaper 7.18 or later
- The nvk.tools installer, which adds nvk_SEARCH with everything it needs. With ReaPack, install nvk_SHARED and nvk_API alongside it (install guide)
- Without nvk_API, Visual FX is unavailable, and fuzzy matching and the New filter lose the search engine they depend on
Search
Type in the search box and the results update in real time. Press Esc to clear the current search.
| Search for | Type | Finds |
|---|---|---|
| Any of several terms | horse,pig,cow | Results containing any of those terms |
| Excluding a term | horse -pig | Results for "horse" but not "pig" |
| An exact phrase | "horse pig" | Results containing that exact phrase |
Fuzzy matching finds close spellings and abbreviated names, and synonyms mean delete also matches "clear", "remove", and "erase". Both can be turned off under Preferences > General.
Use the sort button to order results by Relevance, Result order, Name, or Date. With Relevance, results you use often rank a little higher, and a blank search shows a Suggested section. Turn off Boost previously used results in Preferences to remove your history from the ranking.
Adding results
Enter or double-click activates the selected result. Shift+Enter activates it without closing the window. Select several results with Shift+Up or Shift+Down to add them together.
Click the heart on a result to make it a favorite. Right-click a result for everything else you can do with it.
Result views
SEARCH has compact and detailed result views, plus Visual FX. Switch between them with the buttons in the toolbar.
Double-click empty space in the header to collapse SEARCH to just its header. Double-click again, type, or launch SEARCH again to expand it.
Command palette
Press Ctrl+Shift+P for a smaller, floating version of SEARCH. Drag either side edge to resize it. The palette's menu has its own Palette style (Floating field, One panel, Hacker, Blueprint, and Nixie) and Palette tone (Midnight, Dark, Light, and Calm).
Filters
| Key | Filter |
|---|---|
a | action |
u | au |
c | chain |
l | clap |
d | folder item |
f | fx |
i | inst |
j | jsfx |
2 | lv2 |
m | marker |
o | other |
p | project |
n | project template |
r | region |
s | subproject |
k | take |
w | take marker |
t | track |
e | track template |
v | vst |
3 | vst3 |
Enable a filter by typing its key followed by a space, then enter your search terms. For example, f delay searches all FX with "delay" in the name.
To clear the current filter, type space twice with no search terms.
You can also pick a filter from the dropdown in the search box. It lists every filter above with its key, plus All Results and, when you have new results, New.
Press Tab with an empty search to search the filters themselves, including FX categories and tags. Type a name like VST3 and press Enter to jump there. Press Tab again to go back.
Each filter also has its own action in the Actions List, such as nvk_SEARCH - FX or nvk_SEARCH - Project Template, so you can open SEARCH on one filter with a shortcut.
Filter keys can be turned off or switched from Space to Tab under Preferences > General.
Sidebar
Press Ctrl+B or click the tab at the edge of the results to open the sidebar. It's on the right by default, and you can drag its edge to resize it or move it under Preferences > General > Sidebar on left.
Browse lists result types, FX categories, chains, and track templates. Tags lists the tags you've added to results. Selecting a row limits the results to it and shows a removable chip in the toolbar. Searching looks past the selection until you clear the search.
Tags
Tags work like Reaper's FX folders, but you can tag any type of result: actions, chains, templates, and so on. A result can have as many tags as you like.
- Right-click a result and open Tags to tick the tags it should have. Type a name in the New tag… field and press
Enterto create a tag and add the result to it in one step. This works on several selected results at once. - Click + next to Tags to add a tag, a folder to group tags in, or a divider.
- Right-click a tag to choose an icon and color, or turn on Show in results list to show its name beside its results.
Alt+Clicka tag to add a random FX from it.- To bring in your existing folders, use Import from FX Browser in Preferences.
Add button
The button at the bottom of the sidebar shows what will happen to the selected result and where it will go, such as Run with a script's name or Insert with a track's name. When FX are selected, the chevron next to it opens the other ways to insert them. You can hide it with Show Add button in sidebar in Preferences.
Adding FX
By default, FX go to the selected tracks or items. You can also drag FX onto a track, a take, or an FX chain, and SEARCH collapses to its header while you drag so it's out of the way. To put an effect inside an FX container, drop it on the container's row in the chain.
- Focused chains: turn on Prefer focused FX chain in Preferences to add to the FX chain window that has focus. Right-click a result and choose Replace focused FX to swap out the focused effect.
- FX slots:
Ctrl+1toCtrl+9add to that slot number. - Instruments: adding an instrument can create a new MIDI track.
Altswitches between that and the selected track. - Master and monitoring: the right-click menu has Insert (master track) and Insert (monitoring FX).
- TCP controls: right-click an effect and turn on Show UI in TCP when added to do that every time you add it.
FX that are in Reaper's Hidden FX folder (Reaper 7.83 or later) only appear in SEARCH inside folders and tags.
Visual FX
Visual FX shows your plug-ins as screenshots, so you can browse by what they look like. It requires the nvk_API extension, which the installer includes. If it's missing, SEARCH tells you how to install it.
Click the grid button in the toolbar or press Ctrl+U to turn it on. Results appear as Cropped tiles or Full interfaces, and while you're searching, each row shows a small preview.
Click the chevron beside the button to change the layout and size and to capture screenshots. Ctrl+Scroll over the results, or Ctrl+= and Ctrl+-, also resize them.
Screenshots
- All at once: click Capture missing screenshots in the options panel. SEARCH opens each plug-in window to capture it, and you can include full-interface JSFX.
- One at a time: hover over an effect with no screenshot and click Capture, or right-click it and choose Capture screenshot.
- Your own image: right-click an effect and choose Use image file....
- Change the framing: right-click an effect and choose Adjust thumbnail crop....
Scripts
Scripts can have screenshots too. Right-click one and choose Capture screenshot, then click the script's window, or click Run script to let SEARCH run it and capture the window it opens. Running a script can change your project, so SEARCH only does this when you click the button.
Actions
- Find an action by its shortcut: click the keyboard button in the toolbar and press the keys, or use the nvk_SEARCH - Search by keyboard shortcut action.
- Assign a shortcut: select an action and press
Ctrl+Alt+A, or use the right-click menu. - Copy for scripting:
Ctrl+Shift+Ccopies the action as ReaScript code, andAlt+Ccopies its name. - Find it in Reaper: right-click an action and choose Show in Action List....
- Clean up: Remove missing scripts from actions list in Preferences finds script actions whose files no longer exist and removes the ones you select.
Action results also show their current on or off state and any shortcuts they have.
Keyboard shortcuts
These are the defaults. Change them under Preferences > Keyboard shortcuts. On macOS, Ctrl shortcuts use Cmd.
| Shortcut | Action |
|---|---|
Enter | Add result |
Shift+Enter | Add result and keep the window open |
Alt+Enter | Add result, alternate target |
Ctrl+J, Ctrl+K | Next and previous result |
Ctrl+E | Toggle favorite |
Ctrl+F | Clear the search and reset the filter |
Ctrl+B | Show or hide the sidebar |
Ctrl+U | Toggle Visual FX |
Ctrl+Shift+P | Toggle the command palette |
Ctrl+I | Toggle showing the FX window after insertion |
Ctrl+P | Stay open |
Ctrl+R | Refresh and rescan all results |
Ctrl+O | Open in external editor |
Ctrl+Shift+O | Show in Finder or File Explorer |
nvk_MINIMENU
nvk_MINIMENU is a small launcher you drive from the keyboard, included with nvk_SEARCH. Build folders of actions, FX, chains, track templates, and other results, give them your own keys, and run them with a few keystrokes. Assign the nvk_MINIMENU action to a shortcut to open it at your mouse.
| Key | Action |
|---|---|
| An entry's key | Run it, or open it if it's a folder |
/ | Search this menu and its submenus |
Ctrl+F | Search all results |
` | Run a random entry from this folder and below |
Esc | Go back |
Click the menu's header to edit it. In the editor you can:
- Add and rename entries, assign keys, and drag to organize them, with undo and redo.
- Group, move, or flatten several entries at once.
- Point an entry at a new target with Replace... if the original is gone.
- Make a folder into its own Reaper action.
- Import your FX favorites or a saved Toolbar, and import or export whole layouts.
- Set the spawn position, stay open after running an entry, or reopen at the last submenu.
MiniMenu also keeps recent results you can pin and a Chain Library of your FX chains. To add something while you're in SEARCH, right-click a result and choose Add to MiniMenu.... The nvk_MINIMENU - Repeat Last action runs your last command again.
Known Issues
- Character display is limited to Latin characters.
- Without nvk_API, startup can slow down after Reaper has been open for a while. It seems to be related to either
kbd_enumerateActionsorReverseNamedCommandLookup(they start taking longer to run). Restarting Reaper fixes it.
Changelog
Show changelog
2.2.2
- Clarify installer instructions when nvk_SHARED is missing or needs an update.
2.2.1
- Search and browse
- Redesign results with compact and detailed views, clearer metadata and a resizable Browse and Tags sidebar.
- Add an optional sidebar Add button showing where results will go, with more FX insertion options.
- Rename collections to Tags; tag results from their context menu and assign custom icons and colors.
- Add Tab-to-browse filters, visible search scopes, Suggested results, a New filter and optional recency/frequency ranking.
- Improve fuzzy matching, synonyms and relevance sorting, and explain which settings and extensions fuzzy matching needs.
- Search by action shortcut, assign shortcuts from results and view toggle states.
- Add searches for Project Templates, Subprojects, Take Markers and individual FX formats.
- Respect REAPER's Hidden FX folder in REAPER 7.83 and later.
- Double-click the header to collapse SEARCH; typing or launching it again expands it.
- Ctrl+R performs a full refresh and rescan; use the heart button to favorite results.
- nvk_MINIMENU and Visual FX
- Add a keyboard-driven launcher with folders, shortcuts, recents, a Chain Library, persistent and stay-open modes.
- Import and export layouts, REAPER toolbars and FX favorites; undo, redo, repeat or randomize commands.
- Browse FX with thumbnails or full-interface previews, bulk capture, custom PNGs and graphical JSFX.
- Recapture screenshots for multiple selected effects, including selections across plug-in formats.
- Insert into FX containers, target or replace focused chains and reveal plug-in paths.
- Show Visual FX cards with names below their previews; capture screenshots of scripts as well as effects.
- Open preview layout and capture settings beside Visual results; resize previews with Ctrl/Cmd+scroll.
- Visual FX requires the nvk_API extension package from ReaPack.
- Improvements and fixes
- Keep launch shortcuts from reaching REAPER when reopening SEARCH.
- Build the index in the background and improve large-library performance, keyboard navigation and drag-and-drop.
- Save tags, favorites and settings as they change so a REAPER crash no longer loses them.
- Keep narrow windows readable, confirm tag removal and keep MiniMenu entries stationary when batch actions appear.
- Keep persistent searches, filters, favorites and project results current after reopening, rescanning or changing projects.
- Fix the New filter disappearing after rescans and searches ignoring the character after a closing quote.
- Fix Enter on scrolled-out results, FX-slot actions, Clear folders and inserting AU plug-ins without manufacturer names.
- Fix MiniMenu FX-favorites import and removed project directories remaining searchable.
- Fix errors with pinned folders, deleted project objects, saved settings without ReaPack and Windows paths with non-English characters.
- Apply Instrument tracks auto-arm when selected to existing tracks receiving an instrument.
1.20.0
- Added 'Take Marker' as a result type.
- Fix error when adding fx to a folder with the right click menu when an empty folder name exists.
1.19.1
- Improve behavior when nvk_SEARCH is set to always on top and a project is loaded with prompts in the same location as the script. Not completely fixed, recommend not using 'Always on Top' if possible.
1.19.0
- Updated layout for preferences window.
- Reduce flicker when opening palette mode.
1.18.3
- Adding subprojects as a result type. Filter key for project templates is now 'n' instead of 's'.
1.18.2
- Selecting multiple results and pressing enter will now add all of them properly
- Sidebar can now be moved to the right side of the window
- Font improvements
1.18.1
- Fix for error when timestamps aren't parsed correctly
- New tracks added with drag and drop will now be selected and set to last touched in order to match behavior of the built-in FX browser
- Error when parsing smart fx folders with no string match
1.18.0
- Compatibility with nvk_SHARED 4.0.0. Make sure to update all your scripts to the latest version.
1.17.9
- Option to set new instrument tracks to auto-arm when selected
1.17.8
- Reverting back to old behavior of adding to the selected track or item when adding instrument plug-ins. The default behavior can now be changed in the settings and as before toggled with alt
- Name tracks when adding instruments
1.17.7
- Option to check for missing project files and remove them from the search results (increases startup time)
- Removing unnecessary Reaper 6 compatibility code
1.17.6
- Dragging a virtual instrument to an empty track area will create a new armed track
- Fix right-click context menu text for virtual instruments
1.17.5
- Add shortcut to add FX to specific slot numbers (e.g. Ctrl+1 adds to FX slot 1, etc.)
1.17.4
- Make new track with armed midi the default behavior when adding instrument plug-ins. Now alt-add will add to the selected track or item
- New hotkey: Ctrl+F to clear the search field and reset the filter
1.17.3
- Script was not properly getting the last clicked item or track when determining where to add FX
1.17.2
- Refactoring - make sure to grab latest version of nvk_SHARED
- Alt key to open or not open projects in new tab (opposite of default setting)
1.17.1
- Error when opening palette mode again after adding a result with persistent mode enabled
1.17.0
- New filter option: project templates (filter key: s)
- Adding option to open projects as templates from right-click context menu
- Context menu for project templates allows them to be opened not as a template, but a project in case you want to edit them
- Palette mode is now moveable and resizable (move by dragging from the right edge)
- Better tooltips for palette mode buttons
1.16.4
- FX chains now show up in FX folder results
- Better display of project folder path in folder list + option to hide it
1.16.3
- Improvements to smart folder results
1.16.2
- Add support for smart folders (thanks Sexan for helping with this)
- Option to keep window focused after adding FX
1.16.1
- Warn if Reaper 7.18 or higher is not installed (required for InsertTrackInProject)
1.16.0
- Incorrect results window height in palette mode with results scaling
- Use defaults when creating a new track in a project
- Option to include folder name in search
1.15.3
- Error when using keyboard shortcuts to navigate results in palette mode with no search string
1.15.2
- Refactoring - make sure to grab latest version of nvk_SHARED
1.15.1
- When selecting items, the cursor now properly moves to the start of the items
1.15.0
- New section in preferences for filter keys (filter changing based on first letter in search followed by space)
- Option to disable filter keys completely
- Option to change the filter key trigger from space to tab
- User text color for parent folders not displayed correctly
1.14.0
- Fix for font paths in Reaper 6
1.13.0
- Updated to ReaImGui 0.9.2
- Visual improvements
1.12.5
- Open in file explorer and open in external editor sometimes didn't work on Windows.
- FX and Track Templates can create new tracks now if no items or tracks are selected.
1.12.4
- Compatibility with new nvk_SHARED font system
1.12.3
- Moving persistent mode functions to nvk_SHARED, setting is now in 'Functionality' section
1.12.2
- Crash when dragging favorite results to sort them
1.12.1
- Backspace now focuses search field
1.12.0
- Dependencies moved to nvk_SHARED
- In palette mode, large font sizes and zoom settings could cause the controls to be off screen
- New startup options section: moving relevant settings to this area, adding option to load last folder selection
- In persistent mode, the last folder selection no longer gets saved by default (setting added to restore last folder selection in either mode if desired)
1.11.3
- Improvements to how folder colors are displayed
1.11.2
- Crash when removing project directories individually
- Removing individual project directories could have removed incorrect folder in rare cases
- Option to rescan project directories on startup
- Crash when opening the script for the first time with no config (whooooops)
1.11.1
- FX and Folders Sidebar now collapsible headers instead of option to hide
- Dividers and new folders get added at end of all selected folders to the same parent folder as the last selected folder
1.11.0
- Upgraded to ReaImGui 0.9
- Folder coloring
- Fixed: adding random fx from right-click menu of folder could add incorrect folder fx
- Option to hide fx sidebar
- Slight tweak to search algorithm so that results with the same word match multiple times are not scored higher
- Close preferences window when closing script (still stays open in persistent mode)
- You can now drag the All folder to a different position if you want to have the script open to a different folder by default. It will always open the first folder in the list.
- Folder dividers
- Betting crash handling
- Multi-selection of folders - results will show all items from selected folders
- Parent folders - selecting them will show all items from their children
- Fix for escape key not clearing search field on newer versions of ReaImGui
- Order of results when dragging multiple results is preserved
1.10.7
- Fixed: Media folders being scanned for project files in subdirectories (loading subprojects)
1.10.5
- Show recent results when a filter is active and the search bar is empty (was only showing recent results when no filter was active)
1.10.4
- Trial improvements
1.10.3
- Open take source file in right-click context menu
1.10.2
- Fixed: crash when adding fx to the master track
1.10.1
- Removing 'reveal hidden tracks' setting as it seems pointless. If you don't want a track to be revealed, don't select it.
- Fully collapsed tracks will now be revealed by uncollapsing the parent track when searched
1.10.0
- Updating layout of preferences, consolidating some categories and moving things around
- FX - Alt mode: option to change what happens when alt is held while adding fx. Can now switch to the alt key determining whether to add fx to an item or track. This overrides the default behavior of adding depending on focus.
1.9.7
- Fix crash when sorting results by name with unnamed markers in the project
- Certain keyboard shortcuts not working after opening the preferences window
1.9.6
- Theme import not working on Windows
1.9.5
- Results not updating when re-opening script in persistent mode with an existing search
1.9.4
- FX menu popup no longer displays unless mouse is moved since it could be annoying if the mouse happened to be there on startup
- Context menu option to add any fx as instrument track not just VSTi, AUi, etc
- Esc key now closes the preferences window if it's focused (esc always closes script will still close everything)
1.9.3
- Context menu for alt add fx not working
- Option to load last search on startup
- Better handling of disabled checkboxes (show override setting)
1.9.2
- Improved behavior when dragging to re-order folders, results, fx
- Palette mode UI could be positioned incorrectly if opening with a filter
- New scripts for opening with a specific filter enabled
1.9.1
- Persistent mode: with this enabled, the script will stay open until quit. It will reopen whenever it's run again, but won't have to rescan everything. This makes the startup time instantaneous. It will also remember the last search and any selected results. To fully close the script, use the quit hotkey.
- New option: Rescan results - mostly useful for persistent mode, in case you add new fx or actions while the script is open. This will rescan the results without having to restart the script.
- New option: Always on top - useful in case script is hidden behind other windows such as pinned fx.
- Fixed: couldn't rename folders because search would get focused from text entry.
1.9.0
- Command Palette mode: minimal search window with no sidebar or results until search is performed. Hides a lot of the UI. Can be toggled with the keyboard shortcut.
- Alphanumeric input now focuses the search bar from anywhere
- New shortcut options
- Fixed: search string help text now honors disabled result types
- Fixed: crash with alt-click on 'All' folder
- Fixed: enter on empty search could add fx
- Fixed: docking preferences script in main script window could cause script to break
- Fixed: FX window still shown even if 'show fx window after insertion' is disabled with certain Reaper preferences
1.8.1
- New option: FX - Always add to track
- Themes: import/export and save as global default
- Load time optimizations
- Fixed: preferences being closed could unfocus the script and cause it to close
1.8.0
- Sort methods for results. Choose from relevance (new optimized search algorithm), order (results display in default order they are scanned), name (alphabetical a-z), or last modified date (if applicable)
- Improved hover text
- New option: Active filter disables filter keys
- New option: Actions - only show main section
- Show favorite icon in recent results (was confusing that you could favorite/unfavorite recent results without the icon)
- JSFX not showing up in sidebar FX list
- Changing label JSFX to JS in certain cases
- Capitalizing type names for more consistent display
- New keyboard shortcuts and slight changes to naming for open and open in external editor
- Fixed: cursor context could be lost when window is closed and re-opened (determing if cursor is on item or track)
1.7.0
- Fx types now display in order of user preference in sidebar
- New option to 'Close if unfocused' in preferences
- Possible fix for crash with certain takes that have invalid source media
- New option in settings to import user folders from FX Browser into sidebar
- Search algorithm tweaked to hopefully give more useful results
1.6.6
- Fixed: actions not showing up in folders unless 'show command id' was enabled
- Fixed: crash when showing script in finder
- Open script option in context menu to open script in a text editor (or whatever is set as the default program for .lua files)
1.6.5
- Fixed: alternate fx add mode was not working properly
1.6.4
- Fixed: when adding fx from sidebar to current selected folder, the folder was not being updated
1.6.3
- Fixed: incorrect link to forum thread
1.6.2
- Fixed: cleared recent projects list was still showing up in results
1.6.1
- Improved speed of adding multiple fx in a row with enter
1.6.0
- New feature: add custom project paths in preferences
- Paths will be scanned recursively for .rpp files on add. They can be rescanned manually. Recent project files will still show up in the results so this won't need to be done often.
- Scanned projects can be sorted by name or last modified date (note: last modified date can slow down startup times if there are a lot of projects)
- When adding a path, a new folder will be created with that project path in the sidebar. FYI, if removed from this folder, it may be re-added next time a project path is added or removed.
- Recent projects will show up first in the results
- Rearranged preferences to make better use of space and fit new projects feature
- Preferences no longer behaves as a popup, and must be manually closed. It will reopen if the script is restarted while it is open.
- Tooltips when hovering over folders and project paths that are too long to display
- Fixed: Esc key was not closing the keyboard shortcut popup
1.5.3
- Fixed: Crash with project names that are just .rpp
1.5.2
- Crash when adding fx
1.5.1
- Fix for possible crash with some project names
1.5.0
- Multiple selection of items allowing for adding multiple FX at once or dragging/removing multiple results from a folder
- New options: open projects in new tab, hide project patch, keep search on folder change
- New context menu option: Open project/track template in new tab
- Display user keyboard shortcuts in context menu
- FX duplicates are now removed in order of fx display options
- VST3 and VST3i are now separate from VST and VSTi
- Projects added to folders are now saved permanently
- Fixed: certain C++ extensions could cause actions to not be scanned properly
- Rearranged preferences
- Favorites section: favorites can be displayed at the top in their own section regardless of result type
- Favorites can now be rearranged with drag and drop
- Support for matching multiple words in quotes
- Menu bar: show fx window after insertion
- Option to disable certain results from being displayed with alt-click
- If filter is set to an excluded result type, it will show the results regardless of global settings, allowing you to temporarily find results that are normally hidden
- Alt fx add (insert fx for non-inst fx and create midi track for inst fx) with alt + enter or alt + drag to track (can alt-click from sidebar fx list or alt-double click from results list)
- FX can be added to master track by dragging directly on the master track
- To add fx to monitor fx chain, hold alt while dragging the fx to the master track
- Context menu to add fx to master track or monitor fx chain
- More compact keyboard shortcuts name display
- Toggle favorites mouse click modifier changed to ctrl/cmd+shift instead of alt
- Exclude filters from search with hyphen prefix i.e. "-f" will exclude fx from the results
1.0.3
- Drag and drop all valid results to folders, not just FX
- New option: reveal hidden tracks when selected in results list
1.0.2
- Fixed: Crash on load for certain systems due to actions.dat loading out of order
1.0.1
- Fixed: Duplicate tooltip on hover esc always closes script option
- Fixed: AU plugins not adding properly
1.0.0
- Initial release