gh-contribs

Render your contribution graph to the terminal.

connects directly via github api / no third party service is used

Contents

✨ Features

• contribution count (NEW)
• other user arg
• Color schemes
• Orientation Portrait/Landscape
• Diffrent Character Glyphs
• Day labels
• Specify weeks
• Automatic Resizing
• Improved help
• More control over ouput with gap arguments
• Doubling █ -> ██

Todo

• months legend
• Configuration file
• optimize performance
• advanced animations
• User defined characters(styles)
• include update notifier
• add version arg
• isolated per-repo graph

📦 Installation

install

gh extension install mintarchit/gh-contribs

Manage Installation

list installed extensions

gh extension list

upgrade

gh extensions upgrade gh-contribs

uninstall

gh extension remove gh-contribs

⚡️ Usage

gh contribs

display help with a list of all possible arguments

gh contribs --help

Usage: gh contribs [-h] [-s <scheme>] [-g <glyph>] [-u <user>] [-w <weeks>] [-x] [-y] [-d] [-l] [-t] [-p] [-D] [-W]

Arguments:

  -h | --help                 Displays this help.
  -s | --scheme <name>        Color scheme
  -g | --glyph <char>         Change character
  -u | --user <user>          Show graph for other users
  -w | --weeks <weeks>        Set range of weeks to be displayed
  -x | --xgap                 Remove gap between each column
  -y | --ygap                 Put a gap between each row
  -d | --double               Enable doubling Glyph
  -l | --labels               Print labels
  -t | --total                Print total contributions
  -p | --portrait             Set output orientation
  -D | --Debug                Enable additional debug output
  -W | --Warning              Disable warning output

glyphs:
square dot fisheye diamond plus block

Schemes:
gh_original gh_contrast vibrant blackAwhite dracula north gold sunset mint

Color Schemes [--scheme <name>]

Schemes:
gh_contrast vibrant blackAwhite dracula north gold sunset mint

Character Glyphs [--glyph <glyph>]

Chars:
square dot fisheye diamond plus block

Limitations

Resizing Terminal font-size can temporarily mess up the display of old graph outputs

Contributing

All contributions are greatly appreciated!

If you have a suggestion that would make gh-contribs better, please fork the repo and create a pull request or open an issue.

See file CONTRIBUTION.md

Credits

gh-contribs is currently maintained by MintArchit

Forked from Mizlav/gh-contrib

See file CONTRIBUTORS