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.
Features
- Page View Tracking - Tracks and displays page view counts on web pages with a self-hosted SVG badge.
- Anime-Themed Counters - Displays a customizable SVG counter badge with anime styling to track page views or visitor counts.
- Anime-Themed Counters - An SVG badge that displays page view counts with customizable anime-style visual themes and layout options.
- Anime-Styled Badges - Tracking website visitor counts with a customizable anime-styled SVG badge that displays page view totals.
- URL-Keyed Counters - Associates each unique counter name in the URL with a separate page view count stored in the database.
- Query-Parameter-Driven Configurations - Adjusts counter appearance and behavior entirely through URL query parameters without server-side configuration files.
- Customizable SVG - Adjusting the appearance of a counter badge through query parameters for padding, offset, scale, alignment, and pixelation.
- Counter Badges - An SVG generator that produces counter badges with adjustable padding, offset, scale, alignment, and pixelation effects.
- Environment-Configurable Web Services - Provides a web service whose port and database backend are fully configured through a .env file.
- SVG Renderers - Renders visitor counts as dynamically generated SVG images with anime-themed styling applied through query parameters.
- Environment Variable Configuration - Loads runtime settings like port and database type from a .env file for flexible deployment without code changes.
- Counter Services - A containerized counter service that runs in Docker with configurable environment variables and database backends.
- Docker Container Deployments - Packages the service as a pre-built Docker image for containerized deployment via GitHub Container Registry.
- Counter Display Adjusters - Controls the counter image's padding, offset, scale, alignment, pixelation, and dark mode through query parameters.
- Anime-Themed Counter Themes - Changes the visual style of the counter image by selecting from dozens of anime-themed themes via a query parameter.
- Anime-Themed - Changing the visual style of a counter image by selecting from dozens of anime-themed themes via a query parameter.
- Node.js - Listed in the “Node.js 项目” section of the Great Open Source Project awesome list.
