gtrend

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 10 Open GitHub ↗

gTrend fetch github trending repositories and display them into your terminal.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# gTrend

gTrend fetch GitHub trending repositories and display them into your terminal.

Using <kbd>↑</kbd> and <kbd>↓</kbd> you can select a repository and open it in
your browser by pressing <kbd>ENTER</kbd>.

![DEMO](https://raw.githubusercontent.com/ponsfrilus/gtrend/master/doc/gtrend.gif)

# Installation

`npm i gtrend -g`

# Usage

* `gtrend [options]`

## Options
```
  -h, --help              Display this usage guide.                             
  -n, --num number        Number of items to display, default to 10.            
  -t, --timespan string   Time span of repositories [ 'daily', 'weekly',        
                          'monthly' ], default to daily.                        
  -s, --sort string       Sort repositories [ 'starsToday', 'stars', 'forks' ],
                          default to starstoday.                                
  -l, --language string   Specify a language, e.g. JavaScript, default to all.  
  -b, --browser string    Specify a browser, e.g. firefox or google-chrome.
  --nocache               (re)Load repo from GitHub, renewing cache.
  --clearcache            Delete all previous cache files.
  -v, --version           Get the version.
```

## Examples

| Command                | Description                             |
| ---------------------- | --------------------------------------- |
| `gtrend -n 15`         | Displays 15 daily trending repos        |
| `gtrend -t monthly`    | Displays monthly trending repos         |
| `gtrend -s forks`      | Displays trending repos sorted by forks |
| `gtrend -l JavaScript` | Displays JavaScript trending repos      |
| `gtrend -b firefox`    | Open repo in firefox                    |

So, if you want to display 20 weekly trending repos sorted by stars and want to use google-chrome:

`gtrend -n 20 -t weekly -s stars -b google-chrome`

The command default are:

`gtrend -n 10 -t daily -s starsToday` which is equivalent to `gtrend`.

# TODOS

- [ ] Run some tests
  - [ ] Makefile + version management
  - [ ] Old cache browsing and loading
  - [ ] Add `cli` completion

# LOGS

* v0.1.5  Moving to GitLab
  * v0.1.4  Back to original trending-github package
  * v0.1.3  Cache retrieving better handling
  * v0.1.2  Old cache removal
  * v0.1.0  Thanks to [@cronvel](https://github.com/cronvel/terminal-kit/issues/68) highlighting of selected line is now perfect !
  * v0.0.7  WIP Makefile
  * v0.0.6  Tuning
  * v0.0.5  Quick fixes, `--nocache` option
  * v0.0.4  Cache, better README
  * v0.0.3  CLI args (sorting, language, timespan, etc...) are now ok
  * v0.0.2  Basic but functional version
  * v0.0.1  Basic tests with different libraries

gtrend

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README