Skip to content

mingrammer/awesome-finder

Repository files navigation



Awesome Finder

Search the awesome curated list without browser




What does mean awesome? The awesome series provide a curated list of awesome frameworks, libraries, software and resources for a specific topic. An example is awesome-python

A TUI based finder for searching the awesome resources on awesome series such as awesome-python, awesome-go and so on.

With it, you can browse the awesome libraries, resources on your terminal without browser.

asciicast

Installation

It supports Python 3+ only.

pip install awesome-finder # or pip3 install awesome-finder 

Usage

# Find awesome things from awesome-<topic>
awesome-hub <topic>

# Find awesome things from latest awesome-<topic> (not use cache)
awesome-hub <topic> -f (--force)

# Find awesome things with initial query
awesome-hub <topic> -q (--query) 'query string you want to search'

# Show help messages (can see supported awesome topics)
awesome-hub -h (--help)

There are some helpful key bindings:

Key Description
Key up () Scroll up
Key down () Scroll down
Key left () Page up
Key right () Page down
Enter (↵) Open the selected awesome link on default browser
Esc Close the awesome finder

Supported awesome topics

Updated: 2018-03-04

These will be updated continuously

  • awesome
  • awesome-android
  • awesome-elixir
  • awesome-erlang
  • awesome-go
  • awesome-ios
  • awesome-java
  • awesome-javascript
  • awesome-nodejs
  • awesome-php
  • awesome-python
  • awesome-ruby
  • awesome-rust
  • awesome-scala
  • awesome-swift
  • awesome-vue

Contributing

Details on CONTRIBUTING

Changelog

Details on CHANGELOG

TODO

  • Query highlighting
  • Supports paging with Key left (←) and Key right (→)
  • Smart parsing with hierachical structure
  • Supports all awesome series
  • Supports initial query (example: awesome python -q 'django oauth')
  • Add options to open the Issue and Pull Request page of a specific awesome series

License

FOSSA Status