A free, lightweight visitor counter badge for your GitHub README, Issues, and Wiki pages.
One line of Markdown. No sign-up. No tracking. Just a badge.
Quick Start · Parameters · Examples · Self-host · 中文
Add this line to your README.md:
Replace yourname.yourrepo with a unique identifier for your page. Done.
All parameters are optional except page_id.
| Parameter | Required | Description | Default |
|---|---|---|---|
page_id |
✅ | Unique identifier for your page | — |
left_text |
— | Left-side label | visitors |
left_color |
— | Left side color (name or hex) | #595959 |
right_color |
— | Right side color (name or hex) | #1283c3 |
format |
— | Compact number display (1K / 1M) | disabled |
logo |
— | Built-in local logo slug from the Simple Icons catalog | — |
radius |
— | Badge corner radius (px) | 3 |
height |
— | Badge height (px), scales proportionally | 20 |
query_only |
— | Query without incrementing counter | disabled |
Note: For hex colors with
#, URL-encode#as%23.
Example:#595959→%23595959
Default style
Custom colors
Custom label
Compact format (1K / 1M)
Built-in logo
Example values: github, gitlab, vercel, docker, npm, discord, x, githubactions, netlify, cloudflare, telegram, wechat, youtube, react, vite, vuedotjs
Browse the full local catalog in the online builder.
Query only (don't increment)
Combo: all together
<img src="https://visitor-badge.laobi.icu/badge?page_id=yourname.yourrepo" alt="visitor badge">Clone the repo, install dependencies, and run:
git clone https://github.com/hehuapei/visitor-badge.git
cd visitor-badge
pip install -r requirements.txt
# Set your count API endpoint in main.py
python3 main.pyRequires a compatible counting backend. The project expects a count service at a configurable endpoint. See main.py for details.
- ✅ Free & no registration
- ✅ Custom colors (left & right)
- ✅ Custom label text
- ✅ Compact number format (1K / 1M)
- ✅ Query-only mode (no count increment)
- ✅ Daily data backup
- ✅ Lightweight SVG response
💖If this project helps you, consider supporting its development:
Forked from jwenjian/visitor-badge with optimizations and updated infrastructure.