Skip to content
kaisentlaia edited this page Feb 27, 2021 · 16 revisions

Welcome to the Gerbil Time Tracker wiki!

About

Gerbil is a standalone personal time tracker that runs out of the box, no strings attached. It doesn't require accounts, logins and other nuisances.

If you want your task list stored on the cloud, you'll have to do it yourself: Gerbil will store data on your PC like any good old-fashioned desktop application.

Interface

Gerbil aims to be minimalist and easy to use.

Gerbil main window

The main and only window is divided in several areas, from top to bottom:

  • controls: controls and toggles
  • active task: the active task's name and the stop button
  • new task: field to input a task name and the button to start/switch task
  • task list: list of the tasks belonging to the selected day
  • totals: an overview of the totals for the day

Installation

To install Gerbil head over to the Releases Page and download the appropriate version for your OS.

Tray icon

When closing or minimizing the window, Gerbil will keep running in the background. To exit the application, click on the tray icon and select "Quit". To reopen the window, select "Open".

Tray icon example

Usage

Tasks

Starting a new task

When the window opens the new task field will be automatically focused. Just begin writing and then either click on the green start button or press enter to begin tracking.

Typing the name of a new task

Stopping the tracker

Clicking on the red stop button next to the current task name will stop tracking for that task.

Task running

Switching to a different task

Typing a new task name and either clicking on the switch task button or pressing enter will stop tracking for the current task and begin tracking the new task.

Switch to new task Task switched

Resuming a previous task

After typing something on the new task field, if any other previously tracked task matches that string a dropdown will be displayed. Clicking on the desired entry or selecting it with the arrow keys and then pressing enter will resume that task instead of creating a new one.

Resume a previous task

Task list

The task list displays all the task tracked in the selected date. Through the task list it's possible to edit and delete previously tracked tasks.

Editing a task

To edit select it using tab and press enter or double click the task to open the editing form. Change the values as desired then press Save.

Task selected Task editing

Deleting a task

To delete a task select it using tab and press delete, or double click the task and then press Delete.

Totals

The totals overview displays all the current date's tasks and their totals. The totals are displayed in hours and rounded to the quarter.