English · 中文 · 日本語

A themeable visitor counter for your GitHub README, blog, or website. Choose a character, copy the embed code, and you're ready to go. Static themes can pick a random frame or combine character layers on each request.

Get started

1. Open lolicount.top.
2. Enter a counter name, choose a theme, and generate your counter.
3. Copy the Markdown or HTML code into your page.

Use your own name in place of my-counter below. The same name shares one count across all embeds.

GitHub README / Markdown

![Visits](https://lolicount.top/@my-counter?theme=lian-ren&fsize=16&scale=0.6)

Website / HTML

<img src="https://lolicount.top/@my-counter?theme=lian-ren&amp;fsize=16&amp;scale=0.6" alt="Visits" />

Image URL: open the example, or copy its address into any field that accepts an image URL.

For GitHub READMEs, choose an SVG theme. E-mote, Spine, and Live2D themes use the website widget code generated on the site and require JavaScript.

Customize

Adjust the URL parameters, or use the online generator to preview changes:

Parameter	What it does	Example
theme	Character theme; random picks a random SVG theme	theme=lian-ren
scale	Image scale, from 0.1 to 4; default 1	scale=0.6
fsize	Counter font size in pixels, from 0 to 500; 0 uses the default	fsize=16
number	Display a fixed value without counting, from 1 to 999999; omit for real counts	number=12345

For a preview without counting, replace the name with demo. It displays 0123456789 unless number is set.

See the full parameter reference for font styles and text positioning, or the FAQ for troubleshooting.

Self-host

Start with Docker:

docker run -d --name lolicount --restart unless-stopped -p 9721:9721 -v lolicount-data:/app/data ghcr.io/miaoledor/lolicount:latest

Open localhost:9721 to generate counters. Data is saved in the lolicount-data volume. Run a single instance; when using a public domain, set BASE_URL to that origin, such as https://counter.example.com.

See the deployment guide for Docker Compose, configuration, and binary builds.

Local development

With Go 1.25+, Node.js 22+, and pnpm 11 installed, run these commands from the repository root:

pnpm install
pnpm dev

Open localhost:3721 for the frontend. The backend runs at 127.0.0.1:9721.

Contribute & support

• Contributing · Add a theme · Contribute code
• Documentation · Architecture · Roadmap
• Theme contributions are accepted only through repository pull requests; see Add a theme.
• Buy the author a milk tea 🧋

Thanks to kun-galgame-forum and Moe-Counter.

Licensed under AGPL-3.0.