Skip to content

Time tracking with Toggl Track

To track time to a work package via a start and stop button, we offer an integration for the time recording software (or online timesheet software) Toggl Track (https://toggl.com/track/). The spent time will be saved in your Toggl account.

Please note that the Toggl integration is not developed by Nepenthes.

Installation

You can install a browser add-in to track time via Toggl Track in Nepenthes. This way, you can record spent times directly to a work package in Nepenthes via a start/stop button. You need to register an account at Toggl in order to use this feature.

This integration can be added for example for Google Chrome as Toggl Track extension and it also exists for Firefox.

Configuration

On the cogwheel of the Toggl Track extension you reach the Settings, from there chose Integrations.

For any other Nepenthes Domains you need to exactly add the Fully Qualified Domain Name (including subdomain) to the Custom URLs for Integration and chose OpenProject. For example: community.openproject.org (wildcards are not supported by Toggl Track at the moment of writing)

toggl-configuration-integrations-openproject

Track time from Nepenthes to Toggl Track

If this add-in is installed and the Integration URL is configured, a Start/Stop Timer button is displayed on the work package details view, which can be used to record times from Nepenthes into Toggl:

toggl button openproject work package detail view

Copy time entries from Toggl Track to Nepenthes

If you would like to use the times tracked in Toggl Track inside of Nepenthes, and you are a programmer, you are able to transfer the recorded times back to Nepenthes via the API if needed. Details can be found in our API documentation.

Alternatively you could also take a look at this simple open source ruby script which is not officially supported by Nepenthes GmbH. It selects time entries from Toggl Track via the Toggl Track API, accumulates the entries by date and saves them in Nepenthes via the Nepenthes API.