wakatime-to-toggl
Version:
Send your WakaTime data to Toggl
91 lines (68 loc) • 3.82 kB
Markdown
# WakaTime to Toggl
[](https://github.com/bokub/wakatime-to-toggl/actions/workflows/run.yml?query=branch%3Amaster)
[](https://github.com/bokub/wakatime-to-toggl/releases)
[](https://www.npmjs.com/package/wakatime-to-toggl)
[](https://github.com/bokub/prettier-config)
Automatically import your [WakaTime](https://wakatime.com/) data into [Toggl](https://toggl.com/)
- Works with free accounts
- Can be automated with GitHub Actions
<p align="center">
<img width="639" height="238" src="https://user-images.githubusercontent.com/17952318/90114480-10acb700-dd53-11ea-9c67-5700705214e5.gif">
</p>
## Prerequisites
- Get your WakaTime API key in [your settings](https://wakatime.com/settings/api-key)
- Get your Toggl "API Token" at the bottom of [your profile page](https://track.toggl.com/profile)
## Option 1 - Run manually on your computer
1. Download and install [Node.js](https://nodejs.org/en/download/)
2. Install **wakatime-to-toggl** with `npm i -g wakatime-to-toggl`
3. Run the following command to sync data from yesterday: `wakatime-to-toggl -w <wakatime-api-key> -t <toggl-api-key>`
4. Ideally, run **wakatime-to-toggl** everyday
## Option 2 - Run automatically everyday using GitHub Actions
1. Fork this repository
2. From your new fork, go to **Settings > Secrets and variables > Actions**
3. Add the following secrets using the **New repository secret** button:
- `TOGGL_API_KEY`: Your Toggl API Key
- `WAKATIME_API_KEY`: Your Wakatime API Key
4. Go to the **Actions** tab of your fork
5. Click **set up a workflow yourself**
6. Copy-paste this workflow:
```yaml
name: Run wakatime-to-toggl everyday
on:
workflow_dispatch:
schedule:
- cron: 30 2 * * * # Everyday at 02:30 AM UTC. You can change it according to your timezone
jobs:
run:
runs-on: ubuntu-latest
steps:
- uses: actions/setup-node@v6
with:
node-version: 24
- run: npx wakatime-to-toggl -w "$WAKATIME_API_KEY" -t "$TOGGL_API_KEY"
env:
TOGGL_API_KEY: '${{ secrets.TOGGL_API_KEY }}'
WAKATIME_API_KEY: '${{ secrets.WAKATIME_API_KEY }}'
```
7. Click **Commit changes** then **Commit changes** to save
That's it! **wakatime-to-toggl** will run every day at 2:30 AM UTC (unless you changed it in the workflow)
You can come back to the **Actions** tab later to see the logs
## Things to know
- Entries shorter than 2 minutes will be ignored. This duration is configurable
- Duplicate entries won't be added if they are detected
- Projects will be created in your default workspace. You can move them to another workspace if you want
- Time entries will be created with a default description ("Development"). You can edit it, it won't break duplicates detection
- Archived toggl projects will be automatically unarchived. You can instead choose to ignore them using the `--skip-archived` option
## Detailed usage
```bash
$ wakatime-to-toggl --help
Usage
$ wakatime-to-toggl -w <wakatime-api-key> -t <toggl-api-key>
Options
--wakatime, -w Your Wakatime api key
--toggl, -t Your Toggl api key
--day, -d The day to fetch. 0 is today, 1 is yesterday... Default: 1
--min-duration -m Minimum duration (in seconds) of entries to sync. Default: 120
--skip-archived -s Skip archived Toggl projects. Default: false
```