Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/idahogurl/toggltojirasync

Takes time entries from Toggl (Task Timer) and adds them to work log of the corresponding Jira issue.
https://github.com/idahogurl/toggltojirasync

jira task-timer toggl

Last synced: about 1 month ago
JSON representation

Takes time entries from Toggl (Task Timer) and adds them to work log of the corresponding Jira issue.

Host: GitHub
URL: https://github.com/idahogurl/toggltojirasync
Owner: idahogurl
Created: 2015-05-07T03:29:50.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2023-01-06T16:27:16.000Z (almost 2 years ago)
Last Synced: 2023-02-26T22:56:12.062Z (almost 2 years ago)
Topics: jira, task-timer, toggl
Language: JavaScript
Homepage:
Size: 8.93 MB
Stars: 3
Watchers: 2
Forks: 0
Open Issues: 39
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

# Joggl Track

Takes time entries from [Toggl Track](https://toggl.com/track/) (Task Timer) and adds a corresponding work log in the matching [Jira](https://www.atlassian.com/software/jira) issue.

## Installers
- Windows (Coming Soon)
- [MacOS](https://app.box.com/s/fjy56xmcjorgm4d951tm8hdugc9juk3b)
- Linux (Coming Soon)

## Setup

### Toggl Track

1. Create a [Toggl Track](https://toggl.com/track/signup/) account

2. Click on your profile (bottom left)

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/toggl-profile-menu.png)

3. Click `Profile Settings`

4. Scroll down to find `API Token`

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/toggl-api-token.png)

5. Copy and paste this value to safe location

6. Install a `Toggl Track` app

- [Mobile](https://toggl.com/track/mobile-time-tracking-app/)

- [Desktop](https://toggl.com/track/toggl-desktop/)

- [Integrations](https://toggl.com/track/integrations/)

### Jira

1. Click on your profile (top right)

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/jira-profile-menu.png)

2. Click `Account settings`

3. Click `Security`

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/jira-profile-settings-sidebar.png)

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

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/jira-security-settings.png)

5. Click `Create API Token`

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/jira-token-create-1.png)

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

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/jira-token-create-2.png)

7. Click `Create`

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/jira-token-create-3.png)

8. Copy this value to safe location

### Joggl Track
1. After installation, open `Joggl Track`

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/initial-screen.png)

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

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/settings-panel.png)

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`

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/jira-display-name.png)

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](https://support.toggl.com/en/collections/1461333-tracking-time)

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.

![Toggl for MacOs screenshot](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/toggl-track.png)

_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.

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/date-range-pick.png)

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.

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/error-screen.png)

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

![](https://github.com/idahogurl/TogglToJiraSync/raw/master/web/images/time-entries.png)

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