Problem

After clicking a ttstudio link in Firefox or Mac OS X, TestTrack does not start and the following error is returned:

'Firefox doesn't know how to open this address, because the protocol (ttstudio) isn't associated with any program.'

Cause

Firefox does not recognize the ttstudio protocol used to open TestTrack.

Solution

Linux distributions not using Gnome 3

Register the ttstudio protocol and enable the ttstudio URL handlers.

Note: The following instructions require Gnome libraries and work for all Firefox versions.

1. Run the following commands from a command line. These commands cannot be run by the root user.
   gconftool-2 -s /desktop/gnome/url-handlers/ttstudio/command '/usr/bin/tturlredirector %s' --type String
   gconftool-2 -s /desktop/gnome/url-handlers/ttstudio/enabled --type Boolean true
2. Click a ttstudio link in Firefox to start TestTrack.

Note: To register the ttstudio protocol without installing Gnome libraries in Firefox 3.5 and later or Firefox 3.0 and earlier, see the MozillaZine Register Protocol knowledgebase article.

Linux distributions using Gnome 3

Register the TestTrack URL Redirector as the ttstudio handler.

1. As the root user, create a new .desktop file in the /usr/share/applications directory. You can use any filename, such as testtrack.desktop, but it must include the .desktop extension.
2. Copy the following to the file:
   [Desktop Entry]
   Version=1.0
   Name=TestTrack
   Exec=/usr/bin/tturlredirector %u
   Terminal=False
   Type=Application
   MimeType=x-scheme-handler/ttstudio
3. Save the file.
4. Run the following command as the root user:
   update-desktop-database
5. Click a ttstudio link in Firefox to start TestTrack.

Mac OS X

Add the TestTrack URL Redirector application to Firefox.

1. Enter the following commands in a terminal window:
   cd /Applications/TestTrack/"TestTrack URL Redirector.app"/Contents/MacOS 
   chmod ugo+x "TestTrack URL Redirector" 
   ./"TestTrack URL Redirector"
2. In Firefox, enter ttstudio://config in the Address bar. The TestTrack URL Redirector dialog box opens.
3. Select Use the TestTrack client and enter TestTrack Client application path.
4. Click OK.
5. Restart Firefox and click a ttstudio link to start TestTrack.