starred requires Python version 3.x

$ git clone https://github.com/utensil-contrib/starred
$ pip install ./starred
$ starred --username utensil --output README.md

1. Output your starred repositories in table or list

   • Output table(default)

   starred --username <yourname> --output README.md [--type table]

   • Output list

   starred --username <yourname> --output README.md --type list

2. Nice badges for total number of repositories and generated date

   See utensil/awesome-stars

3. Repositories can be sort by stars, starred date or name

   starred --username <yourname> --output README.md --sort stars/date/name

4. Automatically create a repository for your stars, and update this repository when your stars changed, old stars will be archived. You can install starred, use scheduled tasks to automatically update your stars repository.

   • Synology NAS: use Task Scheduler to run following script

   LANG=en_US.UTF-8 GITHUB_TOKEN=<yourtoken> starred --username <yourname> --repository <repositoryname>

   • Linux: use crontab to run following script

   export GITHUB_TOKEN=<yourtoken>
   starred --username <yourname> --repository <repositoryname>

   • Windows: use Task Scheduler to run following script (Anaconda3 needed)

   @echo off
   C:\Users\<user>\AppData\Local\Continuum\anaconda3\Scripts\activate.bat C:\Users\<user>\AppData\Local\Continuum\anaconda3 & set GITHUB_TOKEN=<yourtoken> & starred --username <yourname> --repository <repositoryname>

$ starred --help

Usage: starred [OPTIONS]

  GitHub starred

  creating your own Awesome List used GitHub stars!

  example:     starred --username 1132719438 --output README.md

Options:
  --username TEXT           GitHub username  [required]
  --token TEXT              GitHub token
  --sort [stars|date|name]  sort by language with stars, date or name
  --repository TEXT         repository name
  --message TEXT            commit message
  --output TEXT             output file name with path(print to stdout if not
                            set)
  --http-proxy TEXT         http proxy (i.e. http://127.0.0.1:1080 or
                            socks5://127.0.0.1:1080)
  --https-proxy TEXT        https proxy (same as http proxy if not set)
  --launch                  launch to Github after update repository
  --type [table|list]       output repository information in table or list

# automatically create the repository
$ starred --username <yourname> --repository awesome-stars --token <yourtoken> --sort stars --type list

• utensil/awesome-stars

1. Generate new token

   goto Personal access tokens

2. Why do I need a token?

   • For unauthenticated requests, the rate limit is 60 requests per hour. see Rate Limiting
   • The token must be passed together when you want to automatically create the repository.