Skip to content

A Qt C++ app to blatantly abuz the git commit date option to customize your GitHub contribution graph.

Notifications You must be signed in to change notification settings

heckerfr0d/github-tile-art

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Tile Art

A Qt C++ app to customize your GitHub contribution graph. Basically a C++ port of this python GUI app.

Instructions

Usage

screenshot

The auto-update feature stores your designs for the auto-update script to automatically select and set one (from all your default year designs) on startup.
Warning: Only do this on a dedicated repo as it will delete and recreate the repo. Only the commits made for other years with Auto Update? checked remain unaffected.
The rest is pretty self-explanatory (I think :p).
Username, password and email must be the ones corresponding to your github account.
Link to repo must be the https link. 100% recommend creating a dedicated repo for this :p .
You can make your design using the grid of checkboxes. You can also translate text directly to tile art. Current build only supports caps and some special characters 😬 .
Invert behaves exactly as expected.
You can select under which year you want your graffiti to appear. It defaults to the last 52 weeks which is what your profile page normally displays.
Commits per day is, obviously, the number of commits you want the program to do per day. The tile gets darker according to this number.
Once you're satisfied with the design (are we ever? :P), Just tell the app to Do IT and it will 😌 .
Note: Depending on the number of commits it may take some time and the app may appear to not respond but don't worry, it's just creating all those commits in the background 😁 .

Build

Pre-requisites

  1. libgit2-1.1.0. You can install it from your package manager if available (Ubuntu 21.04+) or you can build it yourself.
  2. qmake and qt6 libraries. Things will be much simpler if you install the whole Qt6 open-source package.
  3. A clone of this repo (duh :p).

Ok, now navigate to the cloned repo folder and open github-tile-art.pro using Qt Creator.
Correct the path to libgit2 in github-tile-art.pro by replacing $$PWD/../ with the path to your libgit2-1.1.0 folder.
If you installed libgit2 using your package manager you can simply remove the INCLUDEPATH and DEPENDPATH lines and change the LIBS line to

LIBS += -lgit2

Once you've made whatever other changes you want to make, all you have to do is build and run using the Qt Creator GUI.
That's it! You've successfully built the app. Deployment, on the other hand, is a whole other story. 🙃

Deployment

There are just a lot of different ways to do this so I'm just gonna drop links for now. 😇
Deployment on Qt6
linuxdeployqt to create appimages.

Credits ❤️

@dumbmachine - Original Idea 😁
@hanna13n - Cross Platform Testing and Linux Deployment 😎
@SinadShan - Testing on fresh Ubuntu 20.04 😌
@HowardHinnant - The date algorithms used in calendar.h
I made the C++ font map by editing some python dictionary that I can't find now (I'm sorry 🥺).
The dreaded yet invaluable Documentations (Qt, libgit2, linuxdeployqt) 🤓
The wonderful people on StackOverflow etc. ❤️
Anyone else I've missed (sorry 🥺❤️)

THANK YOU!! ❤️❤️

About

A Qt C++ app to blatantly abuz the git commit date option to customize your GitHub contribution graph.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published