Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mingrammer/awesome-finder
:sunglasses: Search the awesome curated list without browser
https://github.com/mingrammer/awesome-finder
List: awesome-finder
awesome awesome-finder cli finder tui
Last synced: 2 days ago
JSON representation
:sunglasses: Search the awesome curated list without browser
- Host: GitHub
- URL: https://github.com/mingrammer/awesome-finder
- Owner: mingrammer
- License: mit
- Created: 2017-08-04T15:07:40.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T07:47:02.000Z (almost 2 years ago)
- Last Synced: 2024-05-19T21:59:05.451Z (6 months ago)
- Topics: awesome, awesome-finder, cli, finder, tui
- Language: Python
- Homepage:
- Size: 109 MB
- Stars: 271
- Watchers: 7
- Forks: 23
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - awesome-finder
- jimsghstars - mingrammer/awesome-finder - :sunglasses: Search the awesome curated list without browser (Python)
README
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](https://github.com/vinta/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.
[](https://asciinema.org/a/OOdH9rLVBvReK3K6n7pZvruf9)
## Installation
It supports **Python 3+** only.
```bash
pip install awesome-finder # or pip3 install awesome-finder
```
## Usage
```console
# Find awesome things from awesome-
awesome-hub
# Find awesome things from latest awesome- (not use cache)
awesome-hub -f (--force)
# Find awesome things with initial query
awesome-hub -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](CONTRIBUTING.md)
## Changelog
Details on [CHANGELOG](CHANGELOG.md)
## TODO
* [ ] Query highlighting
* [x] Supports paging with Key left (←) and Key right (→)
* [ ] Smart parsing with hierachical structure
* [ ] Supports all awesome series
* [x] 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
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fmingrammer%2Fawesome-finder?ref=badge_large)