SlothTracker is one of the few time tracking applications that supports
keyboard heavy workflow. Everything that could be done with a mouse is one
|Windows, Linux||Control (CTRL)|
|Mac||Command (CMD or CTRL)|
You can see the bound keys in every dialog by holding down a
META key for 2 seconds. The keyboard
shortcuts will appear on the screen for every possible action that you can perform on that
MAC: holding down CMD key does not display the keyboard shortcuts, but the keyboard actions are still working fine. For displaying the shortcuts you can hold down CTRL key instead.
MAC: a bug in the GUI framework causes the application to crash on dialog confirm action when META+ENTER is pressed. Until this bug is fixed upstream, dialogs confirm actions are triggered via Option+ENTER. The rest of keyboard actions are still handled via META+KEY keyboard shortcuts. You can check the [bug report](“https://bugs.openjdk.java.net/browse/JDK-8242544") for more info.
Mac specifics are in parenthesis.
|ESC||Close any open dialog or dropdown selection menu|
|META+ENTER (Option+ENTER)||Confirm action in the dialog and close the dialog if possible. In case a dropdown menu is opened, the currently focused row will be chosen and the dropdown menu closed.|
|META+SPACE||Reopen suggestions dropdown menu (works only on text fields that offer suggestions)|
|META+T||Focus the main table in the dialog|
|META+I||Focus the main input text field in the dialog|
If the table supports the keyboard actions, the following are the common keyboard shortcuts:
|M||Open the context menu (simulate right mouse click)|
|ENTER||Execute appropriate action (open dialog, toggle visibility)|
|DELETE||Delete the row/task|
|META+I||Focus main input text field|
|META+S||Start/stop tracking current task|
|META+T||Focus task table|
|META+N||Create a new task|
|META+O||Open the task overview dialog|
|ENTER (table)||Edit selected task|
|META+ENTER (table)||Start tracking the currently selected task in table|
|META+I||Focus main input text field|
|META+W||Focus start time field|
|META+E||Focus end time field|
|META+R||Focus total time field|
|META+S||Focus start date field|
|META+D||Focus end date field|
|META+F||Toggle still running checkbox|
|META+G||Focus description text area|
|ALT+T||Execute ‘Time’ click (see SlothTracker secrets section)|
|ALT+O||Execute ‘to’ click (see SlothTracker secrets section)|
The commonly keyboard shortcuts in edit task dialog are picked in a way that you can trigger them with the right hand only.
Since there are a lot of keyboard shortcuts, they are not all listed here. In order to see what is possible, focus the dialog and hold down a META key for 2 seconds. If the dialog supports shortcuts, they will be displayed on the the dialog.
All dialogs support positive action shortcut (META+ENTER) and cancel action shortcut (ESC). For common/general keyboard shortcuts see the first table in this section.
SlothTracker 1.5.0 does not support custom shortcut/action key assignments. This feature will be added in the future.
The Overview dialog supports searching for the stored tasks, either via search field or the search dialog (triggered by the button next to the search field).
|title, task, tasks, t||title: bugfixing|
|project, projects, p||project: SlothTracker|
|description, desc, d||desc: bug|
|from, start, s||from: 2020-01-10|
|to, end, e||to: 2020-02-20|
You can drill down for the specific task by using the search fields. For example:
This query will search for all tasks that have a title set to “bugfixing” or “improvements. If you only want to search between the task titles, you don’t need to specify the search field.
title: bugfixing; project: SlothTracker; from: 2020-02-20
This query will search for all tasks that are named “bugfixing” and were stored under the project “SlothTracker” that were started after or equal to 2020-02-20.
t: bugfixing,search; p: SlothTracker,features; to: 2020-02-20
This query will search for all tasks for which the following is true:
Alternatively instead of typing the query and specifying search fields manually, you can use a search dialog which generates the search query for you. You can specify multiple terms for the same field by separating them with a comma (,).
Wildcard allows you to find part of the written term in a special task field. Supported wildcard fields are:
This query will find all tasks whose title’s starts with a “bug”, such as “bugfixing”.
This query will find all tasks that contains keyword “bug” in their titles, such as “obnoxious bugs”.
This query will find all tasks with 4 character titles, such as task or talk.
It is possible to import existing tasks from the following time tracking applications:
Export tracked time in a specified format and use File/Import tasks menu option to import the tasks from the file to launch a time importing dialog
If your software is not listed above you can also import tasks from a .csv file that contains data in a SlothTracker format. Mandatory header fields of the .csv file (order does not matter):
Reference SlothTracker .csv file is shown below:
Task, Project, Description, StartTime, EndTime lunch,Overhead,,2020-01-29T15:00:00+01:00,2020-01-29T16:00:00+01:00 bugfixing,SlothTracker,,2020-01-29T16:00:00+01:00,2020-01-29T18:00:00+01:00 general improvements,SlothTracker,"added task rename dialog, fixed an issue in the edit task dialog",2020-01-29T20:00:00+01:00,2020-01-29T21:40:00+01:00 server administration,SlothTracker server,deploying new server version,2020-01-29T21:40:00+01:00,2020-01-29T22:00:00+01:00
SlothTracker is storing application specific files in the standard application directories depending on the platform.
Application files are:
Backup: If you are trying to create a backup of your tracked time
database, simply copy the
timetrackerDB.db file from RoyalSloth configuration directory (see previous
section for the directory location).
Restore: If you would like to restore your tracked time from the backups. simply replace the current database file (see previous section for the directory location) with the backup database file.
Clicking on a ‘Time’ label will set starting time of the edited task to the ending time of the previous task. It’s a good way to avoid the gaps between the tasks.
Clicking on ‘to’ label (on the right of the starting time field) will stretch the ending time of the edited task, to the starting time of the next task for that day.
Alternatively you can execute the ‘Time’ and ‘to’ actions via keyboard by holding ALT key and pressing the underlined character.
Prerequisites: Make sure you have at least JRE 11 installed.
Windows, Mac: For running the jar use the following command:
java -jar SlothTracker.jar
Linux: there is a known issue within the tray library that prevents application from running without specifying the GTK version. For running the jar use the following command:
java -Djdk.gtk.version=3 -jar SlothTracker.jar
If you are using KDE, make sure to install: