{"id":13580536,"url":"https://github.com/JoshMcguigan/timetrack","last_synced_at":"2025-04-06T02:31:52.042Z","repository":{"id":57669828,"uuid":"144803039","full_name":"JoshMcguigan/timetrack","owner":"JoshMcguigan","description":"Automatically track how you are spending your time by watching the file system","archived":false,"fork":false,"pushed_at":"2019-12-21T18:01:42.000Z","size":77,"stargazers_count":98,"open_issues_count":1,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-01T16:21:40.287Z","etag":null,"topics":["productivity","rust"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JoshMcguigan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-15T03:48:13.000Z","updated_at":"2025-02-12T11:58:42.000Z","dependencies_parsed_at":"2022-09-26T20:40:37.733Z","dependency_job_id":null,"html_url":"https://github.com/JoshMcguigan/timetrack","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoshMcguigan%2Ftimetrack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoshMcguigan%2Ftimetrack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoshMcguigan%2Ftimetrack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoshMcguigan%2Ftimetrack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JoshMcguigan","download_url":"https://codeload.github.com/JoshMcguigan/timetrack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247426109,"owners_count":20937067,"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":["productivity","rust"],"created_at":"2024-08-01T15:01:52.800Z","updated_at":"2025-04-06T02:31:51.671Z","avatar_url":"https://github.com/JoshMcguigan.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"# TimeTrack [![Build Status](https://api.travis-ci.org/JoshMcguigan/timetrack.svg?branch=master)](https://travis-ci.org/JoshMcguigan/timetrack)\n\nTimeTrack watches the file system to automatically track how much time you are spending on each of your projects. \n\n![screenshot](https://user-images.githubusercontent.com/22216761/45271448-f6c61380-b45b-11e8-9fb8-2485fff06a9a.png)\n\n## Setup\n\n### Install\n\nTimeTrack requires Rust in order to build/install. If you need to install Rust, follow [these instructions](https://www.rust-lang.org/en-US/install.html). Once you have Rust installed, TimeTrack can be installed by running the command below:\n\n```\ncargo install timetrack\n```\n\n### Configure tracking path(s)\n\nBy default, TimeTrack is configured to watch your home directory. You will likely want to reconfigure TimeTrack to watch whichever directory you use to store your projects. After installing TimeTrack, run `timetrack config` to find the `User configuration` file. Edit that file to configure TimeTrack to watch the appropriate directory (or directories if you have multiple, note that at this time TimeTrack does not support watching directories which are nested within one another). As an example, the full contents of my TimeTrack configuration file are `track_paths = [\"/Users/josh/Projects\"]`. After editing the configuration file, run `timetrack config` again to confirm the `Tracking paths` are displayed correctly.\n\n### Automatic startup\n\nThe `timetrack track` command starts TimeTrack in tracking mode. This should be running any time you want to track time. While you can manually start/stop this process, it is recommended that you configure your system to start this process automatically on startup. The specific steps to do this will depend on your OS. On OSX you can use `timetrack schedule` after TimeTrack has been installed to configure it to start tracking every time the current use logs in.  \n\n## Use\n\n```bash\n    # to start time tracking\n    timetrack track\n    \n    # to see the results\n    timetrack\n    \n    # to clear the tracking history\n    timetrack clear\n    \n    # to view the configuration\n    timetrack config\n    \n    # to configure TimeTrack to start tracking every time the current user logs in \n    # currently only supported on OSX\n    timetrack schedule\n    \n    # to disable TimeTrack from starting every time the current user logs in \n    # currently only supported on OSX\n    timetrack unschedule\n```\n\n## License\n\nLicensed under either of\n\n * Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)\n * MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)\n\nat your option.\n\n### Contribution\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any\nadditional terms or conditions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJoshMcguigan%2Ftimetrack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FJoshMcguigan%2Ftimetrack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJoshMcguigan%2Ftimetrack/lists"}