Everything you need to know about our plug-in install, setup steps, configuration and usage of various features
No time to read online docs? Download Adobe PDF to read offline
v3.0.0 - 2022-April-25
Using the Patch Librarian
In this chapter, we are going to walk through the usage of the Patch Librarian and all its functions & possibilities. It might take some time to understand how it works, but for those who used Emagic SoundDiver in the past, this workflow is pretty much the same.
We have made the librarian look and feel the same across all our products. i.e., Waldorf Blofeld Editor has the same functions in the librarian, with some additional features like ability to import microQ and Q banks in the librarian.
But in general, you can request data from hardware to the librarian, store data from librarian to hardware, store banks to HDD as you make edits etc.
NOTE #2: Keep your banks organized. If you have too many levels in your folder tree, librarian is not able to solve it. Detail below.
- [data folder]/Patches/sub folder 1/sub folder 2/my bank.mid – this is OK.
- [data folder]/Patches/sub folder 1/sub folder 2/sub folder3/my bank.mid – this is NOT OK.
There is a lot to cover in this chapter, so it is perfect time to get some coffee or tea.
Let’s dive in!
BASIC LAYOUT AND FUNCTIONS
Let’s start with the definitions of basic layout and button / menu explanations.
-  &  = Select previous SINGLE or MULTI bank from the bank tree.
-  &  = Display popup menu of SINGLE or MULTI banks. Menu displays banks from data folder.
-  &  = Select next SINGLE or MULTI bank from the bank tree.
-  = Open Bank Edit menu, with most of the available request, write and other utilities.
-  = Save data from currently selected part TO selected librarian slot.
-  = Display SINGLE or MULTI mode programs in the librarian window.
-  = Upper data view, also used as EDIT BUFFER. Data can be edited only in the upper data view. Double click any entry to send the data to currently active part.
-  = Display Category filter drop down menu. Categories are Access Virus defined categories.
-  = Toggle on Category filtering. Selected category results will be shown in the lower data view.
-  = Toggle on Search function. Search results will be shown in the lower data view.
-  = Request Interval – Adjust request interval if you get time-out messages while requesting data.
-  = Sync Data From Hw function was explained earlier in the manual.
-  = Push Data To Hw function was explained earlier in the manual.
-  = Lower data view. This view can be changed while upper data view is locked due to unsaved data changes. Double click any entry to send the data to currently active part.
Now that we understand the basic layout, we can dive into more specific details per function.
Send SINGLE or MULTI to hardware
Sending data from Librarian to hardware is quite simple. Choose part  where you want the data to be sent and then double click any program name  from upper or lower data view.
This data is sent to hardware edit buffer. It is not written to hardware memory. This also updates the software interface, so you are in sync with parameters on both ends.
You can also use keyboard arrow keys to select programs. This works only when mouse cursor is over the upper or lower list view.
- Arrow down will select patch below the current patch.
- Arrow up will select patch above the current patch.
- Arrow left will select patch left to the current patch.
- Arrow right will select patch right to the current patch.
Changing librarian programs with –  or +  buttons works too, but only when LIBRARY CONTROL ON PROG CHANGE  is toggled on.
Program changes via MIDI will select corresponding patch from the librarian and send it to the hardware as well. i.e., Program Change 98 will send patch from slot 98 to the hardware.
Selecting Previous or Next Bank
Use –  or +  to select between previous and next bank from the HDD. You can also select bank by clicking the bank name  area. This will show a pop-up menu with all compatible banks in the Patches folder. Both lists behave the same unless Category or Search filter is on.
TIP #9: You can also change bank from the main control display area if Librarian Control on Program Change is toggled on as mentioned earlier.
LIBRARIAN View button allows you to view SINGLE patch bank contents in the data view areas or MULTI bank contents.
When SINGLE mode is chosen, you can load individual patches to your currently selected part.
When MULTI mode is chosen, you can load MULTI program to Virus, which contains information about the MULTI only. Only issue with MULTI programs is that the program data does not “know” which patch was set on each part, instead it only recognizes the programs by Bank and Program numbers.
We recommend using SAVE UI DATA function to write your data in our HDD. This format has each part patch stored in it and loads them from the file once they are being opened.
Save Part to Slot
SAVE PART TO SLOT function is only available when LIBRARIAN VIEW is set to SINGLE BANK MODE and only when upper data list view is active.
Now, to understand how this function works, let’s break it down:
Once you click SAVE PART TO SLOT  button, it will GET data from currently active part  to currently selected librarian slot .
Once data is stored, RED * sign will appear in the PATCH LIBRARIAN  tab to indicate that there are unsaved changes in the current bank.
Upper list bank – / + and bank drop down menus are disabled, until changes are saved or if you DISCARD  to trash your changes.
You can continue browsing between different banks with the lower data view if you wish.
You can sort patches based on the category set in the FX / SETTINGS #1 tab. You can set two category tags per SINGLE patch.
Category patches will be shown in the lower data list view once Category sorting is activated.
This is helpful when you want to get patches from a specific category and copy those patches to your favorite list in the upper data list view.
Choose Category from the categories  pop-up menu and activate the category sorting by toggling on the Category Filter .
Once categories are loaded, you can use the bank select  drop down menu to view all the category search results or use the bank – / + buttons to do so.
Toggle off Category Filter button to display normal patches in the lower data list.
You can search patches from the entire patch catalogue based on your search terms. Activate search function by clicking the magnifying glass .
Category filtering options will be replaced by search field  and case sensitive search  filter.
In order to perform a successful search, type in at least three characters to get some results. Search results are then shown in the lower list and selecting patches happens like mentioned earlier. You can also copy and paste search results to upper list as you wish.
Use case sensitive toggle to define if search results should match the case how you typed it or leave it off to show a much broader results screen.
- PLK search term with case sensitive filter off [aa] will show all patches containing plk and PLK or plK etc.
- PLK search term with case sensitive filter on [Aa] will show results containing exact match.
If search term gives you multiple banks or results, you can view them just like with the category filter by choosing different bank with – / + buttons or bank select drop down menu.
Toggle of magnifying glass to display normal patches in the lower data list.
If under any case you run into a situation where our plug-in or application constantly scans for different Device IDs while it is requesting data from the hardware, it might be wise to increase the Request Interval  by next value.
This could happen due to bad MIDI or USB cables or bad driver for the specific MIDI interface.
We included USB MIDI driver for the macOS Catalina and greater, to use with Virus TI-series if you don’t have MIDI interface in your disposal.
NOTE #1: Our USB driver cannot transmit audio in Windows operating systems, so you must route audio output from the Virus to your input source.
Upper Data View
Upper  and lower data list views has different function in the plug-in / application behavior. Upper list acts as a edit buffer or “destination” for your bank editing.
Here is what you can do:
- drag and drop data from upper list slot to another slot in upper list OR
- drag and drop data from lower list slot to upper list slot.
- copy data from upper OR lower list slot and paste the data to any of the upper list slots.
- rename any single patch or multi program in upper list view.
- initialize single slot from upper list view or initialize the entire bank at once.
Here is what you cannot do:
- drag and drop data from upper list to lower list.
Lower Data View
Lower  data list acts as a “source”, category and search results display area. What this means is that if there are on-going edits in the upper list view, you can still browse lower list to select different programs from different banks.
You can also initiate category filtering or search for a certain patch from the entire catalogue, even when bank editing is active.
Drag and Drop Examples: 1 and 2 are OK – 3 is not going to work