app-store-download-count-badge-maker
A command-line tool to create badges displaying the number of app downloads from App Store
Installation
$ pip install app-store-download-count-badge-maker
or
$ pipx install app-store-download-count-badge-maker
Required
- Python 3.10 or later
Features
- Generate badges for the App Store download count.
app-store-download-count-badge-maker generatecommand.
- Generate index.html from config.yml.
app-store-download-count-badge-maker make-indexcommand.
Usage
$ app-store-download-count-badge-maker generate \
--config config.yml \
--output dist
By default, the --config (or -c) option is set to config.yml and the --output (or -o) options is set to dist.
[!NOTE] The count is based on 3 days prior to the execution date.
Configuration
Create a configuration file in YAML format.
The recommended name is config.yml.
Configuration Details
The configuration file config.yml should contain the following sections:
secrets: This section holds the credentials required to access the App Store Connect API.private_key: Path to the private key file (e.g.,private.p8). The private key must have access Finance.issuer_id: The issuer ID from App Store Connect.key_id: The key ID from App Store Connect.vendor_number: The vendor number associated with your App Store account. View payments and proceeds
apps: A list of applications for which you want to create download count badges.apple_identifier: The unique identifier for the app in the App Store.frequency: The frequency at which you want to generate the badge. Must be one ofDAILY,WEEKLY,MONTHLY,YEARLY.badge_style(Optional): The style of the badge. Must be one offlat(default),flat-square,plastic,for-the-badge,social.
Example Configuration
secrets:
private_key: private.p8
issuer_id: 12345678-1234-1234-1234-123456789012
key_id: 12345678
vendor_number: 12345678
apps:
- apple_identifier: 1289764391
frequency: MONTHLY
- apple_identifier: 1234567890
frequency: WEEKLY
badge_style: flat-square
Badge Creation :sparkles:
This tool uses Shields.io to create badges displaying the number of app downloads from App Store.
Examples
| Frequency | Badge Style |
|---|---|
| YEARLY |      |
| MONTHLY |      |
| WEEKLY |      |
| DAILY |      |
Projects using app-store-download-count-badge-maker
License
This software is licensed under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for app-store-download-count-badge-maker 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| app_store_download_count_badge_maker-0.4.0.tar.gz | 9.7 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| app_store_download_count_badge_maker-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 20.1 kB
Release files / app_store_download_count_badge_maker-0.4.0.tar.gz
| Download URL | app_store_download_count_badge_maker-0.4.0.tar.gz |
|---|---|
| Size | 9.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a510670c6f08589bc938c615a0ccf5fa9a0b2a0932b50a2981f01915f8b22e6e
|
|
BLAKE2b-256 checksum How to use checksums |
80af0e41078ba1944ed3e413b2971bc7308f988bb0621155022802230d26a9c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2025.
Transparency logRelease files / app_store_download_count_badge_maker-0.4.0-py3-none-any.whl
| Download URL | app_store_download_count_badge_maker-0.4.0-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9b026f313e3ce202157f699084a06a38e57663f0096a043db4c3fa6f2e81617c
|
|
BLAKE2b-256 checksum How to use checksums |
eecc57a046c1239ac1c9ad95a4a2d7aa0280007f140c23ae370faa9e7e7e70d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2025.
Transparency logSecurity for app-store-download-count-badge-maker 0.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for app_store_download_count_badge_maker-0.4.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2025.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
