If GooTool gives an error, crashes, locks up, exits, or otherwise behaves unexpectedly, you will need to locate the logfile.

1. Find the log file. GooTool creates a logfile called gootool0.log in your temporary directory. For Windows Vista or 7 users, this is generally C:\Users\username\AppData\Local\Temp. For Windows XP users, it is in C:\Documents and Settings\username\Local Settings\Temp. Sometimes it might instead be in C:\Temp or C:\Windows\Temp. For Mac OS X, you'll probably find it under /var/folders/. For Linux, and earlier versions of Mac OS X, it's in /tmp/

2. If you see an error relating to your problem in the logfile, skip to step 5.

3. If not, you will need to increase debugging level. GooTool includes lots of debugging but it is disabled by default to avoid creating huge logfiles.

To increase the debugging level, under Windows navigate to your GooTool directory (e.g. C:\Program Files\GooTool) and then into the etc directory.

Under Mac OS X, right click on GooTool and "Show Package Contents". Then go to Contents then Resources.

Under Linux go to either GooTool's "etc" directory (if you installed the generic version), or /etc/gootool/ (if you installed the Debian package).

Edit the file logger_properties.txt. Find the line that reads:

java.util.logging.FileHandler.level = INFO

Change the word INFO to ALL.

4. Restart GooTool. When it next crashes, the gootool0.log file will contain a lot more information to help us to track down the problem.

5. Post the relevant section of the logfile to the forum, along with a description of the problem you experienced, what you were doing, and anything that may help us reproduce it.

6. Also post the exact GooTool version number. This is available on the Help->About menu. If you can't start GooTool at all, right click GooTool.exe and select Properties. The Details tab will show the version number.

7. If the problem seems related to a specific addin, post the name and version of the addin you are using (and a link to the download location if it's not on this site).