Installer Help

Windows (7, Vista, XP):System Requirements Installing and upgrading Installed Files Uninstalling
Mac OS X (10.5+):System Requirements Installing and upgrading Installed Files Uninstalling
Linux (tested on Ubuntu):System Requirements Installing and upgrading Installed Files Uninstalling

Windows (7, 8, Vista, XP)

System requirements: Windows

You must run Tracker in a 32-bit Java 1.6+ VM to use both the Xuggle and QuickTime video engines, even on a 64-bit Windows machine. To see which Java VM you are running in, choose Help|About Java. The first line shows the Java version and bitness. Note: the 32-bit Java VM must be installed separately--for help, see Tracker Help: Installation.

Installing and upgrading: Windows

Download the installer file Tracker-4.xx-windows-installer.exe from ComPADRE or the Tracker home page. Double-click the file to run the installer.
Initial installation: install the Tracker application and options desired. We recommend you: (a) install the optional Xuggle video engine for maximum functionality and (b) accept the default installation paths for reliable upgrading and uninstallation.
Upgrade: choose the upgrade option offered by the installer. Note: if the installer cannot find the Tracker home directory, it will not offer an upgrade option even if you have previously installed Tracker. If this happens, you can overwrite the previous installation or uninstall the existing installation and reinstall from scratch.
Launch: choose the Tracker item in the Start Menu.

Installed files: Windows

In the Tracker home directory (Program Files\Tracker or Program Files(x86)\Tracker by default):
- Tracker.exe (this is really the "Tracker Starter"--see below)
- tracker.jar
- tracker-4.xx.jar
- tracker.ico
- trk.ico
- tracker_icon.png
- tracker_install.log
- Tracker_README.txt
- uninstall_Tracker.exe
- uninstall_Tracker.dat
- .tracker.prefs
- .tracker_starter.prefs
- xuggle-xuggler.jar
- logback-core.jar
- logback-classic.jar
- slf4j-api.jar

In the user home directory:
- .tracker.prefs
- .tracker_starter.prefs

In the Xuggle home directory (Program Files\Xuggle or Program Files(x86)\Xuggle by default):
- share/java/jars subdirectory

In the videos and experiments directory (My Documents\Tracker by default):
- experiments subdirectory
- videos subdirectory
- tracker_start.log (only after Tracker is launched)

In the Java runtime external library directory (lib\ext):
- xuggle-xuggler.jar
- logback-core.jar
- logback-classic.jar
- slf4j-api.jar

In the Start Menu Tracker directory:
- Tracker shortcut
- Uninstall Tracker shortcut

Environment variables set or modified:
- TRACKER_HOME (path to Tracker home folder)
- XUGGLE_HOME (path to Xuggle home folder)

Uninstalling: Windows

The uninstaller file "uninstall_Tracker.exe" is in the Tracker home directory (see Installed files). To run the uninstaller, double-click it. You can also run this uninstaller from the Add/Remove Programs control panel or by choosing the Uninstall Tracker menu item in the Start Menu.

If there is no uninstaller, you may uninstall the Tracker home directory, Xuggle home directory and other installed files by hand. However, this will not remove the environment variables TRACKER_HOME and XUGGLE_HOME nor the Windows registry entries.

Mac OS X (10.5+)

System requirements: OS X

You must run Tracker in a 64-bit Java 1.6+ VM to use the Xuggle video engine or a 32-bit Java VM to use the QuickTime video engine. To see which Java VM you are running in, choose Help|About Java. The first line shows the Java version and bitness. The Java VM installed by default with OSX can be used in both 32-bit and 64-bit modes; no separate installation is required.

Installing and upgrading: OS X

Download the zip file Tracker-4.xx-osx-installer.zip from ComPADRE or the Tracker home page. Double-click the file to extract the installer file Tracker-4.xx-osx-installer.app. Double-click the installer file to run the installer. Note: Mountain Lion and later OSX versions may require you to control-click the installer and choose Open from the popup menu rather than double-clicking.
Initial installation: install the Tracker application and options desired. We recommend you: (a) install the optional Xuggle video engine for maximum functionality and (b) accept the default installation paths for reliable upgrading and uninstallation.
Upgrade: choose the upgrade option offered by the installer. Note: if the installer cannot find the Tracker home directory, it will not offer an upgrade option even if you have previously installed Tracker. If this happens, you can overwrite the previous installation or uninstall the existing installation and reinstall from scratch.
Launch: double-click the Applications/Tracker.app file.

Installed files: OS X

In the Tracker home folder (hidden /usr/local/tracker by default):
- Tracker_README.txt
- tracker_install.log
- uninstall_Tracker.app
- .tracker.prefs (hidden file)
- .tracker_starter.prefs (hidden file)
- share folder (only if videos and experiments installed--see below)

In the Applications folder:
- Tracker.app (contains the following hidden folders and files)
- Contents folder containing files below:
- Info.plist
- MacOS folder containing files below:
- JavaApplicationStub
- Resources folder containing files below:
- tracker.icns
- trk.icns
- Java folder containing files below:
- tracker_starter.jar
- tracker.jar
- tracker-4.xx.jar
- symlink to XUGGLE_HOME/share/java/jars/xuggle-xuggler.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-core.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-classic.jar
- symlink to XUGGLE_HOME/share/java/jars/slf4j-api.jar

In the Xuggle home folder (hidden /usr/local/xuggler by default):
- share/java/jars subdirectory

