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: over 1 year 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 (about 11 years ago)
- Default Branch: master
- Last Pushed: 2023-01-06T16:27:16.000Z (over 3 years ago)
- Last Synced: 2025-01-13T05:42:45.493Z (over 1 year ago)
- Topics: jira, task-timer, toggl
- Language: JavaScript
- Homepage:
- Size: 8.93 MB
- Stars: 3
- Watchers: 3
- 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)
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](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)
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](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.
_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