{"id":21900883,"url":"https://github.com/phts/time-tracker","last_synced_at":"2025-07-16T17:34:03.634Z","repository":{"id":72737527,"uuid":"50427713","full_name":"phts/time-tracker","owner":"phts","description":"Track your working time","archived":false,"fork":false,"pushed_at":"2017-11-21T15:25:06.000Z","size":35,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-22T06:15:26.174Z","etag":null,"topics":["generic-monitor-plugin","notifications","office","screen-lock","teamviewer","time-tracking"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-01-26T12:36:46.000Z","updated_at":"2021-01-19T18:08:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"f8cb60cb-200a-4bea-8701-4117fb6e6dd6","html_url":"https://github.com/phts/time-tracker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/phts/time-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phts%2Ftime-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phts%2Ftime-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phts%2Ftime-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phts%2Ftime-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phts","download_url":"https://codeload.github.com/phts/time-tracker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phts%2Ftime-tracker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265527598,"owners_count":23782480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["generic-monitor-plugin","notifications","office","screen-lock","teamviewer","time-tracking"],"created_at":"2024-11-28T15:11:14.289Z","updated_at":"2025-07-16T17:34:03.609Z","avatar_url":"https://github.com/phts.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Working Time Tracker\n\nA simple script to track how much time you spend near the computer in the office.\n\n## Requirements\n\nThe script uses `xscreensaver-command -watch` output so `xscreensaver` is required as a screen locking framework.\nNotifications are shown by `notify-send`.\nAnd [Ruby](https://www.ruby-lang.org/en/) (tested on v2.2.3) is needed to be able to run the script.\n\nAlso it assumes that you do not work at nights and do not turn off your PC.\n\nBefore first run all dependencies should be installed:\n\n    bundle install\n\n## Usage\n\nThis script should be run during the whole session so it can be executed from *.profile* file or as a service.\n\nTo run the script from terminal emulator:\n\n    time-tracker ~/time.txt\n\nIt generates a report file (in this case *~/time.txt*), for example:\n\n    11.01    Started: 09:34    Finished: 17:35    Delta: 08:00    Total per week: 08:00\n    12.01    Started: 10:35    Finished: 18:29    Delta: 07:54    Total per week: 15:54\n    13.01    Started: 09:01    Finished: 17:20    Delta: 08:19    Total per week: 24:13\n\nAlso it creates a file (*~/time.txt.current*) which contains working time for the current day.\nYou can use this file wherever you want.\nAnd it is used by Generic Monitor plugin.\n\nFor more information about options:\n\n    time-tracker --help\n\n## Generic Monitor plugin\n\nAdditionally the script can be used with [dnschneid/xfce4-genmon-plugin](https://github.com/dnschneid/xfce4-genmon-plugin) to display a progress bar on the panel.\n\n    time-tracker --genmon ~/time.txt\n\n## Notification\n\nThere is a notification if you have already been 8 hours at the office - it's time to go home.\n\n## TeamViewer\n\nThis script doesn't treat TeamViewer sessions as working time.\nSo any screen lock/unlock under TeamViewer will be ignored and will not be taken into account.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphts%2Ftime-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphts%2Ftime-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphts%2Ftime-tracker/lists"}