TimeTracker Documentation

1. Program Description

TimeTracker is a client application for tracking work time and correspondent data. TimeTracker allows you to monitor work time, opened apps, screenshots, and webcam shots (depending on the settings). The Employer can view this data in his or her personal account on the site. The app supports multiple projects and employers (clients).

Important! Though the program is dubbed TimeTracker, it is actually installed as EmployeeAgent. This is the name of the module that directly interacts with the employee.

Employers views statistics of their employees by accessing the timevizor.com acccount through any browser. Here is where you manage your projects, employees, and all preferences, and view work statistics. The employee also can (but not obliged to) view their work reports by signing up. However, the registration is voluntary for employees.

TimeTracker is an app for employees only! Employers do not need it. So we assume that this documentation is read by employees.

2. Installation

Before installation, please make sure you have a license to work.

A license is a .gz file containing all information on the employee’s control mode. The license is generated by your employer on the site and limits data transfer between the app and the server to the data specified by your employer.

2.1. Installation on Windows

Before download, please make sure all OS updates have been installed. If you cannot install them due to some reason, install only this update from the Microsoft website.

Now just download the installation file from timevizor.com corresponding to the operating system and architecture of your computer (version Windows XP or Windows 7 for OS Windows 7 and higher; 32 or 64 bit).

If during installation you encounter a runtime error, please install this update from the Microsoft website.

2.2. Installation on Ubuntu

  • With root rights:

    • Install:

      sudo apt-get install ./TimeTracker-Ubuntu14-X86_64-0.7.80.deb

    • Deinstall:

      sudo apt-get remove TimeTracker

  • Without root rights into the home folder:

    • Install:

      mkdir /home/[USERNAME]/TimeTracker

      sudo dpkg –install –instdir=/home/[USERNAME]/TimeTracker ./TimeTracker-Ubuntu14-X86_64-0.7.80.deb

    • Deinstall:

      sudo dpkg –remove TimeTracker

2.3. Installation on CentOS (Red Hat)

  • With root rights:

    • Install:

      sudo yum localinstall TimeTracker-CentOS7-X86_64-0.7.81.rpm

    • Deinstall:

      sudo yum remove TimeTracker

  • Without root rights into the home folder:

    • Install:

      rpm –install –prefix=/opt/TimeTracker ./TimeTracker-CentOS7-X86_64-0.7.81.rpm

    • Deinstall:

      rpm –erase TimeTracker

2.4. Installation on OS X

Just download the installation file from timevizor.com and install it. Important: you have to allow the app to control your computer, otherwise it won't be able to record keyboard activity. Unless this wasn't done during installation process, you can do so later: just open in your operating system SettingsSecurity & PrivacyAccessibility and check the box against EmployeeAgent.app.

2.5. Downloading License

When installing TimeTracker, you will be prompted to download your license. Click on the button Browse and locate the license file on your computer. After installation is complete, it is recommended to check the boxes Create a desktop shortcut and Add a shortcut to the start menu for quick access.

It is very important to download the valid license when installing TimeTracker. If you failed to do so due to some reasons, you can just copy the file into the user folder on your computer. It varies for different operating systems:

  • Windows:
  • Linux:

Please note that an employee does not have to enter any passwords or sign up in any way to work in TimeTracker. All the identifying information is stored in the license file alone.

2.6. Installing OSIC Browser Extension

If you have browsers Google Chrome or Mozilla Firefox installed, you need to install the OSIC extension for this browser. To do this, please open the following link:

Reboot the browser after OSIC installation.

Important! You have to install OSIC even if you do not use the corresponding browser. For example, if you have Chrome installed, but you prefer Edge, you still have to install OSIC for Chrome.

3. Work in the App

You can fine-tune EmployeeAgent according to your needs by means of settings under the Tools menu with self-explanatory titles.

3.1. Settings

You can adjust TimeTracker according to your preferences using the settings in the menu Tools with self-explanatory captions:

  • Language – Select a language convenient to you. Russian and English are currently supported.
  • Interface – Check the box Start in tray if you want the app to automatically minimize to the system tray upon launch.
  • Records – Choose the host and port if needed. By default, they are timevizor.com and 80 respectively. The checkbox Save to disk allows for saving records’ copies locally on your computer, and the field Limit to keep lets you specify how many last records will be stored locally (these two options do not affect the number of server-hosted records).
  • Trace – Debugging log. Select the depth of tracing and the number of log files saved to disk. This is generally only needed for debugging purposes, and most of the time you will need to activate it only when asked by the developers.

3.2. Time Tracking for Employee

You can track your work time in two ways:

  1. In the main program window (tab Contacts) – Right-click on the project you need and select Start tracking. After the work ended, click Stop tracking in the same way. You can also add an optional work note for your employer to see in this context menu.
  2. In your operating system tray – Right-click on the EmployeeAgent icon and select Start tracking → Project name. After the work ended, you need to stop tracking in the same context menu or just close the app.
  3. When starting tracking, you can post a note that will be displayed in your employer's reports. This is a good way to show what you are working on at the moment. You can also set up automatic reminder about its update through the drop-down menu Review after. Choose an interval between 10 minutes and 2 hours to make the window pop-up each time this period of time passes or Never to disable this behaviour.

3.3. Data Collection

As you work in TimeTracker, data about your activity is collected on your computer (if enabled in the settings). The default saving path for Windows is the following:


However, settings and data of the app itself are saved in the folder C:\Program Files (or C:\Program Files(86) if you install a 32-bit version on 64-bit architecture).

The sub-folders are:

  • cache – Cache data (cached files).
  • crashes – Reports about malfunction of the app.
  • data – Monitored data if the setting “save to disk” enabled or data postponed for further forwarding due to error.
  • etc – Settings from the file setting.xml.
  • log – File logging program events.
Get your 15 days trial for free