{"id":28558951,"url":"https://github.com/talwrii/gh-star-timeline","last_synced_at":"2026-03-10T08:02:20.333Z","repository":{"id":289372460,"uuid":"971033033","full_name":"talwrii/gh-star-timeline","owner":"talwrii","description":"Command-line tool to keep track of historic stars on github. Machine-useable output.","archived":false,"fork":false,"pushed_at":"2025-05-01T01:18:41.000Z","size":88,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-05T08:25:31.809Z","etag":null,"topics":["cli","github","stars","timeline"],"latest_commit_sha":null,"homepage":"https://readwithai.substack.com/p/my-productivity-tools","language":"Python","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/talwrii.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,"zenodo":null}},"created_at":"2025-04-22T23:06:45.000Z","updated_at":"2025-05-01T01:18:41.000Z","dependencies_parsed_at":"2025-04-23T00:23:17.051Z","dependency_job_id":"a2c09b29-c965-490b-beb8-8e2029e5f026","html_url":"https://github.com/talwrii/gh-star-timeline","commit_stats":null,"previous_names":["talwrii/gh-star-timeline"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/talwrii%2Fgh-star-timeline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/talwrii%2Fgh-star-timeline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/talwrii%2Fgh-star-timeline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/talwrii%2Fgh-star-timeline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/talwrii","download_url":"https://codeload.github.com/talwrii/gh-star-timeline/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/talwrii%2Fgh-star-timeline/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259039468,"owners_count":22796839,"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","github","stars","timeline"],"created_at":"2025-06-10T08:35:48.947Z","updated_at":"2026-03-10T08:02:15.275Z","avatar_url":"https://github.com/talwrii.png","language":"Python","funding_links":["https://ko-fi.com/c/965d8a3fca"],"categories":["\u003ca name=\"online\"\u003e\u003c/a\u003eOnline search and resources"],"sub_categories":[],"readme":"# Github star timeline cli\n**@readwithai** - [X](https://x.com/readwithai) - [blog](https://readwithai.substack.com/) - [machine-aided reading](https://www.reddit.com/r/machineAidedReading/)\n\n`gh-star-timeline` maintains a timeline of the number of stars that a [Github](https://github.com/github) repository has over time.\n\nBasic statistical aggregates can be queried offline.\n\n## Alternatives and prior work\nThere are many open source projects on github which do similar things.\n\n[starcount](https://github.com/starkblaze01/Star-Count) and [gh-stars](https://github.com/jonschlinkert/gh-stars) fetch the number of stars for all repositories a user has, but at a specific point in time. I have reimplemented much of this functionality here because I wanted to maintain a timeline. One could alternatively wrap this tool.\n\n[star history](https://www.star-history.com/) can produce plots (but only plots) of the historic number of starts for a repository and is [open source](https://github.com/star-history/star-history).  I believe this uses the `stargazers` api which can provide the time that a repository was starred (See  [this snippet](https://gist.github.com/jasonrudolph/5abee158b42b99a3990a))\n\nThis sort of timeline can be regenerated (up-to stars being removed) from ghis snippet.\n\nI have a similar project, [gh-views](https://github.com/talwrii/gh-views), which fetches the number of views and clones for repository.\n\n## Installation\nYou can install `gh-star-timeline` using [pipx](https://github.com/pypa/pipx):\n\n```\npipx install gh-star-timeline\n```\n\nYou must also install the github command-line tool [gh](https://github.com/cli/cli) and log in to github with `gh auth login`.\n\n# Usage\nTo fetch the total number of stars for a repository you can run e.g.\n```\ngh-star-timeline talwrii/ffmpeg-cookbook\n```\n\nTo see documentation for `gh-star-timeline` you can use:\n\n```\ngh-star-timeline --help\n```\n\nTo get the number of stars for each repo (analogous to [starcount](https://github.com/starkblaze01/Star-Count). This can be a little slow. It should be faster on later runs.\n\n```\ngh-star-timeline --user talwrii\n```\n\nYou can use the `-n` option to use fetched data.\n\nIf you want the total number of stars for all your repositories, you can run:\n```\ngh-star-timeline --user talwrii -n --total\n```\nYou can use `-T` instead of `--total`\n\n\nTo get a timelime of all stars added (or removed while you where using `gh-star-timeline`), you can run:\n```\ngh-star-timeline talwrii/curlfire --stars -n\n```\n\nTo get a timeline of stars counts over time you can use `--timeseries`\n```\ngh-star-timeline  talwrii/curlfire -n --timeseries\n```\nIt would be relative easy to place this information on a graphical plot using any programming language or spreadsheet.\n\nYou can get a timeseries of the total number of stars across all your repos with:\n```\ngh-star-timeline  talwrii/curlfire -n --timeseries -T\n```\n\n### Periodically fetching\nYou can fetch a complete history of star counts (apart from removed stars) at any time by running *without* the `-n` option. You may like to run periodically to keep your local stats up-to-date and detect people removing stars.\n\nThis could be done with a [systemd timer](https://www.freedesktop.org/software/systemd/man/latest/systemd.timer.html) or [cron job](https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/) or a variety of other methods.\n\n### Backing up data\nData is stored in `~/.local/state/gh-star-timeline`. You may wish to periodically back up this data.\n\n## Caveats\n`gh-star-timeline` was written and tested on Linux. It will probably work on Mac without any alteration. The paths that `gh-star-timeline` uses to store data may need to be adapted for Windows. This should be an easy change if you are familiar with the Python programming language and I will accept and quickly merge any pull requests which add support for other systems.\n\n## Reporting Issues\nIf you find any issues it would be helpful for me and other users if you report them to me via [Github issues](https://github.com/talwrii/gh-star-timeline/issues).\n\n## Support\nIf you find this project useful,  you could pay me money ($3 maybe) through my [ko-fi](https://ko-fi.com/c/965d8a3fca). This will incentivize me to respond to issues with this repo and work on [similar command-line tools](https://readwithai.substack.com/p/my-productivity-tools)\n\nYou could also look at a similar tool I made to track views and clones of a github repo: [gh-views](https://github.com/talwrii/gh-views). Or read some of the things that I have written about note-taking and reading. Perhaps this [review of note-taking in Obsidian](https://readwithai.substack.com/p/note-taking-with-obsidian-much-of) would be a good starting point.\n\n## About me\nI am **@readwithai** I make tools for reading, research, and agency sometimes using [Obsidian](https://readwithai.substack.com/p/what-exactly-is-obsidian).\n\nYou can follow me on [X](https://x.com/readwithai) where I write about many things - including productivity tools like this. Or you can read my [blog](https://readwithai.substack.com/) where I write more around reading and research\n\n![@readwithai logo](./logo.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftalwrii%2Fgh-star-timeline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftalwrii%2Fgh-star-timeline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftalwrii%2Fgh-star-timeline/lists"}