# tracktime

> A CLI program allowing users to track time on various tasks directly from the command line.

- **URL:** https://github.com/sumnerevans/tracktime
- **Category:** time-tracking-cli-tools
- **Tags:** Open Source, Command Line, personal-use, Simple
- **Updated:** 2025-05-13 22:52
- **Canonical page:** https://timetrack.works/es/items/tracktime

## Details

# tracktime

A command-line interface (CLI) program for tracking time on various tasks, storing data in a simple filesystem-backed structure using CSV files.

- **Source:** [GitHub Repository](https://github.com/sumnerevans/tracktime)
- **Category:** Time Tracking CLI Tools
- **Tags:** open-source, command-line, personal-use, simple

---

## Features

- **Time Tracking:** Track time on tasks directly from the command line.
- **Filesystem-backed Storage:** Uses a structured directory system (YEAR/MONTH/DAY) to organize time-tracking CSV files for each day.
- **CSV Format:** All time tracking data is stored in CSV files, allowing for easy editing and backup.
- **Configuration File:** Supports a YAML configuration file (`~/.config/tracktime/tracktimerc`) for user settings, such as:
  - Full name (for reports)
  - Synchronization options
  - Editor and editor arguments
  - GitLab integration (API root and API key)
  - Table format for report export
  - Project rates (for calculating totals in reports)
  - Customer aliases and addresses (for reports)
  - External synchronizer files
  - Minimum daily work threshold (to filter out short workdays)
- **Report Generation:** Can generate reports from tracked data. Export to stdout or PDF (requires `wkhtmltopdf`).
- **External Service Sync:** Ability to sync tracked time with external services, such as GitLab, by pushing changes. (One-way sync only.)
- **Custom Synchronizers:** Supports importing third-party synchronizers.
- **Platform Support:** Installation via PyPi or Arch Linux AUR.

## Pricing

tracktime is open-source software and is free to use.

## Dependencies

- **wkhtmltopdf:** Required for report generation in PDF format.

## License

Open-source (see [GitHub Repository](https://github.com/sumnerevans/tracktime) for details).

---

_This Markdown mirror is generated by Ever Works for AI agents. The canonical HTML page is at https://timetrack.works/es/items/tracktime._