2010-10-16

GitMon - the git repository monitor

Dozens of git repositories? Want to know what's happening?

If you are actively using git (which you should, because it's awesome), you may have looked for a way to get those nice popup notifications when something is pushed to remote origin. When you have dozens of repositories to work with, it may get annoying to go through all of them and check for updates. I haven't found anything mature and worth using, so I decided to get my hands dirty...

And finally, after many joyful hours of coding... Meet GitMon - an open source git monitoring tool. Here's how it looks like:

You may have noticed that it's a typical Growl notification. GitMon can also be configured to use libnotify-bin on Linux and there is Growl for Windows which may do the job (I haven't tried that yet though).

GitMon Features (0.1.6):

• Configurable notifications via command-line tools (growlnotify, notify-send, ...)
• Scheduling via standard tools (like crontab)
• Support for multiple git repositories
• Possibility to give repositories custom names
• Possibility to notify about new branches
• Possibility to notify about new tags
• Configurable limit of new commits in notification
• Configurable limit of file details in notification
• Possibility to perform 'git pull' automatically
• Variables in configuration file
• Recursive file system scanning for repositories (configurable roots)

Installing GitMon

If you're willing to try it, there is no "next", "next", "finish" installation so far, so you will have to do this (shouldn't be too difficult to do for any developer):

1. Clone the repo:
Fire up the terminal and go where you want 'gitmon' dir to appear. Then do:
git clone git://github.com/spajus/gitmon.git

2. Add gitmon to path:
You may want to put this in your ~/.profile:
export PATH="$PATH:/path/to/gitmon"

3. Make sure you have growlnotify (Mac) or notify-send (Linux).
You can install notify-send command easily:
apt-get install libnotify-bin

4. Set up the configuration:
cp gitmon.conf.example ~/.gitmon.conf
Then edit ~/.gitmon.conf to suit your needs.

5. Make sure you have Python 2.6+ and GitPython:
python --version
easy_install gitpython

6. Test if your gitmon.conf works:
gitmon -v
A good output may look something like this:
GitMon v0.1.5
Loading configuration from /Users/tomasv/.gitmon.conf
Tracking repo: "GitMon Repo" at ~/Development/python/gitmon
Checking repo: GitMon Repo

7. Configure crontab:
crontab -e
Example:
#git must be in cron's path!
PATH=/usr/local/bin:/usr/bin:/bin
#check for repo updates every 5 minutes
*/5 * * * * gitmon

That's it. Now just wait for those notifications!

Roadmap

There is a small roadmap for future releases:
• Installation bundles for major operating systems
• Menubar / system tray icon
• GUI for configuration
• Integration with diff tools

Update!

I have just found Gitifier. Here's how GitMon and Gitifier notifications about same commit look next to each other: