https://github.com/psalias2006/github-trending-cli
A simple CLI tool to browse GitHub's trending repositories from your terminal.
https://github.com/psalias2006/github-trending-cli
cli docker github github-trending python scraping terminal
Last synced: 4 months ago
JSON representation
A simple CLI tool to browse GitHub's trending repositories from your terminal.
- Host: GitHub
- URL: https://github.com/psalias2006/github-trending-cli
- Owner: psalias2006
- License: mit
- Created: 2025-09-21T21:59:33.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-09-23T19:00:22.000Z (4 months ago)
- Last Synced: 2025-09-23T20:28:41.364Z (4 months ago)
- Topics: cli, docker, github, github-trending, python, scraping, terminal
- Language: Python
- Homepage:
- Size: 1.01 MB
- Stars: 8
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GitHub Trending CLI
We like browsing GitHub's trending page, so we made a CLI version.
You can export it also 😉
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
## What it does
- Shows trending repositories with daily star counts
- Supports daily, weekly, and monthly views
- Click on any repo to read its README
- Export to CSV or JSON Lines format
- Simple terminal interface
## Installation
### Local
```bash
git clone https://github.com/psalias2006/github-trending-cli.git
cd github-trending-cli
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt && pip install -e .
```
### Docker
```bash
git clone https://github.com/psalias2006/github-trending-cli.git
cd github-trending-cli
docker build -t github-trending-cli .
```
## Usage
### Interactive Mode
```bash
# Local
github-trending # today
github-trending -r weekly # this week
github-trending -r monthly # this month
# Docker
docker run -it --rm github-trending-cli
docker run -it --rm github-trending-cli -r weekly
```
### Export Mode
```bash
# Local
github-trending -e # CSV export
github-trending -e -f json # JSON Lines export
github-trending -e -r weekly # Weekly data
# Docker (requires volume mount)
docker run --rm -v "$(pwd)/exported:/app/exported" github-trending-cli -e
docker run --rm -v "$(pwd)/exported:/app/exported" github-trending-cli -e -f json
```
## Export Format
Files saved to `exported/` with timestamps: `github_trending_{range}_{datetime}.{csv|jsonl}`
**CSV**: Standard format with headers
**JSON Lines**: One JSON object per line, ideal for data processing
**Columns**: name, url, description, language, stars, stars_period, range, export_datetime
## Contributing
Fork it, make changes, send a PR.
## License
MIT