Read-only pull mirror of github.com/ublue-os/countme. Aurora's build fetches badge-endpoints/aurora.json from here.
Find a file
github-actions[bot] 92ca39a56b
Some checks failed
CountMe Update / update-countme (push) Has been cancelled
Growth Chart Update 2026-11-03
2026-11-03 07:30:56 +00:00
.github/workflows fix: move away from deprecated syntax for job output 2026-10-26 20:00:37 +01:00
badge-endpoints Growth Chart Update 2026-10-29 2026-10-29 00:15:06 +00:00
.gitignore refactor: switch to polars (#87) 2026-01-21 14:18:20 +02:00
countme.py feat: add uCore CountMe metrics 2026-09-29 04:36:19 +00:00
data_processing.py style: use double quotes for consistency 2026-01-29 09:51:53 +01:00
generate_badge_data.py feat: add uCore CountMe metrics 2026-09-29 04:36:19 +00:00
graph.sh refactor: switch to polars (#87) 2026-01-21 14:18:20 +02:00
growth_aurora.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
growth_bazzite.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
growth_bazzite_purple.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
growth_bluefins.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
growth_global.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
growth_nonbazzite.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
growth_ublue.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
growth_ucore.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
growth_upstream.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
growth_upstream_with_bazzite.svg Growth Chart Update 2026-11-03 2026-11-03 07:30:56 +00:00
main.py refactor: switch to polars (#87) 2026-01-21 14:18:20 +02:00
README.md feat: add uCore CountMe metrics 2026-09-29 04:36:19 +00:00
renovate.json fix(deps): group Polars dependencies in Renovate PRs 2026-10-25 18:25:38 +01:00
requirements.in fix: drop unneeded dependencies 2026-01-29 09:51:53 +01:00
requirements.txt Merge pull request #169 from ublue-os/renovate/pillow-13.x 2026-11-03 08:30:09 +01:00
ublue.mplstyle Thicker lines 2025-04-07 21:03:36 +02:00

countme

How to run locally

git clone https://github.com/ublue-os/countme
cd countme
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
./graph.sh -d

Usage

  • ./graph.sh -d or ./graph.sh --download - Downloads fresh dataset and generates graphs
  • ./graph.sh - Generates graphs using existing dataset (skips download)

The dataset only changes once per day, so you typically only need to use the -d flag once per day to get fresh data.

Badge System

This repository generates Shield.io compatible badge endpoints that display active user counts for Universal Blue projects. Add user count badges to your repository using these Shield.io endpoint URLs:

Available Badges

uCore Users

View the uCore weekly active-device chart.

Markdown Code

Add these to your README.md:

![Aurora Users](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/ublue-os/countme/main/badge-endpoints/aurora.json)
![Bazzite Users](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/ublue-os/countme/main/badge-endpoints/bazzite.json)
![Bluefin Users](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/ublue-os/countme/main/badge-endpoints/bluefin.json)
![uCore Users](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/ublue-os/countme/main/badge-endpoints/ucore.json)

Badge Data Format

The system generates Shield.io compatible endpoint files:

  • badge-endpoints/aurora.json
  • badge-endpoints/bazzite.json
  • badge-endpoints/bluefin.json
  • badge-endpoints/ucore.json

Each file contains:

{
  "schemaVersion": 1,
  "label": "Active Users",
  "message": "15.2k",
  "color": "6c3fc4",
  "namedLogo": "linux",
  "logoColor": "white"
}