badges / badges/shields

F-Droid downloads badge

Open
#11,338 3 comments 0 reactions 0 assignees View on GitHub
service-badge
Dominant language
JavaScript
Stars
27.2k
Forks
5.6k
Avg merge
1d 8h
Merged PRs (30d)
46

Description

### 📋 Description

F-Droid

Example for package [com.github.catfriend1.syncthingandroid](https://f-droid.org/packages/com.github.catfriend1.syncthingandroid/):
![Monthly Downloads badge](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgithub.com%2Fkitswas%2Ffdroid-metrics-dashboard%2Fraw%2Frefs%2Fheads%2Fmain%2Fprocessed%2Fmonthly%2Fcom.github.catfriend1.syncthingandroid.json&query=%24.total_downloads&style=for-the-badge&logo=fdroid&logoSize=auto&label=downloads%20last%20month)

Example for package [io.github.kitswas.virtualgamepadmobile](https://f-droid.org/packages/io.github.kitswas.virtualgamepadmobile/):
![Monthly Downloads badge](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgithub.com%2Fkitswas%2Ffdroid-metrics-dashboard%2Fraw%2Frefs%2Fheads%2Fmain%2Fprocessed%2Fmonthly%2Fio.github.kitswas.virtualgamepadmobile.json&query=%24.total_downloads&style=for-the-badge&logo=fdroid&logoSize=auto&label=downloads%20last%20month)

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](https://github.com/user-attachments/assets/9eed6dd6-4725-46e3-b606-5fbd8f5594f7)

### 🔗 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

```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.

Contributor guide

Open the contributing guide

Research direction

Start with the Shields documentation and the linked F-Droid metrics dashboard, especially the “badges via shields.io” section and the sample monthly JSON file. Confirm how the F-Droid endpoint and query should be supported, including zero-download responses, then verify that the resulting badge renders readable counts without a resource-not-found error.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
api
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.