Github updates notifier for Linux
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This is a Linux/Python port of miyagawa's github-growler.

It fetches your Github dashboard feeds and displays a notification for new items. There is additional features like filtering only notifications from important authors and/or projects. The GitHub blog entries can also be seen in the notifications if desired.


  • git
  • python 2.5, 2.6 or 2.7
  • feedparser
  • simplejson (not needed for python 2.6)


First install the package dependencies (using Ubuntu)

sudo apt-get install python-setuptools python-gtk2 python-feedparser python-simplejson python-notify

Then clone the repository and install the module:

git clone git://
cd github-notifier
python install

Now you can run github-notifier like this:


github-notifier will read the github.token from your git config. Make sure that it matches the token found on at the bottom of your github main page, Subscribe to your news feed link. You can see your config via git config -l and git config --get github.token.

Use --help for a list of available command line options.


An Arch Linux package is available here.


Screenshot using notify-osd:


Organizations Feeds Feature

The user's organizations are monitored by default. But you can use the filtering feature to blacklist some organizations.

Filtering Feature

Authors are filtered when using the -a flag. Projects are filtered when using the -p flag. -k to blacklist organizations. A config.cfg file is present within your ~/.githubnotifier/ directory. The file will be generated if it is not present at run-time.

The config.cfg format is as follows:


This configuration will only show notifications that have bob, fred or mary as the authors. The projects can either be in a general format (ex: github-notifier or rails) to only show notifications that deal with either of those projects. The general format will show notifications that match the project name, regardless of who is the owner of the repository. The stricter format (ex: bob/my-project) will only show notifications of the my-project repository if the owner if bob.

It is also possible to completely blacklist notifications from certain authors and/or projects. This is configured the same way as for important projects, but now the configuration falls under the blacklist category, the organizations can be filtered using the login (ex: LogicalBricks,Github), comma separated.

Filters for important authors/projects will override filters for blacklisted authors/projects if they both are enabled.


  • Expire the user info and avatar caches after some time
  • Notify-osd has problems when the notification message contains an '&' character
  • Build a preferences dialog


The Octocat logo is taken from