antonkomarev / github-profile-views-counter

It counts how many times your GitHub profile has been viewed. Free cloud micro-service.

GitHub Profile Views Counter

Introduction

Try Ÿ HŸPE service as the more robust and feature rich solution.

GHPVС project is proof of concept. This counter designed to be an analytical instrument for you, but not for people who are visiting your profile. It could be used to see profile views dynamics as result of development activity, blogging or taking part in a conference.

It counts how many times your GitHub profile has been viewed and displays them in your profile, for free.

Usage

Cloud solution launched as 100% free experience. Help me cut server costs if you like this service.

If you want to see big numbers in your profile, deploy a standalone solution to draw any views count you want without spamming our server. Everybody knows that any counters could be faked.

A billion fake profile views doesn't make you a very popular person, it makes you a person with a billion number in the counter.

Create GitHub profile repository

GitHub magic will happen as soon as you will create a new repository named equally to your username.

Live demo of my profile repository.

Add counter to GitHub profile

You need to add counter in README.md file in your profile repository via Markdown syntax:

![](https://komarev.com/ghpvc/?username=your-github-username)

NOTE: Don't forget to replace example your-github-username parameter with real value.

Make it personal

Color

You can use any valid HEX color or pick from a predefined set of named colors (blue is the default).

color	demo
brightgreen
green
yellow
yellowgreen
orange
red
blue
grey
lightgrey
blueviolet
ff69b4

Named color

![](https://komarev.com/ghpvc/?username=your-github-username&color=green)

Hex color

![](https://komarev.com/ghpvc/?username=your-github-username&color=dc143c)

NOTE: HEX colors should be used without # symbol prefix.

Styles

The following styles are available (flat is the default).

style	demo
flat
flat-square
plastic
for-the-badge

![](https://komarev.com/ghpvc/?username=your-github-username&style=flat-square)

Label

You can overwrite default Profile views text with your own label.

![](https://komarev.com/ghpvc/?username=your-github-username&label=PROFILE+VIEWS)

NOTE: Replace whitespace with + character in multi-word labels.

Base number

You can provide a base number to add to the counter. This is useful if you are migrating from another service.

For example, a user with 1000 views on another service who wants to migrate to GHPVC will use the following url to ensure the 1000 views are accounted for:

![](https://komarev.com/ghpvc/?username=your-github-username&base=1000)

Abbreviation

You can set the abbreviated parameter to true if you would like the counter to be abbreviated.

For example, a counter with 12345 views, will be displayed as 12.3K.

![](https://komarev.com/ghpvc/?username=your-github-username&abbreviated=true)

FAQ

Can I see detailed statistics?

This project provides minimalistic counter only. Use Ÿ HŸPE service if you want to get detailed info about:

• user profile views
• user followers history
• repository stars history
• repository traffic for longer than 14 days

How to reset counter?

To reset counter you should log in to the Ÿ HŸPE service, and then you will be able to reset counter on the https://yhype.me/ghpvc page.

Why does the counter increase every time the page is reloaded?

This is counter of profile views (page hits), not a counter of unique visitors. There is no way to get the username, browser user agent or IP address of the visitor because GitHub proxies all image URLs through the GitHub Camo service. In other words, we can only increment the counter for each request from the GitHub proxy server, we don't know who initiated it.

Are you making money on it?

No. Only spending it. Become a sponsor if you want it to keep running & receive new features.

Alternatives

• Ÿ HŸPE enhanced GitHub professional account statistics & analytics

License

• GitHub Profile Views Counter application is open-sourced software licensed under the MIT license by Anton Komarev.
• Eye Octicon hero image licensed under MIT license by GitHub, Inc.

🌟 Stargazers over time

github-profile-views-counter's Issues

Opt-out of hit count

As a normal visitor, I would like to be given the choice to opt-out from getting hits I made counted

Typo!

"lightgrey" is not valid but "lightgray" does work.

Please rename the colour, thanks :)

How to hidde the counter

Hi!

Is there any way to have this counter but avoid displaying it? Keeping it private?

Best

Profile views increment on visiting other links as well

The profile views are incrementing when a person himself/herself visit their own profile. Even apart from that, the profile views are incrementing when you are opening any other link on your account like explore, issues etc. So basically, everytime when you click on your mouse to visit any link on github, the views are incrementing. I think, they should only increment when someone visit the profile only.

XSS in label parameter

I was creating my readme and i thought why not test if a script tag would work here? hahaha. It worked.

https://komarev.com/ghpvc/?username=arthurfiorette&style=flat-square&color=add8e6&label=%3Cscript%3Ealert(%27script%20with%20spaces!%27)%3C/script%3E

I haven't tested it much, but sometimes the server returns a 500 error, like when there is invalid html and so on. maybe it won't go anywhere, but it needs a check.

[Feature suggestion] Timeline counter view

It would be nice if their was a time line (like contributions timeline on Github repo) where a use could see a timeline of the number of visitors on a GitHub profile such as per month or per year.

This could be a better indication of profile traffic vs total view count all time.

If there is another free service let know otherwise :)

Adding new style for the badge?

Can you please add for-the-badge style for the badges?

Format number?

What do you think about the format number in the views counter?

2938 => 2,938?

There occurs a problem with the display of the icon

Description

I have been using github-profile-views-counter to count my page views for a long time. Yesterday I discovered that there was an error in the icon display.

Detail

The code I use

<p align="center">
  <a href="https://github.com/lim-yoona">
    <img src="https://komarev.com/ghpvc/?username=limyoona&color=blue&style=flat)" />
  </a>
</p>

and using markdown code also has the same effect.

Please make a github repo views counter!!!

[Bug] Switching between tabs on profile page increases the profile view counter by 3

On profile page, if you switch tab say from Overview to Repository and come back to Overview tab, you'll see counter of profile view is increased by 3.

Not sure about the feasibility, but it should increase by one only.

Condensed Counter View?

Noticed that the counter "shrunk" all of a sudden. I was at 2k views, nothing crazy big for the container to suddenly overflow. Attached screenshot below

[Enhancement]Counts a person's own view as well.

Hi Anton,

You have made a great project but I think with one enhancement it would be perfect. The counter considers the user's own count as well. Would it be possible to clone this project to another repo and make a slight enhancement to it? Or if you can incorporate the enhancement in the same repo it would be very helpful.

I am a novice in programming so apologizing beforehand if this issue is laughable 🍡

How to set the initial value

As I am migrating from another service, I would appreciate having an initial value set up.
Does it support this feature?
Thanks~

Add docker container to run service

Profile viewed zeroed

after the yesterdays issue my view count resetted. is anyone else experienced same issue?

profile views

for every refresh from same machine, i have seen profile views getting incremented,
not a big issue at all,
its maybe work as expected,
just want, you to know!!!
(we can check ip address and then only increment)

Thanks,
Ashish

Website down?

Badge doesn't show up for me and the website is not available aswell

Adding a way for people to reset their own badge

Would it be possible to add a way for people to reset their badge? Authentication could be done using OAuth2 to make sure people only can reset their own badges.

This would be useful for example if you edit your readme a lot, and go back and fourth between the editor and preview tab. Each time you then go to the preview tab it increases the counter. That's why my counter is approaching 100, even though im likely only at like 5 (10 if im lucky)

Can you please explain how you are counting the numbers of visitor

Hey @antonkomarev Thanks for amazing trick of markdown.

I am new to github don't have idea how things happen but curious about them.
Could you please explain the actual processing how you keep track on count do you use sql and php or anyhthing else.

Bug it counts everytime I reloads the page

It counts my visitings also and the main problem as soon as I reloads the page it increases, but it have to remain same until a new GitHub user comes

Profile views tag increments everytime

This can be seen even on opening or reloading my own profile , it needs improvement.

[Feature Suggestion] Ability to change the text's colour as well

For example, I have this color of green which might be too bright and difficult to read whereas having a darker text colour might be easier to read.

Maybe passing in an addition argument such as &text_color=0D1117 to the URL makes the text that colour.

How to ignore own profile views?

Currently, the GitHub profile view counter increases counter by one when a user reloads his GitHub profile page. For more accurate counter it should exclude profile views by the owner of the GitHub repository.

Error fetching resource

Is the link down?
Image not showing up?

<img src="https://komarev.com/ghpvc/?username=impratik7&label=Profile%20views&color=0e75b6&style=flat" alt="impratik7" />

View Count Icon is shrinked

There is some issue with view count icon as actual view count is not visible.

[Feature suggestion] Add new style for social: `?style=social`

You currently have these styles, and they are very useful:

style	demo
flat
flat-square
plastic
for-the-badge

However, shields.io has one other style available: social. See more info here.

For example:

style	demo
flat
flat-square
plastic
for-the-badge
social

But when I try to use this for Profile Views:
![](https://komarev.com/ghpvc/?username=chrimaho&style=social)

Can you please also add this ?style=social function to your repo?

Thank you!

YHYPE Website down?

I've tried visiting https://yhype.me on many devices and it doesn't seem to be online whenever I try. My browser keeps saying the server took too long to respond. Do you have any insight or am I missing anything?

view count reset to zero

A few days ago, the view count was still 8k, but today I found that it has been reset, and I have not changed any settings and styles

Expand the container when the views exceed the 3-digit number

Expand the container when the views exceed the 3-digit number (>100).

Write console command to re-calculate counter aggregate value

After fix (by @Brikaa) of counter reset because of the race condition (#66) we need to create console command which will re-calculate correct counter values. It should count lines in storage/{username}-views file and store them to storage/{username}-views-count.

Something like:

cat storage/{username}-views | wc -l | tr -d ' ' > storage/{username}-views-count

But we should iterate thru all the usernames in the storage directory. There are many counter files, so ls -la is hanging for a long time.

One more thing to ensure: we need to make -1 from wc -l, because of the empty line at the end of file.

Badge displays weirdly on Edge

When viewing the Profile Views badge in Edge is there a odd gap between the "e" and "w" of "views". (See image)

I doubt that it's a browser thing,

Image Not Showing

https://camo.githubusercontent.com/d623505e1cfd15c17382a974e808708e996776ed7cabc5780ca50600cc5df7c1/68747470733a2f2f6b6f6d617265762e636f6d2f67687076632f3f757365726e616d653d72697a6b797465676172266c6162656c3d72697a6b7974656761722b70726f66696c652b76697369746f72

Is it an error?

when I open the url above it will display a message like this.

Error Fetching Resource

it also doesn't show up on my profile

   <img src="https://komarev.com/ghpvc/?username=rizkytegar&label=rizkytegar+profile+visitor">

Only showing broken image icon

Attempting to use <div align="center"> seems to break it

works fine when copy and pasted as it is said in the guide, but when I add

in the line above and

in the line below, it seems to break the counter. is this a known issue?

Free public hosting

Does anybody knows a good stable free public cloud database which can hold this service data? Right now it requires 40GB+.

[Design flaw] Kerning for the 'w' in "Profile views" text is messed up

Here's an example of my profile views badge as of today (1/23/2022 @ 5:53 AM PST):

• 

Underlined is where the issue occurs:

• 

As you can see, for some reason, more space has been added to the left of the 'w', causing it to also intersect the 's' in the word "views".

Adding the for-the-badge design

It could be cool if we could have the for-the-badge design for this profile views badge

[BUG] The counter resets?

1 - A week ago I had the counter around 2000-2250 views, then for some reason it appeared with only 2, I think this started when I changed the style to for-the-badge

2 - I have also noticed that when you refresh the page with the counter it increases x2, that is, if you have 2 views, and you update you will then have 4, then 6, and so on...

Counter issue

The views counter raising rapidly!

Reset the counter

I want to know if there's a way to reset the counter.

SSL Certificate Invalid/Expired

GitHub no longer displays view counter badges due to a problem with komarev.com's SSL certificate. Chrome throws the NET::ERR_CERT_DATE_INVALID error. Pretty sure the certificate expired.

Profile view counter is down

Hi Komarev,
Thanks for this project. The project is down, profile views counter badge is not showing up in the Readme because http://komarev.com is down too. Can you please look into it.

Thanks.

[Request] Ability to set logo to the left of badge

Description

Add the functionality of adding a logo to the left side of a badge (exactly how shields.io implements it)

Race condition vulnerability causes counter reset

A user's counter can be reset by spamming requests, this happens due to a race condition while truncating and writing to a file. The following NodeJS script can be used to reset a user's counter:

// Send requestsPerBulk requests in parallel (let's call that a bulk)
// Wait till they are done
// Repeat till a total of bulks * requestsPerBulk requests

// After each bulk, output the number of succeeded requests and the number of failed requests
(async () => {
  const url = process.argv[2];
  const bulks = parseInt(process.argv[3]);
  const requestsPerBulk = parseInt(process.argv[4]);
  const headers = new Headers();
  headers.append('User-Agent', 'github-camo');
  for (let i = 0; i < bulks; ++i) {
    const promises = [];
    console.time('bulk');
    for (let j = 0; j < requestsPerBulk; ++j) {
      promises.push(fetch(url, { headers }));
    }
    const results = await Promise.all(promises);
    const failed = results.filter((res) => res.status >= 400).length;
    console.log(`Bulk ${i}:- failed: ${failed}, succeeded: ${requestsPerBulk - failed}`);
    console.timeEnd('bulk');
    await new Promise((r) => setTimeout(r, 500));
  }
})();

Run it as

node script_name.js ghpvc_url 50 20

and observe the counter, it will reset at a certain point in time.

Here is an explanation of the race condition that happens according to my understanding:
Requests need to do the following:

• Read file, increment number
• Truncate file
• Put incremented number

The following race can happen between two requests (A and B):

• A: read file, increment number
• A: truncate file
• B: read file, increment number (oops read empty file, number is zero, incremented number is one!)
• A: put incremented number
• B: truncate file
• B: put incremented number (oops put one!)

This can be fixed by using a lock on the views-count file or by migrating to using a database management system that automatically handles concurrency issues.

Add support for for-the-badge style

It would be great to add for-the-badge styled output :)

Visitors are not unique

After refresh

Adding a session style system would be great! I have worked on it, but since i have no clue which file is the one every user goes too i added session_start to every file ! Please tell me if some of the files don't require this , and thanks to you and the great PHP community!
The best of luck

Adjust the font size

Thank you for this repo! Simple and professional. I am making my img tag larger to fit better with my readme, but I was wondering if it is possible to implement a font size feature.

Thanks again!

Server error while trying to sign up

Hi,

I'm trying to sign up but get a SERVER ERROR message displayed

I'm not sure what to do from there. I tried incognito mode, without browser extension but the same happens.

Thanks in advance

500 SERVER ERROR

When attempting to access the page of https://yhype.me/, I frequently encounter a "500 Server Error." This issue seems to be occurring consistently in these two days.

[Feature suggestion] Ability to change label color

As far as I know there is no way to change the label color (left part).

I think it might be a great feature to be able to add &label_color=FFFFFF to further customize the counter.
FFFFFF: the value of the color in hex.