HrBDev / metrics

📊 An infographics generator with 30+ plugins and 200+ options to display stats about your GitHub account and render them as SVG, Markdown, PDF or JSON!

📊 Metrics

Generate metrics that can be embedded everywhere, including your GitHub profile readme! Supports users, organizations, and even repositories!

For user accounts	For organization accounts
🧩 Customizable with 46 plugins and 329 options!
📅 Isometric commit calendar	🈷️ Languages activity
Full year calendar Half year calendar	Indepth analysis (clone and analyze repositories) Recently used (analyze recent activity events) Default algorithm Default algorithm (with details)
✨ Stargazers	👨‍💻 Lines of code changed
Classic charts Graph charts Worldmap	Repositories and diff history Compact display in base plugin
📌 Starred topics	🌟 Recently starred repositories
With icons With labels
📜 Repository licenses	💡 Coding habits and activity
Permissions, limitations and conditions Licenses overview	Recent activity charts Mildly interesting facts
🏅 Repository contributors	🎟️ Follow-up of issues and pull requests
By contribution types By number of contributions	Indepth analysis Created on a user's repositories Created by a user
🎭 Comment reactions	🧑‍🤝‍🧑 People
	Related to a user Related to a repository
💝 GitHub Sponsorships	💕 GitHub Sponsors
	GitHub sponsors card GitHub sponsors full introduction
📓 Featured repositories	💬 Discussions
Featured Pinned
💫 Star lists	📆 Commit calendar
Repositories from star lists Languages from star lists	Current year Full history
🏆 Achievements	🎩 Notable contributions
Compact display Detailed display	Indepth analysis Contributions in organizations only
📰 Recent activity	🧮 Repositories traffic
♐ Random code snippet	🎫 Gists
🗂️ GitHub projects	🙋 Introduction
	For a user or an organization For a repository
🌇 GitHub Skyline	⏱️ Google PageSpeed
GitHub Skyline GitHub City	PageSpeed scores PageSpeed scores with detailed report PageSpeed scores with a website screenshot
🗨️ Stack Overflow	🌸 Anilist watch list and reading list
	For anime watchers For manga readers For waifus simp
🎼 Music activity and suggestions	✒️ Recent posts
Random tracks from a playlist Recently listened	Latest posts width description and cover image Latest posts
🗼 Rss feed	⏰ WakaTime
🗳️ Leetcode	🕹️ Steam
	Recently played games Profile and detailed game history
🎲 See also community plugins
🧠 16personalities by @lowlighter Render example	♟️ Chess by @lowlighter Render example
🥠 Fortune by @lowlighter Render example	💉 Nightscout by @legoandmars Render example
💩 PoopMap plugin by @matievisthekat Render example	📸 Website screenshot by @lowlighter Render example
🦑 Splatoon by @lowlighter Render example	💹 Stock prices by @lowlighter Render example
🖼️ And even more with 4+ templates!
📗 Classic template	📘 Repository template
📙 Terminal template	📒 Markdown template
📕 See also community templates
🦑 Try it now!
📊 Metrics embed	✨ Metrics insights
Embed metrics images on your profile or blog! Use GitHub actions for even more features!	Share your metrics with friends and on social medias! No configuration needed!
Test latest features and patches on 🧪 Metrics beta!
Power user? Fork this repository and edit HTML, CSS, JS and EJS for even more customization!

📚 Documentation

^{⚠️ This is the documentation of v3.34-beta (@master/@main branches) which includes unreleased features planned for next release. See documentation for current released version v3.33 (@latest branch) here.}

🦮 Setup

There are several ways to setup metrics, each having its advantages and disadvantages:

• ⚙️ Using GitHub Action on a profile repository (~10 min)
  • ✔️ All features
  • ✔️ High availability (no downtimes)
  • ➖ Configuration can be a bit time-consuming
