:octocat: Open source github contribution stats on your Mac OS X Menu Bar
Clone or download
Shikkic Merge pull request #11 from Shikkic/fix/bump-gh-version
bump gh-scrape version to 1.1.0
Latest commit 9dbb126 Sep 14, 2017



:octocat: A plugin for BitBar to quickly show your open source GitHub contribution stats and help set contribution goals, all on your Mac OS X Menu Bar. :octocat:

Almost all of us have private repos we tend to work on, and it's really easy to neglect your OSS work. So, I created Gitbar to make daily public contributions a habit. Gitbar is a OSX Menu Bar utility that shows your daily GitHub stats, streaks, and contributions. You can even set contribution goals in the application.

dank application screenshot


  • Must be on Mac OSX (Snow Leopard or newer (>= 10.6))
  • Have Node.js and npm installed


First, download and install BitBar.

Clone the plugin repo:

$ git clone https://github.com/Shikkic/gitbar/

Inside the repo folder, install the dependencies:

$ npm install


In the root folder you'll need to modify the .env file with your GitHub username. Here you'll also be able to customize contribution goal tracking as well. Simply give the tracking value TRUE or FALSE to turn it on or off, respectively, and provide your ideal goal number to give yourself a completion percentage.


Now, launch BitBar and select the gitbar_plugin folder as your Plugin Folder.



If you have an error resulting from your path to Node, edit the shebang at the top of gh.5m.js to include the correct path.

To find the correct path simply run:

$ which -a node


Obviously BitBar.

I also use the gh-scrape to crawl GitHub and parse selected values from public GitHub profiles. Feel free to contribute if you'd like!

I use this module instead of using the GitHub API for a few reasons. I wanted to make it as easy as possible to setup and requiring users to generate and input an API key made the barrier of entry seem high. Also, this allows us to only focus on publicly available contributions, which was the original intended purpose.

Suggestions, comments?

Feel free to create an issue or reach out on the 💬 BitBar Slack or Twitter @shikkic!