https://github.com/ripred/github-traffic
command line utility to gather, organize, and display the metrics about all of your github repositories
https://github.com/ripred/github-traffic
Last synced: 11 months ago
JSON representation
command line utility to gather, organize, and display the metrics about all of your github repositories
- Host: GitHub
- URL: https://github.com/ripred/github-traffic
- Owner: ripred
- License: mit
- Created: 2025-03-13T18:03:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-13T18:17:58.000Z (over 1 year ago)
- Last Synced: 2025-07-21T21:13:23.632Z (11 months ago)
- Language: Python
- Size: 930 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# github-traffic
command line utility to gather, organize, and display the metrics about all of your github repositories.
## Usage
```bash
usage: traffic.py [-h] [-e] [-z] [-c] [-s {views_total,views_unique,clones_total,clones_unique,stars,forks,combined_metrics}] [-t TIMEFRAME]
GitHub Repository Traffic Analyzer
options:
-h, --help show this help message and exit
-e, --hide-empty Hide repositories with all metrics equal to zero
-z, --no-zero-views Exclude repositories with zero views from the output
-c, --write-csv Write results to a CSV file
-s {views_total,views_unique,clones_total,clones_unique,stars,forks,combined_metrics}, --sort-by {views_total,views_unique,clones_total,clones_unique,stars,forks,combined_metrics}
Sort results by a specific metric (default: combined_metrics)
-t TIMEFRAME, --timeframe TIMEFRAME
Set the timeframe for reports in days (default: 14, GitHub API maximum)
Examples:
python traffic.py # Basic usage with default settings
python traffic.py -z # Exclude repos with zero views
python traffic.py -e -c # Hide empty repos and save to CSV
python traffic.py -s views_total # Sort by total views
python traffic.py -z -s clones_unique # Show only repos with views, sorted by unique clones
python traffic.py -t 14 # Get data for the last 14 days (GitHub API maximum)
```
## Example Command Line Execution and Output 