Tracker Home | Help | Share | OSP Home

Tracker logo

Installer Help

Contents

Windows:System RequirementsInstalling and upgradingInstalled FilesUninstalling
Mac OS X:System RequirementsInstalling and upgradingInstalled FilesUninstalling
Linux (tested on Ubuntu):System RequirementsInstalling and upgradingInstalled FilesUninstalling

Windows (XP+)

System requirements: Windows

Tracker comes with a bundled 64-bit JRE and Xuggle video engine. Tracker must run in a 64-bit JRE in order to use Xuggle.

Installing and upgrading: Windows

  1. Download the installer file Tracker-6.x.x-windows-x64-installer.exe from ComPADRE or the Tracker home page. Double-click the file to run the installer. Note: on Windows 8 you may need to run the installer as administrator by right-clicking and choosing "Run as administrator." Note: for some users on Windows 11, Microsoft Defender is blocking installation because it thinks it detects a virus. Here's a work-around: (a) right-click the downloaded installer and choose "Show more options", then "Scan with Microsoft Defender", (b) click on "Allowed threats", then "Protection history" (c) exempt the Tracker installer under "Actions." You should then be able to run the installer. Tracker is safe as long as the installer is downloaded from ComPADRE or the Tracker home page.
  2. Installation: install the Tracker application and options desired. We recommend you accept the default installation paths for reliable upgrading and uninstallation.
  3. Upgrades: when a new version is available, a notification is displayed on the toolbar. To upgrade, click the notification and choose Upgrade Now from the popup menu. For more information about the new version, choose Learn More. Most upgrades are instant: the new version or upgrade installer is downloaded and launched immediately. Some upgrades will require that you download a new installer from the Tracker website. Upgrades may include Tracker itself, Java, Xuggle and/or other components.

    4. Upgrade notification Upgrade notification button--click to show popup menu

  4. Launch: choose the Tracker item in the Start Menu.

Installed files: Windows

In the Tracker home directory (Program Files\Tracker by default):
- Tracker.exe
- tracker.jar
- tracker-6.x.x.jar
- tracker.ico
- trk.ico
- tracker_icon.png
- tracker_install.log
- Tracker_README.txt
- uninstall_Tracker.exe
- uninstall_Tracker.dat
- tracker.prefs.default
- tracker_start.log (only after Tracker is launched)
- xuggle-xuggler-server-all.jar
- logback-core.jar
- logback-classic.jar
- slf4j-api.jar
- 9.0.4-x64-jre subdirectory (bundled JRE)
- Xuggle subdirectory (video engine)

In the user home directory:
- tracker.prefs
- AppData\Local\OSP subdirectory with tracker.prefs and Cache subdirectory (only if the digital library browser has been accessed)

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

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

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 delete the Tracker home directory and other installed files by hand. However, this will not remove Windows registry entries.

Mac OS (10.7+)

System requirements: Mac OS

Tracker comes with a bundled 64-bit JRE and Xuggle video engine. Tracker must run in a 64-bit JRE in order to use Xuggle.

Installing and upgrading: Mac OS

  1. Download the file Tracker-6.x.x-osx-installer.dmg from ComPADRE or the Tracker home page. Double-click the file to mount and open the disk image with installer app Tracker-6.x.x-osx-installer.app. To run the installer file control-click it and choose Open from the popup menu. Tracker is safe as long as the installer is downloaded from ComPADRE or the Tracker home page.
  2. Installation: install the Tracker application and options desired. We recommend you accept the default installation paths for reliable upgrading and uninstallation.
  3. Upgrades: when a new version is available, a notification is displayed on the toolbar. To upgrade, click the notification and choose Upgrade Now from the popup menu. For more information about the new version, choose Learn More. Most upgrades are instant: the new version or upgrade installer is downloaded and launched immediately. Some upgrades will require that you download a new installer from the Tracker website. Upgrades may include Tracker itself, Java, Xuggle and/or other components.

    4. Upgrade notification Upgrade notification button--click to show popup menu

  4. Launch: double-click the Applications/Tracker.app file.

Installed files: Mac OS

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

