install_tortoise.md

Notes on installing TORTOISE v3.1.1 on a Mac (OSX 10.12.6)

1. Download TORTOISE (TORTOISEV3.1.1_MACOSX): https://tortoisedti.nichd.nih.gov/stbb/home.html. It should download a file called TORTOISE_V3.1.1_MACOSX.tar.gz in your ~/Downloads directory.
2. You can move this file to whichever directory you want to install it on your Mac. You can also leave it inside the ~/Downloads directory if you want.
3. If you have tried to install TORTOISE before, it's best to remove the system PATH settings that previous installations tried to modify. To do this, open both ~/.bashrc and ~/.bash_profile (if you miss one of these two files, you can safely ignore it), and remove all lines that seem to set the path to point to a directory containing TORTOISE in its path. For example, I removed the following lines:

export PATH=/Users/khuang/TORTOISE_V3.1.1/DIFFPREPV311/bin/bin:$PATH
export PATH=/Users/khuang/TORTOISE_V3.1.1/DIFFCALC/DIFFCALCV311:$PATH
export PATH=/Users/khuang/TORTOISE_V3.1.1/DRBUDDIV311/bin:$PATH
export PATH=/Users/khuang/TORTOISE_V3.1.1/DRTAMASV311/bin:$PATH
export DYLD_LIBRARY_PATH=/Users/khuang/TORTOISE_V3.1.1/DRBUDDIV311/bin

4. Go to where you put the file TORTOISE_V3.1.1_MACOSX.tar.gz and uncompress it: tar zxvf TORTOISE_V3.1.1_MACOSX.tar.gz. This should create a folder called TORTOISE_V3.1.1 in your current directory.
5. Go into that directory and execute the installation script (which just modifies your system path without copying any file):

>>> cd TORTOISE_V3.1.1
>>> bash install_bash.sh

6. For the installation to take effect, you need to open a new terminal window. In your new terminal window (and in all future terminal windows you open), you should see something after typing which DIFFPREP:

>>> which DIFFPREP
/Users/khuang/TORTOISE_V3.1.1/DIFFPREPV311/bin/bin/DIFFPREP

If you see an output (which is the path to the DIFFPREP command), then your system can use DIFFPREP and other TORTOISE commands.