Skip to main content

Cover image

Browse trending repos on Github by ⭐stars⭐ from your command line! 💻

checks pypi version pypi downloads per month Python Requirements Code style: black GitHub license MIT


starcli demo.gif

Prerequisites

  • Requires Python 3.6 or greater

Installation

pip install starcli

Remember to use pip3 instead of pip if you also have Python 2 installed on your system

Usage

Usage: starcli [OPTIONS]

  Browse trending repos on GitHub by stars

Options:
  -l, --lang TEXT                 Language filter eg: python
  -d, --date TEXT                 Specify repo creation date in ISO8601 format
                                  YYYY-MM-DD
  -L, --layout [list|table|grid]  The output format (list, table, or grid),
                                  default is list
  -s, --stars TEXT                Range of stars required, default is '>=50'
  -r, --limit-results INTEGER     Limit the number of results shown. Default:
                                  7
  -o, --order [desc|asc]          Specify the order of repos by stars that is
                                  shown, 'desc' or 'asc', default: desc
  --long-stats                    Print the actual stats[1300 instead of 1.3k]
  --debug                         Turn on debugging mode
  --help                          Show this message and exit.

Layouts

Switch layouts using --layout {list|table|grid}, or use the short option -L

list

demo list

table

grid

demo grid

Filtering by language

For example, you only want to find popular Python repos, you can use --lang or -l:

starcli --lang python

Here, we used starcli -l python -L grid, which is python with grid layout:

demo grid

Specify the number (or range) of stars

(Recommended to be used with --date)

The default range is >=50, you can change that! Use --stars or -s to specify what you want, for example, if you want to find repos that has more than 100 stars, you can use:

starcli -s '>100'

Note that if you do something like >1000 not many repos can have more than 1000 and is created within 100 days, to specify date of creation, use --date, see below.

Specify the date of creation

Want to find newer, older, or just created repos? Just use --date or -d, and then provide a date in ISO8601 format: yyyy-mm-dd

For example, to 1st January 2014, use:

starcli --date 2014-01-01

Limit the number of results shown

Don't like the default 7? You can change it to something else, using --limit-results or -r followed by an integer:

starcli -r 2

The above will only give you two repos. This is useful if you want to put it in your .bashrc, .zshrc, or config.fish.

Just add starcli -r 3 -L grid to that file, and every time you open your terminal, you will find 3 trending repos printed neatly in a grid format, great way to start your day (bit like the Hacker Tab Extension 😆 ).

Issues, feature request, and feedback

  • Issues, bug reports, or feature request: Don't hesitate to open an issue in this repo
  • Feedback: any general feedback or questions about using StarCLI you can leave a comment on our Product Hunt page, remember to be nice 😃

Development PRs Welcome

For contributing guidelines and how to set up your development environment, please read CONTRIBUTING.md. Remember that all contributions to this project should follow its CODE OF CONDUCT.

Uses

  • CommandLine Argument parser: Click
  • Colored and table console print: rich (with click and colorama)
  • HTTP library to send requests: requests

Contributors ✨

Thanks goes to all of these wonderful people (emoji key):


Shagilton

💻

hexbee

🐛

Sam Wellander

💻

Shivam Sinha

💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Credits

This project was forked from githunt (python) made by Srinivasa Rao, which in turn, is inspired by githunt (the JavaScript Web App).


Liked this project? Don't forget to give it a ⭐

Metadata

Release files for starcli 2.9.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for starcli 2.9.4
File Size Uploaded Provenance Actions
starcli-2.9.4.tar.gz 8.0 kB Without provenance Details for starcli-2.9.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for starcli 2.9.4
File Interpreter ABI Platform Actions
starcli-2.9.4-py3-none-any.whl Python 3 none any Details for starcli-2.9.4-py3-none-any.whl

Total release size: 16.7 kB

Release files / starcli-2.9.4.tar.gz

Download URL starcli-2.9.4.tar.gz
Size 8.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4a8bc952f65f0f548977584adaa715d7fc2196a8cc8c6bd92050b28a2545ddb9
BLAKE2b-256 checksum
How to use checksums
23607018497954c009c15d5123e6ac93b849591a870963a1cf7b728e101619aa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.7.7

Release files / starcli-2.9.4-py3-none-any.whl

Download URL starcli-2.9.4-py3-none-any.whl
Size 8.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a1e5dc26d60fb12b31425525ede51e638ed2b50c5cf82d9d268d4744467c801a
BLAKE2b-256 checksum
How to use checksums
6687fbc7cfe1b8ae556bd8b2ffec55d8e09cf6c32e52dd060be2ff083eba4a8c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.7.7

Security for starcli 2.9.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.9.4 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page