summaryrefslogtreecommitdiff
path: root/README.md
blob: 61ace97c29f52dcf54e01a208720b1f5a3022166 (about) (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
<h1 align="center">
  	<img height="100" src="https://raw.github.com/kamranahmedse/githunt/master/public/img/logo.svg?sanitize=true" alt="Githunt" /> <br> GitHunt
</h1>

<p align="center">
  <a href="https://github.com/kamranahmedse/githunt">
    <img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg" alt="contributions" />
  </a>
  <a href="https://chrome.google.com/webstore/detail/githunt/khpcnaokfebphakjgdgpinmglconplhp">
    <img src="https://img.shields.io/chrome-web-store/v/khpcnaokfebphakjgdgpinmglconplhp.svg" alt="version" />
  </a>
  
  <a href="https://twitter.com/kamranahmedse">
    <img src="https://img.shields.io/twitter/follow/@kamranahmedse.svg" alt="downloads" />
  </a>
</p>

<p align="center">
  <b>Hunt the most starred projects on GitHub</b></br>
  <sub>✨ React app and Chrome Extension to go through the top projects ✨<sub> 
</p>

<br />

Whenever you will open a new tab, you will be presented with a page similar to following

![New Tab](http://i.imgur.com/COyJUJg.png)

By default it is set to show the trending repositories from the current week plus the repositories belonging to every language shown. However, once you will apply some filter, it will remember your configuration and the next time you will open the new tab, you will be presented with the last filter that you applied.

## Installation

Extension itself doesn't need any setup. All you have to do is

- Install it from [Chrome Webstore](https://chrome.google.com/webstore/detail/githunt/khpcnaokfebphakjgdgpinmglconplhp)  or [manually install it](http://superuser.com/a/247654/6877).


Github API has rate limit applied in their API and although the extension implements the caching in order to make sure that the rate limit may not be crossed, however I would recommend you to set the API token in the extension in order to increase the quota. 

Here is how you can do that
   
- Go to the [`Settings > Personal Access Tokens`](https://github.com/settings/tokens) of your github profile
- Click `Generate New Token` button. Give the token description and select the scope called `public_repo` under `repo` and click `Generate Token`.
- You will be presented with the generated token. Copy the token.
- Right click on the extension icon and click `Options`. Paste the API token in the given field and click save.

![Options Page](http://i.imgur.com/FK1vFlq.png)

- Voila! You are all set to go on a hunt.

## Contribution
I'd love to hear what you have to say. Reach me out at kamranahmed.se@gmail.com or on twitter [@kamranahmedse](http://twitter.com/kamranahmedse)

## License
MIT © [Kamran Ahmed](https://kamranahmed.info)