Toggl-to-clockify NPM

Toggl to Clockify

CLI tool to load Toggl data into Clockify.

DEPRECATION NOTICE!

I'M NO LONGER SUPPORTING THIS TOOL. I'VE REDIRECTED MY EFFORTS TOWARDS THE WEB VERSION

The web version will be undergoing beta testing soon (week of April 22nd), I'll provide a link to the hosted tool here as soon as it's ready.

I'm aware that the tool currently doesn't work, but at this point fixing it would take some serious effort. Don't worry though, you won't need to wait long!

Functionality

Transfers the following entities from Toggl to Clockify:

Projects
Clients
Time Entries
Tags

It creates these entities in Clockify if they don't already exist

Disclaimers and Notes (PLEASE READ!)

This will transfer ALL entries from Toggl to Clockify from the workspaces and years specified in the config file
There are NO checks for pre-existing entries, so if you try running it multiple times, it will create duplicate entries
- I plan to add a check in the future, but for now that's the way the cookie crumbles
If you're starting with a fresh Clockify account, you can always leave the workspace to delete all entries and recreate

Installation

npm

$ npm install -g toggl-to-clockify

Yarn

yarn global add toggl-to-clockify

Prerequisites

Node.js >= v10.3.0 (uses Async Iterators)
Toggl API token
Clockify API key

Instructions

Run the command toggl-to-clockify init with an optional output path using the -o flag to generate a configuration file
- If you don't specify -o, a new file named t2c.json will be placed in the current working directory
Populate the email, togglApiToken, clockifyApiToken fields
For the workspaces field, specify an array of objects that match this format:
```
{
  "name": "Toggl Workspace Name",
  "years": [
    2016,
    2017
  ]
}
```
Note: The name is the name of the Workspace from Toggl you wish to copy, the years is an array of years to include in the transfer
Before initializing the transfer, you must create the workspaces on Clockify with the same name as Toggl (you can always change them later)
Run the command toggl-to-clockify transfer to perform the transfer

Commands

`init`

Creates configuration file for specifying API keys and workspaces

Flags

Option	Alias	Req'd	Description
`--output`	`-o`	No	Output path to the configuration file

`transfer`

Transfers projects from Toggl to Clockify

Flags

Option	Alias	Req'd	Description
`--config`	`-c`	No	Path to the populated configuration file

`write`

Fetches data from API and writes a to JSON file, this is just for giggles, in case you were interested in what currently exists for either tool

Flags

Option	Alias	Req'd	Description
`--tool`	`-t`	Yes	Tool to get data for (`toggl` or `clockify`)
`--config`	`-c`	No	Path to the populated configuration file
`--output`	`-o`	No	Output path for the JSON file (default is current working directory)