Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ponsfrilus/gtrend
gTrend fetch github trending repositories and display them into your terminal.
https://github.com/ponsfrilus/gtrend
cli github node terminal trending
Last synced: 4 days ago
JSON representation
gTrend fetch github trending repositories and display them into your terminal.
- Host: GitHub
- URL: https://github.com/ponsfrilus/gtrend
- Owner: ponsfrilus
- License: mit
- Created: 2018-05-30T15:26:34.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-06-16T07:50:03.000Z (over 6 years ago)
- Last Synced: 2023-04-04T19:11:37.036Z (over 1 year ago)
- Topics: cli, github, node, terminal, trending
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/gtrend
- Size: 4.2 MB
- Stars: 10
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gTrend
gTrend fetch GitHub trending repositories and display them into your terminal.
Using ↑ and ↓ you can select a repository and open it in
your browser by pressing ENTER.
# 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