guru-files
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
guru-files [2021/09/03 20:56] – [How Unify unzips the .guru file] shane | guru-files [2021/09/03 21:51] – [Testing your .guru files] shane | ||
---|---|---|---|
Line 38: | Line 38: | ||
When Unify unzips the contents of a //.guru// file, it can only //add// or // | When Unify unzips the contents of a //.guru// file, it can only //add// or // | ||
- | ===== Creating a .guru file ===== | + | ===== Creating a .guru file (the safe way) ===== |
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: | 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: | ||
- Start by creating an empty " | - Start by creating an empty " | ||
Line 61: | Line 61: | ||
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/ | 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/ | ||
+ | ===== Creating a .guru file (the risky way) ===== | ||
+ | If you know what you're doing, you can use these steps instead: | ||
+ | - Open the main Unify data folder, and navigate into // | ||
+ | - Create a new empty // | ||
+ | - Drag (i.e., move) your own library folder into this new // | ||
+ | - Compress the new // | ||
+ | - Make sure to move your library folder back out into the main // | ||
+ | ===== Creating a .guru file (more generic) ===== | ||
+ | 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 // | ||
+ | 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. | ||
+ | |||
+ | ===== Testing your .guru files ===== | ||
+ | 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" | ||
+ | |||
+ | To create a second Unify data folder: | ||
+ | - Create an empty folder in a suitable location on your disk, then create empty // | ||
+ | * If you do not create these sub-folders, | ||
+ | - In Unify, go to the Settings view, click the " | ||
+ | - IMPORTANT: **Quit Unify** immediately. | ||
+ | * This step ensures that your patch database will not be damaged. | ||
+ | - Optionally, copy over any other content you may want (patch libraries, presets, etc.) from your real Unify data folder to your testing folder. | ||
+ | * Be very careful that to COPY (not MOVE) files/ | ||
+ | - Re-start Unify | ||
+ | * Unify will automatically create an empty database file // | ||
+ | * If you copied over any libraries, click the lightning-bolt icon at the top of the patch browser, to update this newly-created database to include entries for whatever patches you copied. | ||
+ | - Optional, but recommended: | ||
+ | * This will allow you to delete and re-create it quickly, for future tests. | ||
+ | - Drag/drop your //.guru// file, and verify that Unify responds as you would wish. | ||
+ | - Examine the contents of your test data folder carefully, and verify that all files/ | ||
+ | |||
+ | 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: | ||
+ | - Go to Settings, click the " | ||
+ | - **Quit Unify** immediately, | ||
+ | * Everything should now be back exactly as it was, including your patch database. | ||
guru-files.txt · Last modified: 2023/05/08 18:59 by 127.0.0.1