Skip to content

v1.0.0

Choose a tag to compare

@carsteneu carsteneu released this 09 Jul 14:24

My Star History v1.0.0

A self-hosted, xkcd-style star-history chart generator for any GitHub repo. Works as a CLI tool or a GitHub Action.

Features

  • CLI: python3 mystarhistory.py --repo owner/name generates a static SVG
  • GitHub Action: self-updating chart in your README via Docker action
  • Light + dark theme with GitHub theme auto-switching (<picture> element)
  • xkcd sketch style with embedded Handlee font
  • Zero dependencies (Python 3 stdlib + gh CLI)
  • 87 tests, 98% coverage with golden-file snapshot tests

Usage as Action

- uses: carsteneu/mystarhistory@v1
  with:
    repos: ${{ github.repository }}

Add <!-- my-star-history:start --> and <!-- my-star-history:end --> markers to your README — the action fills the space between them automatically.

Inputs

input default description
repos current repo Comma-separated owner/repo list
themes light,dark Themes to render
token ${{ github.token }} Token for stargazers API
color #dd4528 Chart line color
commit true Git-commit the result
update-readme true Rewrite README between markers