Repolode
Submit
antonkomarev

antonkomarev/github-profile-views-counter

A free hosted service that shows a GitHub profile view counter as an image you embed in your profile README.

View on GitHubWebsite
Stars
5,067
Forks
430
Open issues
15
Last commit
8 days ago

What is it?

GitHub Profile Views Counter is a free cloud micro-service that counts how many times a GitHub profile has been viewed and renders the count as an image. You add a Markdown image tag pointing to the service in your profile repository's README, and the number updates as visitors load the page.

The counter is customizable through URL parameters: you can choose a named or HEX color, one of several badge styles, a custom label, a base number to carry over from another service, and an abbreviated display format such as 12.3K. A pixel style hides the counter visually while still tracking views.

The project counts page hits rather than unique visitors, since GitHub proxies image requests through its Camo service and the visitor's identity is not available. The author notes it is a minimal counter only; detailed statistics are offered by a separate paid-tier service, Ÿ HŸPE.

Key features

  • 01Displays a profile view count as an embeddable Markdown image.
  • 02Supports named colors and custom HEX colors.
  • 03Offers flat, flat-square, plastic and for-the-badge styles.
  • 04Allows custom labels and a base number for migrating counts.
  • 05Can abbreviate large numbers, for example 12345 as 12.3K.

Use cases

  • Adding a visible view counter to a GitHub profile README.
  • Tracking how profile traffic changes around releases, blog posts or conference talks.
  • Migrating a view count from another counter service by setting a base number.

Quick start

  1. 1

    Create a repository named after your GitHub username

  2. 2

    Add the counter image Markdown to the README.md of that repository

Things to know

  • It counts page hits from GitHub's image proxy, so reloads increase the count and unique visitors are not tracked.
  • It is a minimal counter only, with no detailed statistics.
  • The cloud service is free but depends on the maintainer's sponsorship to keep running.

In collections

Static site generators & documentation tools

Topics

#github-profile#analytics#counter#profile-readme#markdown#badge#gh#github#github-analytics#github-counter

FAQ

What is github-profile-views-counter?
A free hosted service that shows a GitHub profile view counter as an image you embed in your profile README. GitHub Profile Views Counter is a free cloud micro-service that counts how many times a GitHub profile has been viewed and renders the count as an image. You add a Markdown image tag pointing to the service in your profile repository's README, and the number updates as visitors load the page.
Is github-profile-views-counter free to use? What license does it have?
github-profile-views-counter is open source under the MIT license. Check the license terms before using it in commercial products.
Is github-profile-views-counter still maintained?
Actively maintained. The last commit to github-profile-views-counter was on Oct 30, 2026.
What can I use github-profile-views-counter for?
Adding a visible view counter to a GitHub profile README. Tracking how profile traffic changes around releases, blog posts or conference talks. Migrating a view count from another counter service by setting a base number.
How do I install github-profile-views-counter?
Create a repository named after your GitHub username Add the counter image Markdown to the README.md of that repository
Where can I get github-profile-views-counter?
The source code and installation instructions are on GitHub: https://github.com/antonkomarev/github-profile-views-counter

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects

badges / shields

Shields.io is a service and NPM library that generates concise SVG and raster status badges for README files and web pages.

DevOps & Cloud#badge#svg#status-badge
27.4K+23 this week5.6KJavaScriptApache-2.0Well maintainedUpdated yesterday