Customizing your Github timeline

posted in: Guides, tricks | 0

Hello, today we’ll try to customize the github banner like this:


In order to achieve that, we’ll use Gitbanner works by creating a new git repository and filling it with dummy commits, with dates set to correspond to the pixels on your Github “Contributions” graph.


On Ubuntu, we first need to install all required dependencies:

sudo apt-get install libcairo2-dev libjpeg8-dev libpango1.0-dev libgif-dev build-essential g++ npm cmake libzip-dev nodejs nodejs-legacy

You may need to update your bashrc file in order to acces node. Just add this line to your bashrc:

export PATH=/usr/local/bin:$PATH

Then don’t forget to reload your bashrc file:

source ~/.bashrc

then install node canvas:

sudo npm install canvas

and nodegit

npm install nodegit

and finally gitbanner:

sudo npm install gitbanner



1. Generate your repo:

gitbanner <Github email> <text>

NOTICE: Gitbanner needs the email associated with your Github account, otherwise Github won’t think you made the commits.

You will see a preview of your banner. If it doesn’t look too great, try using a different font:

gitbanner -f "7pt Arial" <email> <text>

2. Create a repo on Github.


3. Push the repo to Github:

For me it is this:

Here is the result:




Leave a Reply