{"id":13936819,"url":"https://github.com/ammsa/Githeat","last_synced_at":"2025-07-19T22:32:36.664Z","repository":{"id":46282811,"uuid":"62201723","full_name":"ammsa/Githeat","owner":"ammsa","description":"🔥 Interactive heatmap for your git repos","archived":false,"fork":false,"pushed_at":"2022-12-26T20:12:30.000Z","size":476,"stargazers_count":174,"open_issues_count":5,"forks_count":6,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-11-17T08:06:01.333Z","etag":null,"topics":["git","interactive","visualization"],"latest_commit_sha":null,"homepage":"https://ammsa.github.io/Githeat","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ammsa.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-06-29T06:33:01.000Z","updated_at":"2024-09-03T03:40:25.000Z","dependencies_parsed_at":"2023-01-31T01:00:18.863Z","dependency_job_id":null,"html_url":"https://github.com/ammsa/Githeat","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ammsa%2FGitheat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ammsa%2FGitheat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ammsa%2FGitheat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ammsa%2FGitheat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ammsa","download_url":"https://codeload.github.com/ammsa/Githeat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226693898,"owners_count":17667757,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["git","interactive","visualization"],"created_at":"2024-08-07T23:03:01.720Z","updated_at":"2025-07-19T22:32:36.659Z","avatar_url":"https://github.com/ammsa.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"|logo|\n======\n\nGitHeat uses your local machine to parse the git-log of your repo and build an interactive heatmap in your terminal. You can use GitHeat to see what days are most popular, and what months are most active.\n\nTo start the interactive heatmap, run:\n\n        $ githeat.interactive\n\n|video|\n\nor skip the interactive part and print the heatmap directly by running: \n\n        $ githeat\n\n|githeat_cli|\n\n\nWant to merge in the months? run\n\n        $ githeat --month-merge\n\n|githeat_cli_month_merge|\n\n\nWant to separate each day block? run\n\n        $ githeat --separate\n\n|githeat_cli_separate|\n\n\nWant to change the width of each block? choose between thin, reg, thick:\n\n        $ githeat --width {thick,reg,thin}\n\n\n|githeat_cli_width_thin|\n\n\nWant to change the color of the graph? choose between grass, sky, fire\n\n        $ githeat --color {grass,fire,sky}\n\n|githeat_cli_color_fire|\n\n\nWant to show who are the top 10 most committers? run and it will parse the days for you:\n\n        $ githeat --stat --stat-number 10\n\n|githeat_cli_stat_stat_number_10|\n\n\nWant to filter out commits by author? write regex in the author argument:\n\n        $ githeat --author=\"Will\"\n\nWant to filter out commits by keywords in commit? write regex in the grep argument:\n\n        $ githeat --grep=\"Fix\"\n\nHave a specific YAML configuration file you want to use? pass it to the config argument:\n\n        $ githeat --config PATH_TO_CONFIG.yaml\n\nNeed help? run:\n\n      .. code-block:: html\n\n        $ githeat -h\n\n        usage: githeat.py [-h] [-c FILE] [--gtype {inline,block}]\n                         [--width {thick,reg,thin}] [--days DAYS [DAYS ...]]\n                          [--color {grass,fire,sky}] [--stat-number STAT_NUMBER]\n                          [--stat] [--separate] [--month-merge] [--author AUTHOR]\n                          [--grep GREP] [-v]\n                          [--logging {CRITICAL,ERROR,WARNING,INFO,DEBUG,NOTSET}]\n\n        githeat: Terminal Heatmap for your git repos\n\n        optional arguments:\n          -h, --help            show this help message and exit\n          -c FILE, --config FILE\n                                Specify YAML config file\n          --gtype {inline,block}\n                                Choose how you want the graph to be displayed\n          --width {thick,reg,thin}\n                                Choose how wide you want the graph blocks to be\n          --days DAYS [DAYS ...]\n                                Choose what days to show. Please enter list of day\n                                abbreviations or full name of week\n          --color {grass,fire,sky}\n                                Choose type of coloring you want for your graph\n          --stat-number STAT_NUMBER\n                                Number of top committers to show in stat\n          --stat, -s            Show commits stat\n          --separate, -b        Separate each day\n          --month-merge         Separate each month\n          --author AUTHOR, -a AUTHOR\n                                Filter heatmap by author. You can also write regex\n                                here\n          --grep GREP, -g GREP  Filter by keywords in commits\n          -v, --version         print version and exit\n          --logging {CRITICAL,ERROR,WARNING,INFO,DEBUG,NOTSET}\n                                logger level\n\nor for the interactive help\n\n      .. code-block:: html\n\n        $ githeat.interactive -h\n         usage: githeat.py [-h] [-c FILE] [--width {thick,reg,thin}]\n                  [--days DAYS [DAYS ...]] [--color {grass,fire,sky}]\n                  [--month-merge] [--hide-legend] [--author AUTHOR]\n                  [--grep GREP] [-v]\n                  [--logging {CRITICAL,ERROR,WARNING,INFO,DEBUG,NOTSET}]\n\n         githeat: Terminal Heatmap for your git repos\n\n         optional arguments:\n           -h, --help            show this help message and exit\n           -c FILE, --config FILE\n                                 Specify YAML config file\n           --width {thick,reg,thin}\n                                 Choose how wide you want the graph blocks to be\n           --days DAYS [DAYS ...]\n                                 Choose what days to show. Please enter list of day\n                                 abbreviations or full name of week\n           --color {grass,fire,sky}\n                                 Choose type of coloring you want for your graph\n           --month-merge         Separate each month\n           --hide-legend         Hide legend\n           --author AUTHOR, -a AUTHOR\n                                 Filter heatmap by author. You can also write regex\n                                 here\n           --grep GREP, -g GREP  Filter by keywords in commits\n           -v, --version         print version and exit\n           --logging {CRITICAL,ERROR,WARNING,INFO,DEBUG,NOTSET}\n                                 logger level\n\n\n\nMinimum Requirements\n====================\n\n* Python 2.7\n\n\nOptional Requirements\n=====================\n\n..  _py.test: http://pytest.org\n..  _Sphinx: http://sphinx-doc.org\n\n* `py.test`_ 2.7 (for running the test suite)\n* `Sphinx`_ 1.3 (for generating documentation)\n\n\nBasic Setup\n===========\n\nInstall using pip:\n\n..  code-block::\n\n    $ pip install githeat\n\n\nOr to obtain the latest most-up-to-date version, clone the repo and install it from source:\n\n.. code-block::\n\n    $ git clone https://github.com/AmmsA/Githeat\n    $ cd Githeat \u0026\u0026 python setup.py install\n\n\nInstall for the current user:\n\n..  code-block::\n\n    $ python setup.py install --user\n\n\nRun the application:\n\n..  code-block::\n\n    $ python -m githeat --help\n\n\nRun the test suite:\n\n..  code-block::\n   \n    $ py.test test/\n\n\nBuild documentation:\n\n..  code-block::\n\n    $ cd doc \u0026\u0026 make html\n    \n    \nDeploy the application in a self-contained `Virtualenv`_ environment:\n\n..  _Virtualenv: https://virtualenv.readthedocs.org\n\n..  code-block::\n\n    $ python deploy.py /path/to/apps\n    $ cd /path/to/apps/ \u0026\u0026 githeat/bin/cli --help\n\n\n.. |logo| image:: https://raw.githubusercontent.com/AmmsA/Githeat/master/website/static/images/logo.png\n   :width: 100px\n   :alt: githeat\n   :target: https://github.com/ammsa/Githeat\n.. |video| image:: https://asciinema.org/a/812lm3uzd9yk8dbe0aehj5jvj.png\n   :target: https://asciinema.org/a/812lm3uzd9yk8dbe0aehj5jvj\n.. |githeat_cli| image:: https://raw.githubusercontent.com/AmmsA/Githeat/master/website/static/images/githeat_cli.png\n.. |githeat_cli_month_merge| image:: https://raw.githubusercontent.com/AmmsA/Githeat/master/website/static/images/githeat_cli_month_merge.png\n.. |githeat_cli_separate| image:: https://raw.githubusercontent.com/AmmsA/Githeat/master/website/static/images/githeat_cli_separate.png\n.. |githeat_cli_width_thin| image:: https://raw.githubusercontent.com/AmmsA/Githeat/master/website/static/images/githeat_cli_width_thin.png\n.. |githeat_cli_color_fire| image:: https://raw.githubusercontent.com/AmmsA/Githeat/master/website/static/images/githeat_cli_color_fire.png\n.. |githeat_cli_stat_stat_number_10| image:: https://raw.githubusercontent.com/AmmsA/Githeat/master/website/static/images/githeat_cli_stat_stat_number_10.png\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fammsa%2FGitheat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fammsa%2FGitheat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fammsa%2FGitheat/lists"}