Unify Manual

Your complete reference to PlugInGuru's creative playground!

User Tools

Site Tools


manual-guru-unpack

Manually unpacking ".guru" files

Some Unify users on Microsoft Windows 10 have found that they are unable to drag/drop .guru files into Unify. This is due to new Windows 10 security measures. (Windows will not allow files to be dragged from an app with lower privileges to one with higher privileges. Windows Explorer runs with ordinary user privileges, so if you run Unify with Administrator privileges, you will not be allowed to drag files from Explorer into Unify.)

The easiest way around this problem is to forget about drag/drop, and instead click the green “Select .guru file…” button in Unify's Settings view. This opens an ordinary file-chooser dialog, where you can navigate to wherever your .guru file is, select it, and click Open.

In very rare cases (and only if you're quite comfortable working with files), you might want to unpack the .guru file manually. The following instructions are specifically for the Unify Std Lib 1.0.6 Update.guru file for Unify v1.0.6, but the basic principle is the same for any .guru file.

Make a backup copy of Unify's main data folder

Since you're going to be overwriting many files in Unify's main data folder, we strongly recommend that you make a backup copy of the entire folder before starting. To locate the folder:

  • Open the Unify stand-alone app
  • Go to the Settings view
  • Click the “Open…” button
  • In the Explorer/Finder window which opens, navigate UP one level, to the folder which contains Unify's main data folder.
  • Either duplicate the Unify data folder, or compress/zip it.

Install 7-zip (Windows) or Keka (Mac)

Each .guru file is actually a standard Zip archive, so IF you can manage to change the .guru extension to .zip, you can just unzip it using your operating system's built-in unzip utility. Please don't even try this unless you know exactly what you're doing. All recent versions of both Windows and MacOS are configured to hide filename extensions by default, and unless you manually enable display of full filenames, you can easily end up with a file that's actually called something like “name.zip.guru” and still can't be opened.

You can avoid all this trouble by installing a decent zip archive utility.

  • On Windows, use the excellent (and free) 7-zip
  • On Macintosh, use Keka
    • You can download the free installer from the main Keka page
    • Or you can use the “Download from the Mac App Store” to get the “official” one (costs a few dollars).
    • Run the Keka app once, open the Preferences, and set the default action to “Always extract”

Unpack the .guru file to a new folder

On Windows, after installing 7-Zip, you can right-click the .guru file and choose 7-zip > Extract to “Unify Std Lib 1.0.6 Update/” to unpack the contents to a new folder with the same name as the .guru file.

On the Mac, you can right-click the .guru file, choose Open with…, and select Keka from the list. If you set the default action to “always unpack” as advised above, it should immediately unpack the contents into a new folder with the same name as the .guru file.

From this point on, the steps should be the same for Mac or Windows.

Open the new folder AND Unify's data folder

Double-click the new folder you created by unpacking the .guru file. Run the Unify stand-alone app, go to the Settings view, and click the “Open…” button to open the main Unify content folder, and then close Unify again.

Now compare the two folders, looking inside the various sub-folders. You'll see that the .guru file contents (shown on left below) are a subset of the more complete structure in Unify's main data folder (right):

Copy files from the new folder to Unify's data folder

At this point, you can manually copy the new/updated files from the unpacked .guru folder to the corresponding locations in Unify's main data folder. Remember, we recommend making a backup of your Unify data folder before starting.

In almost every case, you'll be copying a new version of a file on top of an older file with the same name, and you'll be prompted to confirm that you want to replace the older file with the newer one. If you don't see such a prompt, double-check that you're putting the new file into the right place.

Close folders, clean up, run Unify, rebuild patch database

When you're finished copying files, you should:

  • close any open folders
  • move the new folder you created when unpacking the .guru file, to the Trash
  • move the .guru file itself to the Trash
  • open the Unify stand-alone app, open the patch browser, and click the lightning-bolt icon at the top right corner to rebuild the patch database.

It's a good idea to make sure everything is working as you expect, before emptying the Trash. If you think you may have made a mistake, or forgotten some files, you can drag the folders back out of the Trash and try again.

Once you're truly confident that you've made all necessary changes, and Unify is working as it should, you can go back and delete your backup of the main Unify data folder.

manual-guru-unpack.txt · Last modified: 2022/02/04 15:10 (external edit)