Unify Manual

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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) [[https://www.7-zip.org/|7-zip]]
  * On Macintosh, use [[https://www.keka.io/en/|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"

{{::keka-setup.png|}}

===== 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):

{{::update-106-contents-1.png|}} {{::update-106-contents-2.png|}}

===== 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.