shields icon indicating copy to clipboard operation
shields copied to clipboard

F-Droid downloads badge

Open kitswas opened this issue 3 months ago • 2 comments

📋 Description

F-Droid

Example for package com.github.catfriend1.syncthingandroid:
Monthly Downloads badge

Example for package io.github.kitswas.virtualgamepadmobile:
Monthly Downloads badge

These are dynamic badges. The larger numbers are not easily readable.

Also, the dynamic badge shows resource not found if there are zero downloads. Image

🔗 Data

Documentation: https://github.com/kitswas/fdroid-metrics-dashboard/?tab=readme-ov-file#badges-via-shieldsio

Example of data file: https://github.com/kitswas/fdroid-metrics-dashboard/blob/main/processed/monthly/com.termux.json

{
  "package_id": "com.termux",
  "total_downloads": 505603,
  "api_hits": 35908,
  "versions": 7,
  "search_count": 241
}

🎤 Motivation

All other major distribution centres have a download count.

Time to add F-Droid to the list.

kitswas avatar Sep 06 '25 13:09 kitswas

Hello @kitswas 👋🏻 Is there no way to retrieve this information via an official API?

PyvesB avatar Sep 14 '25 11:09 PyvesB

Is there no way to retrieve this information via an official API?

@PyvesB Not to my knowledge.
They publish raw numbers which I crunch into these metrics via a Python script. (Daily Cron job running on GitHub Actions)

There is no official API, only published JSON data files, updated weekly. https://fdroid.gitlab.io/metrics/

kitswas avatar Sep 14 '25 11:09 kitswas