/net_search

Look for everyhting, everywhere.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Header

GitHub license GitHub last commit GitHub forks GitHub stars

Quick start

Installation

Python must be installed on your computer.

Instructions :

git clone https://github.com/n-deleforge/binocle.git

Usage

Binocle always need two arguments to work.

  • engine : engine to use - the list is available below.
  • query : query to send

There are also some optionnals arguments :

  • -v / --version : show Binocle version
  • -h / --help : show Binocle help
  • -l / --list : show every engines available

Examples

  • Search My Super Research on Duckduckgo : binocle d "My Super Research".
  • Search SomeYoutuber on Youtube : binocle yt SomeYoutuber.
  • Show engines available : binocle -l.

If your query is only composed of one word, you don't need to add quote marks as you can notice with the second example.

Launch from terminal (for Windows)

  • Edit the PATH global variable and add the directory of binocle.
  • Then you can type : binocle [engine] [query] directly in your terminal.

Engine list

Categorie Keyword Search on
Search Engine b Bing
- d Duckduckgo
- e Ecosia
- g Google
- q Qwant
- s Startpage
Utility alt Alternative To
- hltb HowLongTo Beat
- mal MyAnimeList
- wi Wikipedia
Entertainment tw Twitch
- yt Youtube
Development ch Chocolatey
- gi Github
- so StackOverflow
Social li LinkedIn
- re Reddit

Editing engines list

How to add a category

A category is composed of 2 mandatory values :

  • id : must be an integer and unique
  • name : must be a string

Edit the categories.json file in the data folder and follow this template : {"id" : x, "name": x }

How to add an engine

An engine is composed of 4 mandatory values :

  • category : must be an id of an existing category
  • name : must be a string
  • keyword : must be a string
  • url : must be a string

Edit the engines.json file in the data folder and follow this template : {"category" : x, "name": x, "keyword": x, "url": x}

Changelog

  • 0.6 : Categories and engines are now managed throught JSON files.
  • 0.5 : Engines are now categorized in the list function
  • 0.4 : List function added (show every search engines) + HowLongToBeat added
  • 0.3 : Multiple new search engines
  • 0.2 : Initial release