Uninstalling HotSpotClicker

First, consider the actual need to uninstall. HotSpotClicker lies completely dormant in your computer. It takes no action at all, unless it is connected into the scripts for ya particular application, and that application has focus. So, the bulk of the benefit lies in simply disconnecting HSC from your applications. If it is not connected to any application scripts, HSC does nothing at all, and can safely be left there in case you change your mind later. However, in the rest of this document, we'll assume that you really want to remove it entirely.

The process of installing HotSpotClicker on your computer is actually the concatenation of two things:

1. the automatic steps, performed by the installer itself.
2. The manual steps you took, each time you wanted to connect HSC to a particular application.

In addition, your application keyMap is further modified, each time you create a new hotSpot with a hotkey attached. The Uninstaller is not aware of all the manual steps you performed along the way. Therefore, to completely remove HSC from your system, you need to undo the manual steps first. Then, once HSC is completely disconnected from all applications, you can use the uninstaller to automatically remove all files from your machine. Failure to do things in the prescribed order will cause annoying error messages to be spoken each time you place focus in an application which was connected to HSC.

When HSC was installed, the installer took a copy of the folder that contains all your user-specific jaws configuration files, and created a folder called "Backup of Enu before HotSpotClicker Install", into which all those original configuration files were placed. This folder can serve as an archive from which unaltered files can be restored.

There are three basic ways of restoring affected JAWS configuration files. You need to use one, but only one, of these methods:

1. role back your entire jaws configuration to the condition it was in at the time when HSC was installed. This will completely erase any changes you have made, to any application script or configuration, for any application, even if the change did not involve HotSpotClicker. This is a heavy handed approach, but it is convenient, and complete.
2. Role back the settings for selected applications. This involves copying selected sets of files from the backup folder, into the main configuration folder. This will preserve changes you have made to the scripts for non-hsc connected applications, but will discard all changes you have made to the scripts for those applications to which HSC is connected.
3. Manually Edit selected files. This will preserve all other changes you have made to all applications, even those to which hsc is connected. However, this is a more involved, manual process.

Where Stuff Is Stored

In this section, we'll establish some generic names we can use to refer to folders in the jaws folder hierarchy. This is convenient, primarily because the path names are very long, and contain fields which are specific to your user name, and jaws version. Using these carefully defined generic names should make things easier in the subsequent discussion.

To open the folder where user-specific configuration files are stored, press the windows key, folloed by the letter p, for Programs. then, press the letter j, until you hear your version of jaws. Next, press right arrow twice. You should hear jaws say, explore my settings. Press enter to open that folder in Windows Explorer. We will refer to this folder generically as the "settings\enu" folder, even though the actual name is different, and will depend on your chosen language.

To reach the backup folder, Press backspace while focused in the settings\ENU folder. You should now be located in the, "settings," folder, which is a small folder often containing only the ENU, and perhaps one or two other folders as well.

While focused in the Settings folder, use the arrow keys to navigate to the folder called "Backup Of Enu Before HotSpotClicker Install". Press enter to open that folder. We will refer to this folder generically as "the backup folder". If you are copying files from one to the other, it will be helpful to have both of these folders, settings\enu and Backup, open at the same time. This can be done by simply once again following the steps outlined above using the start menu. .

Option 1, role back your entire jaws configuration

This is the 900 pound sledge hammer approach, and will discard any and all changes you have made, to all jaws configurations for all applications since you installed HotSpotClicker. It will restore your jaws configurations to the settings that were in effect just prior to the HSC installation.

During part of the next steps, you will be without any custom application-specific jaws settings. So, do not alt+tab away from this Windows Explorer window until the final step is complete.