In the videos and experiments folder (hidden /usr/local/tracker/share by default):
- videos folder containing video files
- experiments folder containing .trk experiment files

In the Java runtime external library directory (lib/ext):
- symlink to XUGGLE_HOME/share/java/jars/xuggle-xuggler.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-core.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-classic.jar
- symlink to XUGGLE_HOME/share/java/jars/slf4j-api.jar

In addition, if installed by a user rather than a superuser (root):

In the user home (~):
- .tracker.prefs (hidden file)
- .tracker_starter.prefs (hidden file)

In the user Documents folder (~/Documents):
- Tracker folder containing the files below:
- Tracker.app symlink
- tracker_start.log (only after Tracker is launched)
- tracker_home symlink to the Tracker home folder
- resources symlink to videos and experiments folder
- jars symlink to Tracker.app/Contents/Resources/Java folder

Environment variables set or modified (in ~/.profile, ~/.MacOSX/environment.plist, and /etc/launchd.conf):
- TRACKER_HOME (path to Tracker home folder)
- XUGGLE_HOME (path to Xuggle home folder)
- DYLD_LIBRARY_PATH (path to XUGGLE_HOME/lib folder)

Uninstalling: OS X

The uninstaller file "uninstall_Tracker.app" is in the Tracker home folder (/usr/local/tracker/ by default). You can also open this folder using the "home" symlink in ~/Documents/Tracker. To run the uninstaller, double-click it. Enter your password to complete the uninstallation.

Linux (tested on Ubuntu)

System requirements: Linux

There are separate installers for 32-bit and 64-bit Linux machines. You must run Tracker in a Java 1.6+ VM. To see which Java VM you are running in, choose Help|About Java. The first line shows the Java version and bitness.

Installing and upgrading: Linux

Open a Terminal window and type the command uname -a to determine if your Linux OS is 32- or 64-bit. If the output ends with "i386 GNU/Linux" or "i686 GNU/Linux" it is 32-bit; if it ends with "x86_64 GNU/Linux" it is 64-bit. (Note: other 64-bit architectures such as IA64 are not yet supported.)
Download the appropriate installer file Tracker-4.xx-linux-32bit-installer.run or Tracker-4.xx-linux-64bit-installer.run from ComPADRE or the Tracker home page.
Type sudo chmod 755 ~/Downloads/Tracker-4.xx-linux-yybit-installer.run (change xx and yy to the numbers for your installer) and enter your password to make the installer executable. Note: this and the next step assume the installer was downloaded to ~/Downloads/. If your download is different, change the command targets appropriately.
Type sudo ~/Downloads/Tracker-4.xx-linux-yybit-installer.run to run the installer.
Initial installation: install the Tracker application and options desired. We recommend you: (a) install the optional Xuggle video engine for maximum functionality and (b) accept the default installation paths for reliable upgrading and uninstallation.
Upgrade: choose the upgrade option offered by the installer. Note: if the installer cannot find the Tracker home directory, it will not offer an upgrade option even if you have previously installed Tracker. If this happens, you can overwrite the previous installation or uninstall the existing installation and reinstall from scratch.
Launch: double-click the Tracker launcher in Dash or in the ~/Documents/Tracker folder.

Installed files: Linux

In the Tracker home folder (/opt/tracker by default):
- tracker.jar
- tracker-4.xx.jar
- tracker_starter.jar
- Tracker_README.txt
- tracker_install.log
- tracker.desktop
- tracker.sh
- tracker_icon48.png
- trk_icon_48.png
- uninstall_Tracker
- uninstall_Tracker.dat
- .tracker.prefs (hidden file)
- .tracker_starter.prefs (hidden file)
- share folder (only if videos and experiments installed--see below)
- symlink to XUGGLE_HOME/share/java/jars/xuggle-xuggler.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-core.jar
- symlink to XUGGLE_HOME/share/java/jars/logback-classic.jar
- symlink to XUGGLE_HOME/share/java/jars/slf4j-api.jar

In the Xuggle home folder (/opt/xuggler by default):
- share/java/jars subdirectory

In the videos and experiments folder (/opt/tracker/share by default):
- videos folder containing video files
- experiments folder containing .trk experiment files

In the applications folder (/usr/share/applications):
- tracker.desktop

In addition, if installed by a user (i.e., using sudo) rather than a superuser (root):

In the user home (~):
- .tracker.prefs (hidden file)
- .tracker_starter.prefs (hidden file)

In the user Documents folder (~/Documents):
- Tracker folder containing files below:
- tracker.desktop
- tracker_start.log (only after Tracker is launched)
- tracker_home symlink to the Tracker home folder
- resources symlink to videos and experiments folder

Environment variables set or modified (at runtime for Tracker process only):
- TRACKER_HOME (path to Tracker home folder)
- XUGGLE_HOME (path to Xuggle home folder)
- LD_LIBRARY_PATH (path to XUGGLE_HOME/lib folder)

Uninstalling: Linux

The uninstall file "uninstall_Tracker" is in the Tracker home folder (/opt/tracker/ by default). You can also open this folder using the "tracker home" symlink in ~/Documents/Tracker. To run the uninstaller, open a terminal window and type "sudo /opt/tracker/uninstall_Tracker". Enter your password to complete the uninstallation. Note: the uninstaller requires the data file "uninstall_Tracker.dat" in the same folder to operate.

If there is no uninstaller, you may uninstall the Tracker home directory, Xuggle home directory and other installed files by hand.