Homebrew
Badges for Homebrew formulae and casks — version, installs.
Display live stats for Homebrew formulae and casks.
Formula (branded)
Cask (branded)
Downloads (branded)
Formula (secondary)
Cask downloads
Formula (outline)
Available badges
| Badge | Endpoint | Description |
|---|---|---|
| Formula Version | /homebrew/{formula} | Latest stable version |
| Cask Version | /homebrew/cask/{cask} | Latest cask version |
| Installs | /homebrew/installs/{formula}[/{days}] | Install count (30/90/365 days) |
| Formula Downloads | /homebrew/dm/{formula} | Monthly/quarterly/yearly downloads |
| Cask Downloads | /homebrew/cask-dm/{cask} | Monthly/quarterly/yearly cask downloads |
Quick examples
GET/homebrew/:formula.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/homebrew/node.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/homebrew/node.svg?mode=light"></picture>
Data source
Uses Homebrew Formulae API. No API key required. Cached 1 hour.
Endpoint details
Use these sections when you need the exact URL shape or a focused example for a specific badge type.
Homebrew Downloads
This section covers the homebrew/downloads badge endpoint.
Show install counts for Homebrew formulae and casks over different time periods.
GET/homebrew/dm/:formula.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/homebrew/dm/node.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/homebrew/dm/node.svg?mode=light"></picture>
URL formats
Formula downloads
/homebrew/dm/{formula}.svg/homebrew/dq/{formula}.svg/homebrew/dy/{formula}.svgMonthly (dm), quarterly (dq), or yearly (dy) install counts for a formula.
Cask downloads
/homebrew/cask-dm/{cask}.svg/homebrew/cask-dq/{cask}.svg/homebrew/cask-dy/{cask}.svgMonthly (cask-dm), quarterly (cask-dq), or yearly (cask-dy) install counts for a cask.
Examples
Formula monthly (branded)
Formula yearly
Cask monthly (branded)
Cask yearly (outline)
Copy-paste examples
Default — monthly installs for a formula
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/homebrew/dm/node.svg?mode=dark"><img alt="homebrew downloads" src="https://shieldcn.dev/homebrew/dm/node.svg?mode=light"></picture>Branded — monthly installs for a cask
Yearly installs for a formula
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/homebrew/dy/node.svg?mode=dark"><img alt="homebrew yearly" src="https://shieldcn.dev/homebrew/dy/node.svg?mode=light"></picture>Interval reference
| Code | Period | Description |
|---|---|---|
dm | Monthly | Last 30 days |
dq | Quarterly | Last 90 days |
dy | Yearly | Last 365 days |