{"id":50686672,"url":"https://github.com/luarmr/github-contributions-canvas-drawing","last_synced_at":"2026-06-08T23:31:29.496Z","repository":{"id":172900174,"uuid":"633625858","full_name":"luarmr/github-contributions-canvas-drawing","owner":"luarmr","description":"Write on git hub contributions like a canvas :)","archived":false,"fork":false,"pushed_at":"2024-06-12T12:50:23.000Z","size":570,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-09T07:09:50.735Z","etag":null,"topics":["github","github-contributions"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/luarmr.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-27T23:35:29.000Z","updated_at":"2025-05-31T07:51:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"341b88c5-3839-4250-812b-0c9444d5e8ce","html_url":"https://github.com/luarmr/github-contributions-canvas-drawing","commit_stats":null,"previous_names":["luarmr/github-contributions-canvas"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/luarmr/github-contributions-canvas-drawing","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luarmr%2Fgithub-contributions-canvas-drawing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luarmr%2Fgithub-contributions-canvas-drawing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luarmr%2Fgithub-contributions-canvas-drawing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luarmr%2Fgithub-contributions-canvas-drawing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luarmr","download_url":"https://codeload.github.com/luarmr/github-contributions-canvas-drawing/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luarmr%2Fgithub-contributions-canvas-drawing/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34085321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["github","github-contributions"],"created_at":"2026-06-08T23:31:28.808Z","updated_at":"2026-06-08T23:31:29.490Z","avatar_url":"https://github.com/luarmr.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Customizable GitHub Contributions Graph\n\nThis project allows users to create custom text or display an image on their GitHub contributions graph by generating historical commits. With this tool, you can personalize your GitHub profile in a unique and creative way.\n\n[![npm version](https://img.shields.io/npm/v/github-contributions-canvas-drawing.svg)](https://www.npmjs.com/package/github-contributions-canvas-drawing)\n![npx-executable](https://img.shields.io/badge/npx-executable-blue.svg)\n\n## Features\n- Create custom text or display an image on your GitHub contributions graph\n- Customize commit count range, year, and spacing between letters\n- Dry-run option for testing before execution\n- Easy-to-follow setup and installation\n\n## Prerequisites\n- Node.js\n- Git (and GitHub account)\n- Yarn/npm (optional)\n\n## Local Installation\n\n- Clone this repository:\n\n   `git clone git@github.com:luarmr/github-contributions-canvas-drawing.git`\n\n- Navigate to the project directory:\n\n   `cd github-contributions-canvas-drawing`\n\n- Install dependencies using npm or yarn:\n\n   `yarn install` or `npm install`\n\n## Using npx\n\nTo run the project using npx, you might want to add the complete command or purpose. Here's an example assuming you're running a script from the project:\n\n```shell\nnpx github-contributions-canvas-drawing --help\n```\n\n## Usage\n- Create a new folder outside of the project directory and initialize a Git repository:\n  ```sh\n  mkdir my-graph\n  cd my-graph\n  git init\n  ```\n- Run the script with the desired options. (Several times if you want to affect different graphs per year)\n- Follow the GitHub documentation to create a new repository and connect it to your local repository:\n  ```sh\n  git branch -M main\n  git remote add origin git@github.com:\u003cuser_name\u003e/\u003cproject_name\u003e.git\n  git push -u origin main\n  ```\n\n## Options\n```sh\n⚡ npx github-contributions-canvas-drawing --help\n\nUsage: npx github-contributions-canvas-drawing [options, text or image-path is required]\n\nOptions:\n  --help, -h                   Show this help message and exit\n  --text, -t \u003cstring\u003e          The text that should be rendered (text or image-path is required)\n  --image-path, -i \u003cstring\u003e    Path to an image (7 pixels height, 53 pixels width) (text or image-path is required)\n  --min-commits, --mc \u003cnumber\u003e Minimum number of commits (default: 1)\n  --max-commits, --xc \u003cnumber\u003e Maximum number of commits (default: 30)\n  --year, -y \u003cnumber\u003e          Year (default: current year)\n  --space-between-letters, -s  \u003cnumber\u003e Space between letters (default: 1, valid: 0-7)\n  --user, -u \u003cstring\u003e          GitHub username to check for existing contributions (in beta)\n  --dry-run                    Test mode (default: false)\n  --force, -f                  Force remove commits older than the initial date\n```\n\n## Examples\n\nCreate custom text on the GitHub contributions graph for the year 2016. This command doesn't account for any existing contributions you may have:\n```sh\nnpx github-contributions-canvas-drawing -t \"Be Nice\" --space-between-letters 2 --year 2016;\n```\n\nCreate custom text on the GitHub contributions graph for the year 2016, but this time the tool will account for any existing contributions you may have:\n```sh\nnpx github-contributions-canvas-drawing -t \"Be Nice\" --space-between-letters 2 --year 2016 --user luarmr;\n# Notice that the contrib graph is timezone aware. So this may produce unexpected results. \n```\n\nCreate custom text on your default GitHub contributions graph:\n```sh\nnpx github-contributions-canvas-drawing -t \"Be Nice\" --space-between-letters 2;\n```\n\nPreview the custom text without making actual commits:\n```sh\nnpx github-contributions-canvas-drawing -t \"Be Nice\" --space-between-letters 2 --dry-run;\n```\n\nUse an image to create a custom GitHub contributions graph:\n```sh\nnpx github-contributions-canvas-drawing -i \"/path/to/image.png\";\n```\n\n## Some Results\n\n### From Image\n![Console execution of: npx github-contributions-canvas-drawing -i ../github-contributions-canvas-drawing/assets/example.png -s2  --xc 4 -y 2011](https://github.com/luarmr/github-contributions-canvas-drawing/blob/main/assets/console_from_image.png?raw=true)\n\n![Result of the execution with image](https://github.com/luarmr/github-contributions-canvas-drawing/blob/main/assets/github_from_image.png?raw=true)\n\n### From Text\n![Console execution of: npx github-contributions-canvas-drawing -t \"be kind\" -s1 -y 2013](https://github.com/luarmr/github-contributions-canvas-drawing/blob/main/assets/console_from_text_be_kind.png?raw=true)\n\n![Result of the execution from text](https://github.com/luarmr/github-contributions-canvas-drawing/blob/main/assets/github_from_text_be_kind.png?raw=true)\n\n## Notes\n- Ensure your repository is initialized with `git init` before running the script.\n- Use the `--dry-run` option to preview the changes without making any commits.\n- The `--user` option is in beta and may not account for all time zones correctly.\n\n## License\nISC","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluarmr%2Fgithub-contributions-canvas-drawing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluarmr%2Fgithub-contributions-canvas-drawing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluarmr%2Fgithub-contributions-canvas-drawing/lists"}