oh-my-stars

Search your stars locally.

usage: mystars [-h] [-l LANGUAGE [LANGUAGE ...]] [-u] [-r] [-a] [-3] [-i]
                   [-v]
                   [keywords [keywords ...]]

a CLI tool to search your starred Github repositories.

positional arguments:
  keywords              Search by keywords

optional arguments:
  -h, --help            show this help message and exit
  -l LANGUAGE [LANGUAGE ...], --language LANGUAGE [LANGUAGE ...]
                        Filter by language
  -u, --update          Create(first time) or update the local stars index
  -r, --reindex         Re-create the local stars index
  -c WHEN, --color WHEN
                        Colorize the output; WHEN can be 'always' (default if
                        omitted), 'auto', or 'never'
  -a, --alfred          Format search result as Alfred Script Filter output
  -3, --three           Alfred 3 support
  -i, --install         Import Alfred workflow
  -v, --version         show program's version number and exit

Works with Alfred Workflow

Configuration

You can avoid entering your GitHub API credentials every time you update the index, by adding them to the ~/.netrc file as follows:

machine api.github.com
    login ‹GH_USERNAME›
    password ‹GH_API_TOKEN›

Use an API token as the password – you can create one via Settings » Developer settings » Personal access tokens in the GitHub web interface.

Once you have stored credentials, you can also automate the index update by adding a job with crontab -e:

# GitHub stars
0 6 * * *	~/.local/bin/mystars -u

Installation (Mac OSX)

$ pip install oh-my-stars --upgrade --user
$ mystars --help
$ mystars --update
$ mystars angular upload
$ mystars --language python
$ mystars awesome python

if install failed, try following commands

$ pip uninstall distribute
$ pip install setuptools
$ pip install --upgrade setuptools

Integration with Alfred

$ mystars -i -3

For Alfred v2

$ mystars -i

Change logs

v1.5.0

• Disable the pagination and add a --color option. Thanks for the suggestions from @jhermann
• Speed up result display with CachingMiddleware of TinyDB

v1.4.9

• Fix workflow for Alfred v2

v1.4.8

• Fix Alfred XML output
• Rewrite Alfred workflow script

v1.4.5

• Drop Python 2.6 Support
• Update docs: using ~/.netrc + cron. @jhermann

v1.3.5

• Output Alfred 3 JSON ouput with "-a -3" option.
• Import Alfred Workflow with "-i" (append "-3" for Alfred 3) option.

v1.2.3

• Get user + password from netrc. @jhermann.
• Use pipenv to manage project requirements.

v1.1.3

• Upgrade to TinyDB 3.7.0.
• Build index when updating.
• Search result pagination.

Note

• Uninstall existing version.
• Rebuild existing index with mystars -r.

v1.0.2

• Rename to oh-my-stars.

v1.0.1

• Support Github two-factor authentication. @yanyaoer

v1.0.0

• Replace kc with TinyDB, no more non-python dependencies.
• Only update stars since last time.