journey-ad/Moe-Counter
Moe Counter
Moe-Counter is a self-hosted page view tracker that renders visitor counts as dynamically generated SVG badges with anime-themed styling. It operates as a lightweight Node.js HTTP service that associates each unique counter name in a URL with a stored page view count, providing a customizable alternative to third-party analytics services.
The service is designed for flexible deployment, running either directly from source with pnpm dependency management or as a pre-built Docker image from GitHub Container Registry. Runtime configuration is handled entirely through environment variables set in a .env file, allowing adjustments to the port and database backend without code changes. The counter's appearance is controlled through URL query parameters, enabling selection from dozens of anime-themed visual themes and fine-tuning of padding, offset, scale, alignment, and pixelation effects.
The project supports multiple database backends selected at runtime for persistent visit counting, and its SVG-based rendering approach allows the counter badge to be embedded directly into web pages. Documentation covers both source-based and containerized deployment paths, with configuration options documented through the environment variable and query parameter interfaces.