https://github.com/mild-blue/clockify-automation

Useful tools to make the most out of Clockify
https://github.com/mild-blue/clockify-automation

Last synced: 27 days ago
JSON representation

Useful tools to make the most out of Clockify

• Host: GitHub
• URL: https://github.com/mild-blue/clockify-automation
• Owner: mild-blue
• Created: 2021-01-01T20:09:12.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-12-17T13:09:01.000Z (about 1 month ago)
• Last Synced: 2024-12-17T14:22:11.066Z (about 1 month ago)
• Language: Python
• Size: 79.1 KB
• Stars: 0
• Watchers: 5
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Toggle to Clockify

It is based on https://github.com/pieye/toggl2clockify and significant part of the code is just copied from there.

Credits to Markus Proeller, [email protected].

## Setup

* Create virtual env: `python -m venv venv` and activate it: `. ./venv/bin/activate `.

* Install requirements: `pip install -r requirements.txt`.

* Set proper values in `config.json`, use `config_example.json` as a base.

* Run it: `python main.py`

## Configuration

- `ClockifyApiKey` - API key to your account in clockify

- `ClockifyAdminEmail` - email of the person you want to assign the time entries (usually your own email). Should be the

  same as in Toggle (otherwise the script has to be updated)

- `ClockifyWorkspace` - Clockify workspace

- `ToggleApiKey` - API key for Toggle

- `ToggleWorkspace` - Toggle workspace

- `ToggleFilterClient` - if you use a personal workspace and have just one client for all projects and want to filter by

  that one - fill the name, otherwise leave empty

- `ToggleFilterUser` - username of the user whose time entries we want to acces - to find it go to https://track.toggl.com/timer and click "profile" in th bottom left, its the name writen above your email

- `From` - from when start exporting the data in format `YYYY-MM-DD`

- `To` - end date for data export in format `YYYY-MM-DD`

- `DeleteExistingFrom` - if `true`, it deletes all entries from Clockify starting from the `From` date (*NOTE: that it even deletes

  entries with date `>= To`*)

- `DryRun` - if `true`, it does not export data to Clockify, just prints them to console

#### Example config

When your Clockify account is `[email protected]`, target clockify workspace is `Mild Blue` and source Toggle

workspace is `Personal` with client `Mild Blue` and user `[email protected]`.

```json

{

  "ClockifyApiKey": "xxxxxxxxxxxxxxxxxx",

  "ClockifyAdminEmail": "[email protected]",

  "ClockifyWorkspace": "Mild Blue",

  "ToggleApiKey": "yyyyyyyyyyyyyyyyyyyyyyyyyy",

  "ToggleWorkspace": "Personal",

  "ToggleFilterClient": "Mild Blue",

  "ToggleUser": "my toggl username",

  "From": "2021-01-01",

  "To": "2021-01-31",

  "DeleteExistingFrom": false,

  "DryRun": false

}

```