{"id":17688013,"url":"https://github.com/blaise-io/contribution","last_synced_at":"2025-04-10T03:55:53.945Z","repository":{"id":144345228,"uuid":"277730283","full_name":"blaise-io/contribution","owner":"blaise-io","description":"CLI tool to draw an image on your GitHub contribution graph.","archived":false,"fork":false,"pushed_at":"2022-11-11T19:16:12.000Z","size":49,"stargazers_count":277,"open_issues_count":1,"forks_count":20,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-10T03:55:47.762Z","etag":null,"topics":["cli-app","contribution","github","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","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/blaise-io.png","metadata":{"files":{"readme":"README.md","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-07T05:59:06.000Z","updated_at":"2025-04-08T22:32:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"be5e19e3-c7bd-40de-82c8-f61de6fffbdb","html_url":"https://github.com/blaise-io/contribution","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaise-io%2Fcontribution","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaise-io%2Fcontribution/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaise-io%2Fcontribution/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaise-io%2Fcontribution/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blaise-io","download_url":"https://codeload.github.com/blaise-io/contribution/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248155001,"owners_count":21056542,"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":["cli-app","contribution","github","golang"],"created_at":"2024-10-24T11:43:09.435Z","updated_at":"2025-04-10T03:55:53.921Z","avatar_url":"https://github.com/blaise-io.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Contribution\n\nDraw an image on your GitHub contribution graph.\n\n#### Examples\n\n| ![Heart](image/result/heart.png)            | ![Skull](image/result/skull.png)            |\n| ------------------------------------------- | ------------------------------------------- |\n| ![Creeper](image/result/creeper.png)        | ![I need a job](image/result/ineedajob.png) |\n\n\n## How does it work?\n\nGitHub displays commits in the contribution history graph. Contribution pushes \na bunch of commits with a custom date using `git commit --date \u003cdate\u003e`. It \nbundles multiple commits on a single day to achieve a darker pixel in the graph.\n\nThe GitHub contribution graph is 52 × 7 pixels and shows up to five shades for\nactivity. This app automatically limits the colors and dimensions of your input \nimage to match these restrictions. Use the [preview](#contribution-preview--help) \nsubcommand if you're not feeling lucky.\n\nWarning: you cannot remove contribution activity on GitHub unless you delete a \nproject, so you probably want to push to a project specifically created for \nthis purpose. Contributions to secret projects may also be shown, depending on \nyour GitHub settings.\n\nContribution uses your default SSH identity. If you want to use another identity,\nyou can do so by setting the [`GIT_SSH_COMMAND` and `GIT_AUTHOR_EMAIL` env variables.](https://gist.github.com/blaise-io/7a90dafb9ecee3022c8cf89e92b4dcc4)\n\n\n## Download\n\nYou can find prebuilt binaries voor Windows, macOS and Linux in \n[releases](https://github.com/blaise-io/contribution/releases/latest).\n\nOr clone the project and build yourself.\n\n - [Use the source image of these examples](image/source)\n - [Create your own using this palette image](image/source/palette.png)\n\nIf you don't have Paint installed you can use a free online tool like \n[pixilart.com](https://www.pixilart.com/draw).\n\n\n## How to use\n\nContribution is provided as a binary with a command line interface.\n\n\u003c!-- The section below is added by `make README.md` --\u003e\n### `contribution -help`\n```\nDraw an image on your GitHub contribution history.\nBy Blaise Kal, 2021\n\nPreview contribution history graph without pushing\n  contribution preview -img /path/to/image.png\nPreview usage and options\n  contribution preview -help\n\nPush contribution history graph to GitHub\n  contribution push -img /path/to/image.png -project username/project\nPush usage and options\n  contribution push -help\n```\n\n### `contribution preview -help`\n```\nPreview contribution history graph without pushing.\nExample usage:\n  contribution preview -img image.png\n\n  -img string\n    \tPath to a valid PNG image. (required)\n```\n\n### `contribution push -help`\n```\nPush contribution history graph to GitHub\nExample usage:\n  contribution push -project username/project\n\n  -branch string\n    \tGit branch to push to. (default \"contribution\")\n  -img string\n    \tPath to a valid PNG image. (required)\n  -project string\n    \tGitHub username/project to push to. (required)\n  -w int\n    \tWeeks ago of all activity. A value of 2 will move activity two pixels to the left.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblaise-io%2Fcontribution","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblaise-io%2Fcontribution","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblaise-io%2Fcontribution/lists"}