.guru files provide a convenient way to package, distribute, and install batches of related files in Unify, e.g., patch libraries, sample collections, etc.
A .guru file is simply a renamed .zip file, whose contents (files and folders) are set up to unzip into Unify's main data folder. Getting the folder structure right is the trickiest part of making your own .guru files.
The following example .guru file was created in support of a new video about the Patch Variations feature in Unify v1.6.0:
Click the link above to download this .guru file, and note that it has been re-zipped, i.e., you will have to unzip it after downloading. The software powering this online manual does not support the .guru file type, so it was necessary to zip it again before uploading. This is a common limitation of online file-hosting tools.
This particular .guru file has the following folder structure:
When this .guru file is dropped into the Unify GUI, Unify will unzip its contents into the main data folder. Hence, everything inside the Libraries folder in the .guru file will go into the Libraries folder in the main Unify data folder, and everything inside the Presets folder will go into Presets.
What happens is exactly the same as if you put the .guru file itself into the main Unify data folder, and unzipped its contents using the “extract here” option. (Different systems may use different wording to describe this, but the effect is the same, as described in the next section.)
Any folders present in the .guru file, which don't yet exist in the corresponding locations under the main Unify data folder, will get created automatically. This is why it is VERY important to get the folders inside your .guru files just right, or files and folders will go into the wrong places, and anyone to whom you send your .guru file will end up with a mess to clean up.
Individual Files present in the .guru file will be created if they don't already exist, but if a file by the same name does exist in that location, it will be overwritten with the new file. This is another reason to be very careful when setting up .guru files.
If the .guru file contains any patch files (i.e., files which go into the Patches sub-folder of any Library folder), Unify will take note of the library name (i.e., the name of the parent folder of the Patches folder containing the patch file) and trigger the patch database to rebuild only for that library (or libraries, if more than one are present).
When Unify unzips the contents of a .guru file, it can only add or overwrite files (and folders as required). It cannot delete files. Some capability to do this may be added to Unify in the future, but there is none at the moment.
Suppose you have created a new library called My Awesome Library in Unify, and you'd like to make a .guru file to help others install it quickly. Here are the steps:
At this point, assuming you followed the above steps precisely, you will have a valid .guru file, which others can now use to install My Awesome Library quickly.
If you want to upload your .guru file to some kind of file-sharing service, attach to an email, etc., it's usually best to re-zip the .guru file, and share/attach the resulting .zip file. Advise recipients that they must unzip it, then drag/drop the resulting .guru file into the Unify GUI, or use the Select .guru file… button in the Settings view and select it that way.
If you know what you're doing, you can use these steps instead:
The above instructions described how to make a .guru file for a single patch library, but .guru files can contain multiple libraries, or no libraries (i.e., no top-level Libraries folder at all), and anything else that belongs under the main Unify data folder, e.g., you may have a top-level Presets folder as in the example, or MIDI Bank Files, MIDI Controller Files, etc. In such cases, it's strongly advisable to use a working folder.
Whatever you do, just make sure that the folder structure of your .guru file exactly corresponds to where all of your own files need to go.
It's a very good idea to test dragging your .guru file into Unify, to make sure everything goes into the right places. The best way to do this is to create a second “main Unify data folder” somewhere on your disk, and select in Unify using the “Change…” button in the Settings view. That way, there will be no risk of messing up your actual Unify data folder contents, and you can switch back after you're finished testing.
To create a second Unify data folder:
If you notice any problems at steps 7/8, you will need to re-build your .guru file accordingly. Before trying it again, delete your entire test data folder, and re-create it as it was at step 6, by unzipping the zip file you created at step 6. Then you can simply re-start Unify and repeat steps 7/8.
When you are finished testing: