https://github.com/vigo/ghstars
Show GitHub stars count for user!
https://github.com/vigo/ghstars
github github-repository github-stars golang golang-cli
Last synced: 8 months ago
JSON representation
Show GitHub stars count for user!
- Host: GitHub
- URL: https://github.com/vigo/ghstars
- Owner: vigo
- License: mit
- Created: 2022-10-30T09:22:03.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-13T09:37:04.000Z (about 2 years ago)
- Last Synced: 2025-03-31T13:05:08.800Z (about 1 year ago)
- Topics: github, github-repository, github-stars, golang, golang-cli
- Language: Go
- Homepage:
- Size: 35.2 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
[](https://pkg.go.dev/github.com/vigo/ghstars)
[](https://goreportcard.com/report/github.com/vigo/ghstars)
[](https://codecov.io/gh/vigo/ghstars)
# 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][1]
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
```bash
go install github.com/vigo/ghstars@latest
```
or, you can install from `brew`:
```bash
brew install vigo/ghstars/ghstars
```
## Usage
You can check command help:
```bash
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="" 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][2];
- For unauthenticated requests, the rate limit allows for up to **60
requests** per hour.
- **5000 requests** per hour and per authenticated user.
Example output:
```bash
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/
```bash
# latest
docker run vigo/ghstars -h
docker run vigo/ghstars fatih
```
---
## Contributor(s)
* [Uğur "vigo" Özyılmazel](https://github.com/vigo) - Creator, maintainer
---
## Contribute
All PR’s are welcome!
1. `fork` (https://github.com/vigo/ghstars/fork)
1. Create your `branch` (`git checkout -b my-feature`)
1. `commit` yours (`git commit -am 'add some functionality'`)
1. `push` your `branch` (`git push origin my-feature`)
1. 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][coc].
---
## License
This project is licensed under MIT
[1]: https://github.com/settings/tokens/new
[2]: https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting
[coc]: https://github.com/vigo/ghstars/blob/main/CODE_OF_CONDUCT.md