Skip to main content

​
GitHub Star Tracker

A GitHub Action that automatically tracks star count changes across all your repositories on a schedule, generates visual reports with charts and badges, and sends notifications when changes are detected.

Get StartedView on GitHub

​
Key Features

Animated SVG Charts

Star history, per-repo trends, comparisons, and growth forecasts with automatic dark/light mode support

Smart Filtering

Filter repositories by visibility, ownership, min stars, regex exclusions, archived, and forks

Stargazer Tracking

Track individual stargazers with avatars and timestamps to see who’s starring your repos

Email Notifications

Built-in SMTP with fixed or adaptive thresholds to notify you of star changes

Multi-language Support

Reports and emails in English, Spanish, Catalan, and Italian

Shields.io Badges

Embeddable star count badges that update automatically

Growth Forecasting

AI-powered predictions of future star growth based on historical trends

Multiple Export Formats

CSV, JSON, Markdown, and HTML reports for dashboards and data pipelines

​
What You Get

Every run, Star Tracker commits these artifacts to a dedicated data branch:
  • Animated SVG charts - Star history, per-repo trends, top repos comparison, and growth forecasts with automatic dark/light mode support
  • Shields.io-style badge - Embeddable star count that updates automatically
  • Markdown & HTML reports - Summary tables, delta indicators, new/removed repos, stargazer details, and forecast tables
  • CSV & JSON data - Machine-readable exports for dashboards, spreadsheets, or downstream pipelines

​
Quick Start

1

Create a Personal Access Token

Generate a classic token with repo or public_repo scope and add it as a repository secret named GITHUB_STAR_TRACKER_TOKEN
The default GITHUB_TOKEN is not sufficient. See the PAT guide for details.
2

Add the Workflow

Create .github/workflows/star-tracker.yml in your repository
name: Track Stars

on:
  schedule:
    - cron: '0 0 * * *' # Daily at midnight
  workflow_dispatch:

permissions:
  contents: write

jobs:
  track:
    runs-on: ubuntu-latest
    steps:
      - uses: fbuireu/github-star-tracker@v1
        with:
          github-token: ${{ secrets.GITHUB_STAR_TRACKER_TOKEN }}
3

Run and View

Trigger a manual run from Actions tab or wait for the scheduled run. View the report in the star-tracker-data branch.

​
Documentation

Getting Started

Set up Star Tracker in your repository

Configuration

Configure filtering, notifications, and more

How It Works

Understand the execution flow and architecture

API Reference

Complete inputs, outputs, and data formats

Examples

Real-world workflow configurations

Troubleshooting

Common issues and solutions

Build docs developers (and LLMs) love

Get started for freeTalk to us