TogglTrack Data Extractor

Automate and streamline the process of manually transferring time tracking data from TogglTrack to your company's timesheet software.

Table of Contents

• Overview
• Features
• Getting Started
  • Setup
  • Configuration
  • Usage
• Contributing
• Acknowledgements
• License

Overview

TogglTrack Data Extractor is a Node.js script designed to simplify the process of manually entering time tracking data from TogglTrack into your company's timesheet software. It fetches time entries from your TogglTrack account, processes them, and organizes them into two formats: raw and approximate. This script is particularly useful when your timesheet software lacks automated integration with TogglTrack.

Features

• Fetches time entries from TogglTrack for the last 30 days.
• Processes time entries, rounding and adjusting durations as needed.
• Organizes time entries into raw and approximate (rounded to 0.25h) formats.
• Supports a blacklist to exclude specific entries from calculations, such as (lunch) breaks.

Getting Started

Setup

1. Install Node.js on your system.
2. Clone this repository or download the latest release and extract it.
3. Open a terminal or command prompt in the project directory and run npm install to install the required dependencies.

Configuration

1. Create a key.json file in the project directory with your TogglTrack API token:

{
  "TOGGL_API_TOKEN": "YOUR_API_TOKEN_HERE"
}

2. To exclude specific time entries from hours worked calculations, add keywords or phrases to the blacklist.txt file in the project directory. Each keyword or phrase should be on a separate line. Entries will be excluded from the calculation if their descriptions start with any keyword or phrase listed in the blacklist.

Usage

1. Run run_script.bat to start the script.
2. The script will fetch TogglTrack time entries, process them, and generate text files in the 'timesheets/raw' and 'timesheets/approx' directories.

Contributing

Contributions to this project are welcome! Feel free to open issues or pull requests to improve the script or its documentation.

Acknowledgements

This project may use code and resources generated with the help of external sources such as Bing Chat and ChatGPT.

License

This project is licensed under the GNU GPLv3 License. See the LICENSE file for details.