dotfiles/zsh/.oh-my-zsh/plugins/web-search/README.md
2024-06-19 00:06:56 +02:00

3.3 KiB

web-search plugin

This plugin adds aliases for searching with Google, Wiki, Bing, YouTube and other popular services.

Open your ~/.zshrc file and enable the web-search plugin:

plugins=( ... web-search)

Usage

You can use the web-search plugin in these two forms:

  • web_search <context> <term> [more terms if you want]
  • <context> <term> [more terms if you want]

For example, these two are equivalent:

$ web_search google oh-my-zsh
$ google oh-my-zsh

Available search contexts are:

Context URL
bing https://www.bing.com/search?q=
google https://www.google.com/search?q=
brs or brave https://search.brave.com/search?q=
yahoo https://search.yahoo.com/search?p=
ddg or duckduckgo https://www.duckduckgo.com/?q=
sp or startpage https://www.startpage.com/do/search?q=
yandex https://yandex.ru/yandsearch?text=
github https://github.com/search?q=
baidu https://www.baidu.com/s?wd=
ecosia https://www.ecosia.org/search?q=
goodreads https://www.goodreads.com/search?q=
qwant https://www.qwant.com/?q=
givero https://www.givero.com/search?q=
stackoverflow https://stackoverflow.com/search?q=
wolframalpha https://wolframalpha.com/input?i=
archive https://web.archive.org/web/*/
scholar https://scholar.google.com/scholar?q=
ask https://www.ask.com/web?q=
youtube https://www.youtube.com/results?search_query=
deepl https://www.deepl.com/translator#auto/auto/
dockerhub https://hub.docker.com/search?q=
npmpkg https://www.npmjs.com/search?q=
packagist https://packagist.org/?query=
gopkg https://pkg.go.dev/search?m=package&q=

Also there are aliases for bang-searching DuckDuckGo:

Context Bang
wiki !w
news !n
map !m
image !i
ducky !

Custom search engines

If you want to add other search contexts to the plugin, you can use the $ZSH_WEB_SEARCH_ENGINES variable. Set it before Oh My Zsh is sourced, with the following format:

ZSH_WEB_SEARCH_ENGINES=(
    <context> <URL>
    <context> <URL>
)

where <context> is the name of the search context, and <URL> a URL of the same type as the search contexts above. For example, to add reddit, you'd do:

ZSH_WEB_SEARCH_ENGINES=(reddit "https://www.reddit.com/search/?q=")

These custom search engines will also be turned to aliases, so you can both do web_search reddit <query> or reddit <query>.