{"id":15700194,"url":"https://github.com/erikh/git-shining","last_synced_at":"2025-05-12T13:11:18.952Z","repository":{"id":190870674,"uuid":"683201643","full_name":"erikh/git-shining","owner":"erikh","description":"Turn your GitHub contributor graph into living art","archived":false,"fork":false,"pushed_at":"2023-08-30T11:34:07.000Z","size":244,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-29T21:47:39.338Z","etag":null,"topics":["art","git","github"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/git-shining","language":"Rust","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/erikh.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":"2023-08-25T21:01:08.000Z","updated_at":"2024-05-07T20:25:41.000Z","dependencies_parsed_at":"2023-08-26T20:26:35.514Z","dependency_job_id":"83eb0c4d-b38d-49ab-a474-295b19938e8f","html_url":"https://github.com/erikh/git-shining","commit_stats":null,"previous_names":["erikh/git-shining"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikh%2Fgit-shining","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikh%2Fgit-shining/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikh%2Fgit-shining/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/erikh%2Fgit-shining/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/erikh","download_url":"https://codeload.github.com/erikh/git-shining/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253745166,"owners_count":21957317,"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":["art","git","github"],"created_at":"2024-10-03T19:46:40.740Z","updated_at":"2025-05-12T13:11:18.938Z","avatar_url":"https://github.com/erikh.png","language":"Rust","readme":"# git-shining: Transform the GitHub contributor graph into living art\n\nThis program turns your contributor graph into a work of art by filing commits with the right dates. GitHub will automatically scan the repository and fill out the graph for you.\n\n\u003cp\u003e\u003ccenter\u003e\u003cimg src=\"heart.png\" /\u003e\u003c/center\u003e\u003c/p\u003e\n\u003cp\u003e\u003ccenter\u003e\u003cimg src=\"font.png\" /\u003e\u003c/center\u003e\u003c/p\u003e\n\nOr [here](https://github.com/erikh?tab=overview\u0026from=1978-12-01\u0026to=1978-12-31) if you want a more in-your-face example.\n\n## Constraints\n\nBest to create or use a burner account for this; this is not for your main account.\n\n-   You must have no other activity for the year, which includes pull requests, issue comments, etc.\n-   You must only have one repository recording commits for the year, and it must be all commits related to your message.\n-   GitHub will let you back-date your commits to 1970/1/1 so be sure to use the `--origin` option if you want to exploit that.\n\n## Usage\n\nThe first step is to generate configuration. You can do this in two ways:\n\n```\ngit-shining generate-config \u003cjson|txt\u003e\n```\n\nThis will generate a blank canvas for editing in JSON or TXT (more on this later) format.\n\n**or**\n\n```\ngit-shining render-font \u003c.otf or .ttf file\u003e \u003cmessage (be sure to quote)\u003e\n```\n\nThis will generate a pre-filled configuration with the message rasterized to the canvas in the font provided.\n\nThen, you can generate a repository with the `generate-repository` command. Be sure to at least set the `email` field of the person you want getting credit for the commits, it must map directly to a configured GitHub email:\n\n```\ngit-shining generate-repository -i bro.txt -e wearelegion@example.org -m \"Sup Bro\" /tmp/test.git\n```\n\nAfter that, you can create your repository and upload it.\n\nIf you want to generate repositories that start the graph at a certain date, look at the `--origin` options of `build` and `generate-repository`.\n\n## Configuration Formats\n\nThere are two formats for configuration: JSON and TXT.\n\nJSON is a JSON array of integers, from 0-10, which coordinate to shading in the graph (made possible by filing more commits for brighter shades). It is easy to consume, post-process, and generate, but a little hard to edit.\n\nTXT is an easier format to hand-edit. It is simply a well-aligned grid of integers, which you can set from 0-`A` (`A` is 10 here) to affect shading.\n\nThe `generate-config` sub-command can generate both formats for hand-editing, and the `render-font` command has switches to modify target configuration output.\n\n## Troubleshooting\n\n-   If you upload twice, you must fully delete the old repository and re-create it. Force pushes will not clear the graph.\n-   If you're wondering what your graph will look like before you push to GitHub, try the `build` sub-command which will generate a HTML mock of the graph you can load into your browser. You can hover over each square to get the expected date.\n\n## Future Plans\n\n-   Marquee and Mural functionality\n\n## Author\n\nThe Professional \u003cerik+github@hollensbe.org\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferikh%2Fgit-shining","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferikh%2Fgit-shining","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferikh%2Fgit-shining/lists"}