gh-contribs

Render your contribution graph to the terminal.

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

Contents

✨ Features

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

📦 Installation

install

$ gh extension install mintarchit/gh-contribs

$ gh extension list

$ gh extensions upgrade gh-contribs

$ 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] [-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               Enable Labels
  -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_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