ghstars

Do you want to know how many stars you have? or want to know how many stars another user has? ghstars provides that little functionality for ya!

If you create your own GitHub Access Token you can calculate all of your repo stargazers count too!

All you need is to set GITHUB_ACCESS_TOKEN environment variable if you want to fetch all of your repo’s star count!

Installation

go install github.com/vigo/ghstars@latest

or, you can install from brew:

brew install vigo/ghstars/ghstars

Usage

You can check command help:

ghstars -h

ghstars fatih                # public stars count of fatih user
ghstars tj                   # public stars count of fatih tj
ghstars -s vigo              # just how public stars amount of vigo
ghstars -verbose vigo        # public stars count of vigo in debug mode

GITHUB_ACCESS_TOKEN="<your-token>" ghstars  # your repos count

How count is done ?

• Public access; star count should be greater than zero and repo fork must be false
• Token access; you must be admin in that repo, star count should be greater than zero and repo fork must be false

Long story short, forks are not counted!

According to GitHub;

• For unauthenticated requests, the rate limit allows for up to 60 requests per hour.
• 5000 requests per hour and per authenticated user.

Example output:

ghstars fatih # public accessible repos included...

+-------+-----------------------------+-------+
|       | Name of Repository          | Star  |
+-------+-----------------------------+-------+
| 00001 | fatih/vim-go                | 15009 |
| 00002 | fatih/color                 | 05778 |
| 00003 | fatih/structs               | 03625 |
| 00004 | fatih/vim-go-tutorial       | 02122 |
| 00005 | fatih/gomodifytags          | 01845 |
| 00006 | fatih/pool                  | 01295 |
| 00007 | fatih/subvim                | 01128 |
| 00008 | fatih/dotfiles              | 00695 |
| 00009 | fatih/set                   | 00652 |
| 00010 | fatih/structtag             | 00533 |
| 00011 | fatih/errwrap               | 00355 |
| 00012 | fatih/semgroup              | 00262 |
| 00013 | fatih/faillint              | 00226 |
| 00014 | fatih/hclfmt                | 00224 |
| 00015 | fatih/motion                | 00168 |
| 00016 | fatih/astrewrite            | 00167 |
| 00017 | fatih/camelcase             | 00153 |
| 00018 | fatih/vim-hclfmt            | 00071 |
| 00019 | fatih/stopwatch             | 00068 |
| 00020 | fatih/images                | 00068 |
| 00021 | fatih/addlint               | 00052 |
| 00022 | fatih/gb-example            | 00047 |
| 00023 | fatih/hcl                   | 00043 |
| 00024 | fatih/templatectl           | 00042 |
| 00025 | fatih/twirpdemo             | 00032 |
| 00026 | fatih/talks                 | 00023 |
| 00027 | fatih/unexport              | 00022 |
| 00028 | fatih/kodla-talk-2022       | 00020 |
| 00029 | fatih/flags                 | 00017 |
| 00030 | fatih/vim-nginx             | 00017 |
| 00031 | fatih/sicp                  | 00016 |
| 00032 | fatih/dvb-t2                | 00015 |
| 00033 | fatih/amqp-examples         | 00015 |
| 00034 | fatih/testmod               | 00011 |
| 00035 | fatih/RailsDashboard.kdapp  | 00007 |
| 00036 | fatih/cafetiere             | 00006 |
| 00037 | fatih/koding-wiki           | 00006 |
| 00038 | fatih/docker-ubuntu-go      | 00004 |
| 00039 | fatih/blog.arsln.org-backup | 00004 |
| 00040 | fatih/sinerji               | 00002 |
| 00041 | fatih/snippets              | 00001 |
| 00042 | fatih/pisi-vim              | 00001 |
+-------+-----------------------------+-------+
|       | Number of total star count  | 34847 |
+-------+-----------------------------+-------+

ghstars -s fatih   # just report the total count
34847

---

Docker

https://hub.docker.com/r/vigo/ghstars/

# latest
docker run vigo/ghstars -h
docker run vigo/ghstars fatih

---

Contributor(s)

• Uğur "vigo" Özyılmazel - Creator, maintainer

---

Contribute

All PR’s are welcome!

1. fork (https://github.com/vigo/ghstars/fork)
2. Create your branch (git checkout -b my-feature)
3. commit yours (git commit -am 'add some functionality')
4. push your branch (git push origin my-feature)
5. Than create a new Pull Request!

This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

---

License

This project is licensed under MIT