Joggl Track

Takes time entries from Toggl Track (Task Timer) and adds a corresponding work log in the matching Jira issue.

Installers

• Windows (Coming Soon)
• MacOS
• Linux (Coming Soon)

Setup

Toggl Track

1. Create a Toggl Track account

2. Click on your profile (bottom left)

3. Click Profile Settings

4. Scroll down to find API Token

5. Copy and paste this value to safe location

6. Install a Toggl Track app

   • Mobile

   • Desktop

   • Integrations

Jira

1. Click on your profile (top right)

2. Click Account settings

3. Click Security

4. Click Create and manage API tokens (last section)

5. Click Create API Token

6.Enter a value to label the token (Example: Toggl-To-Jira)

7. Click Create

8. Copy this value to safe location

Joggl Track

1. After installation, open Joggl Track

2. Click the Settings icon in the left side menu to open the settings panel

3. Copy and paste the API tokens you obtained from Toggl and Jira

4. Enter the name shown in the Jira profile menu for the User Display Name

5. Click Save

How To Use

Toggl Track

The input and button locations are dependant on the Toggl Track app you choose. The core steps below are the same. Further instructions for using Toggl Track are found in its help guide

1. When you begin work on a Jira issue, open your Toggl Track app.

2. Enter the Jira issue key as the entry title. Without this value Joggl Track will not work properly.

3. Click the Start button (arrow icon)

4. Click the Stop button (square icon)

5. Now you have created a time entry.

Screenshot of Toggl for MacOS

Joggl Track

1. Once you save the settings, click on the Date Range input.

2. Click on one date for the Start date and then later date for the End date. You can manually enter the dates (YYYY-MM-DD) instead.

3. Click View Entries

4. If you get an error, first check you have entered the correct setting values. Most likely your Jira connection settings are incorrect. Contact your Jira administrator for help.

5. If any entries in Toggl exist for that date range, you will see a list of entries.

6. Entries already saved in Jira will have the Sync field show Yes

7. You have the option to Check All or Check each entry you wish to save to Jira.

8. Click Sync

Contributing

If you have suggestions for how this program could be improved, or want to report a bug, open an issue! I'd love all and any contributions. If you are interested in contributing to the project, check out the Contributing Guide.

Credits

Setting icon provided by 365 Vectors by Vecteezy