From 2d8b0005cbf7a11c3392f1e614967c67a92605dc Mon Sep 17 00:00:00 2001
From: maziggy <mz@v8w.de>
Date: Tue, 7 Jul 2026 11:11:15 +0200
Subject: [PATCH] Housekeeping

---
 .github/workflows/repo-stats.yml | 66 +++++++++++++++++++++++++++++
 BACKERS.md                       | 73 ++++++++++++++++++++++++++++++++
 2 files changed, 139 insertions(+)
 create mode 100644 .github/workflows/repo-stats.yml
 create mode 100644 BACKERS.md

diff --git a/.github/workflows/repo-stats.yml b/.github/workflows/repo-stats.yml
new file mode 100644
index 000000000..53dca9db9
--- /dev/null
+++ b/.github/workflows/repo-stats.yml
@@ -0,0 +1,66 @@
+name: GitHub Repo Stats
+
+on:
+  schedule:
+    - cron: "0 23 * * *"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  repo-stats:
+    name: repo-stats
+    runs-on: ubuntu-latest
+    steps:
+      - name: run-ghrs
+        uses: jgehrcke/github-repo-stats@v1.4.2
+        with:
+          repository: maziggy/bambuddy
+          ghtoken: ${{ secrets.GHRS_GITHUB_API_TOKEN }}
+          ghpagesprefix: https://maziggy.github.io/bambuddy
+
+      # Inject ghcr.io container-download stats (cumulative + 30-day
+      # sparkline merged into a sidecar CSV so the chart grows beyond
+      # the 30-day window GHCR exposes). Runs after jgehrcke regenerates
+      # report.html on gh-pages.
+      - name: checkout-source
+        uses: actions/checkout@v4
+        with:
+          path: source
+
+      # jgehrcke/github-repo-stats commits to the `github-repo-stats`
+      # branch by default (NOT gh-pages — Pages is configured to serve
+      # from that branch). Direct git clone with the PAT surfaces real
+      # git stderr if anything fails, unlike actions/checkout@v4 which
+      # swallows errors as opaque "exit code 1".
+      - name: checkout-data-branch
+        env:
+          GH_PAT: ${{ secrets.GHRS_GITHUB_API_TOKEN }}
+        run: |
+          git clone --branch github-repo-stats --depth 1 \
+            "https://x-access-token:${GH_PAT}@github.com/${{ github.repository }}.git" \
+            data
+          cd data
+          git config user.name  "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: inject-ghcr-pulls
+        run: |
+          python3 source/.github/scripts/ghcr_inject.py \
+            --report data/maziggy/bambuddy/latest-report/report.html \
+            --csv    data/maziggy/bambuddy/ghcr-pulls.csv \
+            --owner  maziggy \
+            --pkg    bambuddy
+
+      - name: commit-and-push
+        working-directory: data
+        run: |
+          if [ -z "$(git status --porcelain)" ]; then
+            echo "no changes — skipping commit"
+            exit 0
+          fi
+          git add maziggy/bambuddy/latest-report/report.html \
+                  maziggy/bambuddy/ghcr-pulls.csv
+          git commit -m "ghcr-pulls: refresh container downloads chart"
+          git push
diff --git a/BACKERS.md b/BACKERS.md
new file mode 100644
index 000000000..09508cbcb
--- /dev/null
+++ b/BACKERS.md
@@ -0,0 +1,73 @@
+# Bambuddy Backers & Sponsors
+
+Bambuddy is sustainable thanks to people who put their money where their use is. This page lists everyone who supports the project on [GitHub Sponsors](https://github.com/sponsors/maziggy) or [Ko-fi](https://ko-fi.com/maziggy).
+
+If you'd like to support Bambuddy:
+
+- **GitHub Sponsors** (recurring, 5 tiers from $5/mo to $300/mo) — https://github.com/sponsors/maziggy
+- **Ko-fi** (one-time or recurring) — https://ko-fi.com/maziggy
+
+If you sponsor and your name isn't here within 48h, please write an email to martin@bambuddy.cool or open an Issue on the main repo.
+
+---
+
+## Corporate Sponsors ($300/mo+)
+
+- [@northpole3dprinting](https://github.com/northpole3dprinting)
+
+## Sustaining Sponsors ($150/mo+)
+
+*None yet.*
+
+## Patrons ($35/mo+)
+
+- [@VREmma](https://github.com/VREmma)
+- [@pwostran](https://github.com/pwostran)
+- [@Praxeis](https://github.com/Praxeis)
+- [@jmclaren7](https://github.com/jmclaren7)
+- [@RoBoT24-web](https://github.com/RoBoT24-web)
+- [@Rayvenhaus](https://github.com/Rayvenhaus)
+
+## Supporters ($15/mo+)
+
+- [@rewart01](https://github.com/rewart01)
+- [@rstocks](https://github.com/rstocks)
+- [@sixfootseven](https://github.com/sixfootseven)
+- [@MethodicalMartian](https://github.com/MethodicalMartian)
+- [@brianharwell](https://github.com/brianharwell)
+
+## Backers ($5/mo+)
+
+- [@aneopsy](https://github.com/aneopsy)
+- [@flom89](https://github.com/flom89)
+- [@grizz0blaw](https://github.com/grizz0blaw)
+- [@NoahTingey](https://github.com/NoahTingey)
+- [@sentinel-center](https://github.com/sentinel-center)
+- [@brianehlert](https://github.com/brianehlert)
+- [@siiruup](https://github.com/siiruup)
+- [@agntcoopersea](https://github.com/agntcoopersea)
+- [@PJMCL1618033](https://github.com/PJMCL1618033
+- [@mgf99](https://github.com/mgf99)
+- [@Geoff-S](https://github.com/Geoff-S)
+- [@andyspinball](https://github.com/andyspinball
+- [@avandeputte](https://github.com/avandeputte)
+- [@joeferrante](https://github.com/joeferrante)
+- [@GPop61](https://github.com)
+- [@CooleyMcCoolson](https://github.com/CooleyMcCoolson)
+- [@mikeloveridge](https://github.com/mikeloveridge)
+- [@boernie](https://github.com/boernie)
+- [@qoatzelcoat](https://github.com/qoatzelcoat)
+- [@Sanaki](https://github.com/Sanaki)
+- [@jlofshult](https://github.com/jlofshult)
+- [@TriadX1](https://github.com/TriadX1)
+- [@hazzardr](https://github.com/hazzardr)
+
+---
+
+## One-time and historical supporters
+
+A general thank-you to everyone who's contributed via Ko-fi over the past months. Specific names get added on request — if you'd like to be listed, ping `maziggy`.
+
+---
+
+Thanks. — Martin