Awesome
<div align="center"><img src="https://cloud.githubusercontent.com/assets/630550/19619834/43c460dc-9835-11e6-8652-1c8fff91cf02.png" alt="GTM Logo" height="115" width="275"></div> <div align="center"><font size=16><bold>Git Time Metric</bold></font></div>Seamless time tracking for all your Git projects
$ gtm report -last-month
<div><img src="https://cloud.githubusercontent.com/assets/630550/21582250/8a03f9dc-d015-11e6-8f77-548ef7314bf7.png"></div>$ gtm report -last-month -format summary
<div><img src="https://cloud.githubusercontent.com/assets/630550/21582252/8f85b738-d015-11e6-8c70-beed7e7b3254.png"></div>$ gtm report -last-month -format timeline-hours
<div><img src="https://cloud.githubusercontent.com/assets/630550/21582253/91f6226e-d015-11e6-897c-6042111e6a6a.png"></div> </br>GTM is automatic, seamless and lightweight. There is no need to remember to start and stop timers. It runs on occasion to capture activity triggered by your editor. The time metrics are stored locally with the git repository as Git notes and can be pushed to the remote repository.
<div align="center">Plugins</div>
Simply install a plugin for your favorite editor and the GTM command line utility to start tracking your time now.
<p><img src="https://cloud.githubusercontent.com/assets/630550/17458557/72247454-5bda-11e6-84ce-03364b8ac832.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458560/72397408-5bda-11e6-909c-c2dd2dad3b52.png" width="64" height="64"> <img src="https://user-images.githubusercontent.com/3669664/62366235-a39ef880-b526-11e9-9408-e549b5b12a46.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458562/7264e2be-5bda-11e6-8311-bbed672ffb8f.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458559/72302916-5bda-11e6-886e-2a41f423b06f.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458563/7264f06a-5bda-11e6-9fb6-d0469730c1cb.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458556/72030a62-5bda-11e6-89e4-6a3921034aed.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458564/727d43a4-5bda-11e6-8b3c-56d3fb7bf988.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458555/71e4352e-5bda-11e6-89d3-e8ff2c3a86e2.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458561/72417ac2-5bda-11e6-9769-04cffc64397e.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458591/82e06c98-5bdb-11e6-8ae0-c5b2bd2fe97f.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/17458558/72269342-5bda-11e6-8194-d9bf030bd037.png" width="64" height="64"> <img src="https://cloud.githubusercontent.com/assets/630550/19619987/f9f7523a-9838-11e6-99da-c3fda05ce0d6.png" width="64" height="64"></p>Getting Started
Install the latest GTM release
Mac OS X
The simplest way to install is to use Homebrew
brew tap git-time-metric/gtm
brew install gtm
Windows
- Download and run the Windows installer from here
Linux
The simplest way to install is to use Linuxbrew
brew tap git-time-metric/gtm
brew install gtm
Manually install for Linux, OSX or Windows
- Download and install the executable from here
Install a plugin for your editor
- Sublime 3
- Atom
- Vim
- IntelliJ IDEA, PyCharm, WebStorm, AppCode, RubyMine, PhpStorm, AndroidStudio
- VSCode
- Visual Studio
- Terminal
Initialize a project for time tracking
<pre>$ cd /my/project/dir $ gtm init Git Time Metric initialized for /my/project/dir post-commit: gtm commit --yes alias.fetchgtm: fetch origin refs/notes/gtm-data:refs/notes/gtm-data alias.pushgtm: push origin refs/notes/gtm-data notes.rewriteref: refs/notes/gtm-data terminal: true .gitignore: /.gtm/ tags: tag1, tag2 </pre>Edit some files in your project
Check your progress with gtm status
.
Commit your work
When you are ready, commit your work like you usually do. GTM will automatically save the time spent associated with your commit. To check the time of the last commit type gtm report
.
Optionally save time in the remote Git repository
GTM provides git aliases to make this easy. It defaults to origin for the remote repository.
Time data can be saved to the remote repository by pushing.
<pre>$ git pushgtm </pre>Time data can be retrieved from the remote repository by fetching.
<pre>$ git fetchgtm </pre>Getting Help
For help from the command line type gtm --help
and gtm <subcommand> --help
.
For additional help please consult the Wiki.
Contributing
If you find a bug or have an idea for a new feature please feel free to file new issues and submits PRs. In particular if there isn't a plugin for your favorite editor, go ahead and create one!
For more detail on how to write plugins, check out the Wiki.
Support
To report a bug, please submit an issue on the GitHub Page
Consult the Wiki for more information.