In the Applications folder:
- Tracker.app (contains the following hidden folders and files)
Contents folder containing Info.plist, PkgInfo and the 5 subfolders below
Java subfolder containing files below:
- tracker_starter.jar
- tracker.jar
- tracker-5.x.x.jar
- Tracker.cfg
- xuggle-xuggler-server-all.jar
- slf4j-api.jar
- logback-core.jar
- logback-classic.jar
MacOS subfolder containing files below:
- libpackager.dylib
- Tracker (executable)
PlugIns subfolder containing Java.runtime (bundled JRE)
Resources subfolder containing files below:
- Tracker_README.txt
- Tracker.icns
- trk.icns
Xuggle subfolder (video engine)

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

In the application support folder (~/Library/Application Support/OSP):
- .tracker.prefs, osp.prefs, tracker_start.log

In the OSP cache (~/Library/Caches/OSP) (only if the digital library browser has been accessed):
- Search folder and multiple osp-xxx folders

In the user Documents folder (~/Documents):
Tracker subfolder containing Tracker.app (symlink) and tracker_start.log (only after Tracker is launched)
Tracker/videos subfolder containing video files
Tracker/experiments subfolder containing .trk experiment files

Uninstalling: Mac OS

The uninstaller file "uninstall_Tracker.app" is in the Tracker home folder (/usr/local/tracker/ by default). To run the uninstaller, double-click it. Enter your password to complete the uninstallation.

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

Linux 64 bit (tested on Ubuntu)

System requirements: Linux

Tracker comes with a bundled 64-bit JRE and Xuggle video engine. Tracker must run in a 64-bit JRE in order to use Xuggle.

32-bit Linux is no longer supported. To determine if your Linux OS is 32- or 64-bit, open a Terminal window and type the command uname -a. 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 supported.)

Installing and upgrading: Linux

  1. These instructions assume you are running the installer as a user (~), not as root. Installing as root is not recommended if Tracker will be used by others.
  2. Download the installer file Tracker-6.x.x-linux-64bit-installer.run from ComPADRE or the Tracker home page.
  3. Type sudo chmod 755 ~/Downloads/Tracker-6.x.x-linux-64bit-installer.run (change x.x to the number 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.
  4. Type sudo ~/Downloads/Tracker-6.x.x-linux-64bit-installer.run to run the installer.
  5. Installation: install the Tracker application and options desired. We recommend you accept the default installation paths for reliable upgrading and uninstallation.
  6. Upgrades: when a new version is available, a notification is displayed on the toolbar. To upgrade, click the notification and choose Upgrade Now from the popup menu. For more information about the new version, choose Learn More. Most upgrades are instant: the new version or upgrade installer is downloaded and launched immediately. Some upgrades will require that you download a new installer from the Tracker website. Upgrades may include Tracker itself, Java, Xuggle and/or other components.

    7. Upgrade notification Upgrade notification button--click to show popup menu

  7. Launch: double-click the Tracker launcher in Dash.

Installed files: Linux

In the Tracker home folder (/opt/tracker by default):
- tracker.jar
- tracker-5.x.x.jar
- tracker_starter.jar
- Tracker_README.txt
- tracker_install.log
- tracker_start.log (only after Tracker is launched)
- tracker.desktop (executable)
- tracker.sh
- tracker_icon48.png
- trk_icon_48.png
- uninstall_Tracker
- uninstall_Tracker.dat
- osptracker-mime.xml
- tracker.prefs.default
- xuggle-xuggler-server-all.jar
- logback-core.jar
- logback-classic.jar
- slf4j-api.jar
- share subfolder (only if videos and experiments installed)
- 9.0.4-x64-jre subfolder (bundled JRE)
- Xuggle subfolder (video engine)

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

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

In the user Documents folder (~/Documents or equivalent):
- Tracker subfolder containing files below:
- tracker_start.log (only after Tracker is launched)
- Tracker.app symlink
- tracker_home symlink to the Tracker home folder
- resources symlink to the videos and experiments folder (only if videos and experiments installed

In the user OSP configuration folder (~/.config/OSP):
- .tracker.prefs and osp.prefs
- Cache subfolder (only if the digital library browser has been accessed)

Uninstalling: Linux

The uninstall file "uninstall_Tracker" is in the Tracker home folder (/opt/tracker/ by default). 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 folder and other installed files by hand.