Data

Tools

Indexes

Applications

Experiments

Open Source Science

timetracker-csv

Pandas-friendly time tracking from the command line, repo by repo

https://github.com/dvklopfenstein/timetracker

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ✓
    DOI references
    Found 3 DOI reference(s) in README
  • ✓
    Academic publication links
    Links to: zenodo.org
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (17.3%) to scientific vocabulary

Keywords

cli cli-app cli-apps collaboration command-line command-line-app command-line-tool csv csv-export csv-reading history linux pandas pandas-dataframe productivity time-tracker time-tracking-tools timetracker timetracking
Last synced: 4 months ago · JSON representation ·

Repository

Pandas-friendly time tracking from the command line, repo by repo

Basic Info
Statistics
  • Stars: 4
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 24
Topics
cli cli-app cli-apps collaboration command-line command-line-app command-line-tool csv csv-export csv-reading history linux pandas pandas-dataframe productivity time-tracker time-tracking-tools timetracker timetracking
Created 11 months ago · Last pushed 4 months ago
Metadata Files
Readme Changelog License Code of conduct Citation

README.md

Timetracker-csv

Pandas-friendly time tracking from the CLI, repo by repo

PyPI - Version | DOI | License 

┌────────────────────────────┐
│ 🕒 Timetracker CLI Tool    │
│ Track time → CSV → pandas  │
└────────────────────────────┘

  • Track time spent on multiple projects, one repo at a time from the CLI

  • Time is saved in pandas-friendly plain text CSV files.

  • CSV files for each project can be combined into a single CSV file for analysis and plotting.

timetracker

Advantages

  • Freedom: Libre Software (aka open-source)
  • Simple: Quick to set up
  • Privacy: Own your data
  • Anti-stalking: No invasive tracking ever of keystrokes, browser activity, mouse-clicks, etc., as is done by multitudinous other timetracking apps
  • Human-and-machine-readable: ASCII data stored in CSV (comma-separated values) plaintext files:
    • Ready for pandas, the Python Data Analysis Library for tabular data
    • Editable using many editors, including vim and Notepad++
  • Flexible: Modify your data if you forget to log time
  • Quickview:
    • Current task being recorded
    • Elapsed time spent on the current task
  • No clicking and clicking and clicking on a GUI
  • Go off-line: No required use of the internet or cloud-based services
  • Data field support: Data supported for each time interval includes:
    • A required free-form descriptive message
    • An optional activity or type
    • Any number of optional tags
  • Plays nice: Export data for import by external time-tracking viewers

Quickstart

The name used by this time tracker is determined by the USER environmental variable by default.

1) Initialize a timetracker project

``` $ cd ~/projects/meetinghouse

$ trk init Initialized timetracker directory: /home/bez/projects/meetinghouse/.timetracker ```

2) Start the timer

$ trk start Timetracker started now: Mon 09:00 AM: 2025-03-24 09:00:00

3) Stop the timer

$ trk stop -m 'Received architectural plans' Timer stopped at Mon 2025-03-24 12:00:00 PM Elapsed H:M:S 0:03:00 appended to timetracker_meetinghouse_bez.csv

4) Report my time units for this project

$ trk report Day Date Span Total Description Sun 2025-03-24 03:00 03:00 Received architectural plans You can also get the total hours that you spent on a project: $ trk hours 0:03:00 H:M:S or 3.000 hours

Installation

Install with timetracker-csv pip: $ pip install --upgrade timetracker-csv Or install from source: $ git clone git@github.com:dvklopfenstein/timetracker.git $ cd timetracker $ pip install .

Other timetrackers

Copyright (C) 2025-present, DV Klopfenstein, PhD. All rights reserved

Owner

  • Name: DV Klopfenstein, PhD
  • Login: dvklopfenstein
  • Kind: user
  • Location: Philadelphia, PA, USA

Everyone is greedy for gain; Everyone practices deceit.

Citation (CITATION.cff) 

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "DV"
  given-names: "Klopfenstein, PhD"
  orcid: "https://orcid.org/0000-0003-0161-7603"
title: "Timetracker-csv"
version: 0.1a4
doi: 10.5281/zenodo.14803225
date-released: 2025-02-04
url: "https://github.com/dvklopfenstein/timetracker"

GitHub Events

Total
  • Release event: 20
  • Watch event: 3
  • Delete event: 5
  • Push event: 548
  • Pull request event: 122
  • Create event: 34
Last Year
  • Release event: 20
  • Watch event: 3
  • Delete event: 5
  • Push event: 548
  • Pull request event: 122
  • Create event: 34

Committers

Last synced: 5 months ago

All Time
  • Total Commits: 682
  • Total Committers: 1
  • Avg Commits per committer: 682.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 682
  • Committers: 1
  • Avg Commits per committer: 682.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
DVKlopfenstein d****n 682

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 4
  • Total pull requests: 127
  • Average time to close issues: 8 minutes
  • Average time to close pull requests: about 12 hours
  • Total issue authors: 1
  • Total pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 119
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 4
  • Pull requests: 127
  • Average time to close issues: 8 minutes
  • Average time to close pull requests: about 12 hours
  • Issue authors: 1
  • Pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 119
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • dvklopfenstein (1)
Pull Request Authors
  • dvklopfenstein (126)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 304 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 41
  • Total maintainers: 1
pypi.org: timetracker-csv

Pandas-friendly time tracking from the CLI

  • Versions: 41
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 304 Last month
Rankings
Dependent packages count: 9.7%
Average: 32.2%
Dependent repos count: 54.8%
Maintainers (1)
dklopfenstein
Last synced: 4 months ago

Dependencies

setup.py pypi
.github/workflows/pylint.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v3 composite
pyproject.toml pypi