1. Navigate to the Settings folder by going to the start menu, and pressing p for programs. type the letter J until you reach your version of jaws. press rightArrow twice, to reach, explore my settings. Press enter to open the folder. This is the folder we called "explore my settings". But, it's actual name will be the 3-letter abbreviation for your language. Often, this will be "ENU".
2. Press backspace, to go to the parent folder, which is called "settings".
3. Use the arrow keys to locate the enu folder, or equivalent for your language.
4. Press f2, which will bring up an edit box containing a highlighted version of the current name of this folder. Then, being careful not to inadvertently bump any navigation or edit keys, press control+C to copy that name to the clipboard.
5. Now, type a new name for this folder reflecting the folders contents, then press enter. This will serve as a backup copy of your jaws configuration files presently in effect, which will thus contain coppies of any hsc connected configuration files, in case you should need them again.
6. Next, locate the folder called "Backup of ENU before HotSpotClicker Install".
7. Press f2, then control+v, to replace this name with the name previously coppied to the clipboard, then press enter.

Your jaws settings are now roled back to the point prior to the hsc install, HSC is completly disconnected and inactive, and you are ready to perform the automatic portion of the uninstall process, accessed through the Windows start menu.

Option 2, Role back the settings for selected applications

This is just a matter of copying certain files from the "Backup" folder to the settings\enu folder. This technique will discard all changes you have made to the jaws configuration for only those applications to which HSC is connected, but will leave all other configurations in tact. You should do this for each application you have connected to HSC.

If you forget which applications you have connected, you can determine the list by navigating to the settings\enu folder, then opening file HSCApplications.txt. This file contains a list of all applications to which HSC has ever been connected, along with the date and time at which the connection occurred.

Next, open two Explorer windows, one with the Backup folder, and one with the settings\enu folder. For each application in your restore list, copy all files with your application name, and the following extensions, from the Backup folder to the settings\enu folder.
.JKM
.JSB
.JSD
.JSS
Or copy all files by that root name, if you wish.

Once you have done this, for all applications in your list, you are ready to run the automatic uninstaller, accessed through the Windows Start menu.

Option 3, Manually Edit selected files.

This method is manually intensive, but is the only way to preserve all other configuration changes you have made to your hsc-connected applications. This method is prone to manual editing mistakes, so be careful as you work. You must perform these steps for each hsc-connected application.

If you forget which applications you have connected, you can determine the list by navigating to the settings\enu folder, then opening file HSCApplications.txt. This file contains a list of all applications to which HSC has ever been connected, along with the date and time at which the connection occurred.

Perform these steps for each application on the list:

1. Open the application. While focused in the application, Go to the HSC Actions menu with hsc mods+f10, and press enter on the item that says
   KeyMap, remove all HSC keystrokes from the JKM file
   This will purge all HSC-related keyboard assignments from your application's jkm file.
2. Press Insert+0 on the numbers row to open the script manager with the scripts for this application. Using the control+f find text command, do the following:
3. Find the line that says
   Use "HotSpotClicker.jsb"
   and delete that line.
4. If you installed automatic set switching. find a function in your file called FocusChangedEvent. Arrow down a couple of lines, looking for the line that mentions a ffunction called HSCFocusChanged, and delete that line.
5. If you installed Prompt Processing, find a line that mentions function "HSCCheckForPrompt()", and delete that line.
6. This will not apply to most people. but, if you really got involved, and made any other calls to HSC functions from your script source, you should also remove those function calls, along with any reference to other HSC files,. such as hotSpotClicker.jsh
7. Recompile the script file, by pressing control+s. Then, close the script manager..

Repeat the above process for all connected applications. Once this procedure has been performed on all applications in your list, you are ready to invoke the automatic HotSpotClicker Uninstaller.

tip: if you wish to temporarily disable hotspot clicker from functioning in any given application for any reason, instead of deleting the lines in the above steps, you may simply place a semicolon, at the beginnings of those lines, leaving them intact. this will effectively disable them from being read by the compiler when you save the file, and will enable you to, "reconnect," hotSpotClicker at a later time. To do this, simply relocate those particular lines, remove the semicolons, and recompile the scripts by pressing control+s.

*** end of document