Installing the Ocarina of Time Randomizer for easy updating

install-ootr.md

How to install the Ocarina of Time randomizer in a way that can be easily updated.

Windows

Installing

1. Download Git from here (click the “Click here to download” link) and run the installer. It will ask you about a bunch of different things, you can use the defaults for all of them.
2. Open File Explorer and navigate to a folder where you want to place the randomizer folder. For example, if you want the randomizer to be at Desktop › Randomizers › dev-fenhl, go to Desktop › Randomizers.
3. Right-click on some empty space in the File Explorer window while holding ⇧ Shift. In the menu that appears, click on “Open in Terminal”, “Open PowerShell window here”, or “Open command window here” (the name depends on your Windows version).
4. In the window that opens, run git clone https://github.com/fenhl/OoT-Randomizer.git folder-name (replace folder-name with the name you want the folder to have). Once it's done and you see another > prompt, you can close this window.
5. Back in the File Explorer window, you should see a new folder named folder-name (or whatever name you chose in step 4). To run the randomizer, double-click the file Gui.py inside that folder. This may take a few minutes the first time you do it, but the advantage of installing it this way is that it won't always take as long after updating the randomizer.

Updating

1. Open File Explorer, navigate to the folder with Gui.py in it, and do the ⇧ Shift-right-click dance to open it in Terminal (or PowerShell or Command). (Note that this is not the same folder we opened in Terminal to install the randomizer. It's one level deeper.)
2. In the Terminal window, run git pull, wait until you see another > prompt, and close the Terminal window again. Your copy of the randomizer is now updated.

macOS

Installing

1. Install Homebrew if you don't already have it.
2. Open the Terminal app and run brew install git.
3. Type cd into Terminal without pressing ⏎ Return (make sure to include the space after cd), then drag and drop the folder where you want to place the randomizer folder into the Terminal window. For example, if you want the randomizer to be at Desktop › Randomizers › dev-fenhl, drop in Desktop › Randomizers. Then press ⏎ Return.
4. Run git clone https://github.com/fenhl/OoT-Randomizer.git folder-name (replace folder-name with the name you want the folder to have).
5. Now a new folder has been created inside the folder you dropped in. You can run the randomizer like you usually do from that folder.

Updating

1. Open the Terminal app, type cd without pressing ⏎ Return (don't forget the space), then drop in the randomizer folder. (Note that this is not the same folder we dropped in to install the randomizer. It's one level deeper.) Then press ⏎ Return.
2. Run git pull and wait until it's done. Your copy of the randomizer is now updated.