• 💕 Using the shared instance (~1 min)
  • ✔️ Easily configurable and previewable
  • ➖ Limited features (compute-intensive features are disabled)
• 🏗️ Deploying a web instance (~20 min)
  • ✔️ Create another shared instance
  • ➖ Requires some sysadmin knowledge
• 🐳 Using command line with docker (~2 min)
  • ✔️ Suited for one-time rendering
• 🔧 Local setup for development (~20 min)

Additional resources for setup:

• 🏦 Configure metrics for organizations
• 🏠 Run metrics on self-hosted runners
• 🧰 Template/Plugin compatibility matrix

🖼️ Templates

Templates lets you change general appearance of rendered metrics.

• 📗 Classic template _classic
• 📘 Repository template _repository
• 📙 Terminal template _terminal
• 📒 Markdown template _markdown
• 📕 Community templates _community

🧩 Plugins

Plugins provide additional content and lets you customize rendered metrics.

📦 Maintained by core team

• Core plugins
  • 🗃️ Base content _base
  • 🧱 Core _core
• GitHub plugins
  • 🏆 Achievements _achievements
  • 📰 Recent activity _activity
  • 📆 Commit calendar _calendar
  • ♐ Random code snippet _code
  • 🏅 Repository contributors _contributors
  • 💬 Discussions _discussions
  • 🎟️ Follow-up of issues and pull requests _followup
  • 🎫 Gists _gists
  • 💡 Coding habits and activity _habits
  • 🙋 Introduction _introduction
  • 📅 Isometric commit calendar _isocalendar
  • 🈷️ Languages activity _languages
  • 📜 Repository licenses _licenses
  • 👨‍💻 Lines of code changed _lines
  • 🎩 Notable contributions _notable
  • 🧑‍🤝‍🧑 People _people
  • 🗂️ GitHub projects _projects
  • 🎭 Comment reactions _reactions
  • 📓 Featured repositories _repositories
  • 🌇 GitHub Skyline _skyline
  • 💕 GitHub Sponsors _sponsors
  • 💝 GitHub Sponsorships _sponsorships
  • ✨ Stargazers _stargazers
  • 💫 Star lists _starlists
  • 🌟 Recently starred repositories _stars
  • 💭 GitHub Community Support _{support ⚠️ deprecated}
  • 📌 Starred topics _topics
  • 🧮 Repositories traffic _traffic
• Social plugins
  • 🌸 Anilist watch list and reading list _anilist
  • 🗳️ Leetcode _leetcode
  • 🎼 Music activity and suggestions _music
  • ⏱️ Google PageSpeed _pagespeed
  • ✒️ Recent posts _posts
  • 🗼 Rss feed _rss
  • 🗨️ Stack Overflow _{stackoverflow}
  • 🕹️ Steam _steam
  • 🐤 Latest tweets _{tweets ⚠️ deprecated}
  • ⏰ WakaTime _wakatime

🎲 Maintained by community

• Community plugins
  • 🧠 16personalities _{16personalities} by @lowlighter
  • ♟️ Chess _chess by @lowlighter
  • 🥠 Fortune _fortune by @lowlighter
  • 💉 Nightscout _nightscout by @legoandmars
  • 💩 PoopMap plugin _poopmap by @matievisthekat
  • 📸 Website screenshot _screenshot by @lowlighter
  • 🦑 Splatoon _splatoon by @lowlighter
  • 💹 Stock prices _stock by @lowlighter

💪 Contributing

If you are interested in contributing, the following resources may interest you:

• 💪 Contribution guide
• 🧬 Architecture
• 📜 License
• GitHub resources
  • 📖 GitHub GraphQL API
  • 📖 GitHub GraphQL Explorer
  • 📖 GitHub Rest API
  • 📖 GitHub Octicons

Use 💬 discussions for feedback, new features suggestions, bugs reports or to request help for installation.

📜 License

MIT License
Copyright (c) 2020-present lowlighter