"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "README.md" between
googler-4.0.tar.gz and googler-4.1.tar.gz

About: googler is a command line tool to search Google (Web & News) from the terminal (requires Python).

README.md  (googler-4.0):README.md  (googler-4.1)
<h1 align="center"><img src="https://cdn.rawgit.com/jarun/googler/master/googler .svg" alt="googler" /></h1> <h1 align="center"><img src="https://cdn.rawgit.com/jarun/googler/master/googler .svg" alt="googler" /></h1>
<p align="center"> <p align="center">
<a href="https://github.com/jarun/googler/releases/latest"><img src="https://img .shields.io/github/release/jarun/googler.svg?maxAge=600" alt="Latest release" /> </a> <a href="https://github.com/jarun/googler/releases/latest"><img src="https://img .shields.io/github/release/jarun/googler.svg?maxAge=600" alt="Latest release" /> </a>
<a href="https://aur.archlinux.org/packages/googler"><img src="https://img.shiel <a href="https://repology.org/project/googler/versions"><img src="https://repolo
ds.io/aur/version/googler.svg?maxAge=600" alt="AUR" /></a> gy.org/badge/tiny-repos/googler.svg" alt="Availability"></a>
<a href="http://formulae.brew.sh/formula/googler"><img src="https://img.shields.
io/homebrew/v/googler.svg?maxAge=600" alt="Homebrew" /></a>
<a href="https://packages.debian.org/search?keywords=googler&searchon=names"><im
g src="https://img.shields.io/badge/debian-9+-blue.svg?maxAge=2592000" alt="Debi
an Stretch+" /></a>
<a href="https://apps.fedoraproject.org/packages/googler"><img src="https://img.
shields.io/badge/fedora-27+-blue.svg?maxAge=2592000" alt="Fedora 27+" /></a>
<a href="https://software.opensuse.org/search?q=googler"><img src="https://img.s
hields.io/badge/opensuse%20leap-15.0+-blue.svg?maxAge=2592000" alt="openSUSE Lea
p 15.0+" /></a>
<a href="https://packages.ubuntu.com/search?keywords=googler&searchon=names"><im
g src="https://img.shields.io/badge/ubuntu-16.10+-blue.svg?maxAge=2592000" alt="
Ubuntu Yakkety+" /></a>
</p>
<p align="center">
<a href="https://repology.org/metapackage/googler"><img src="https://repology.or
g/badge/tiny-repos/googler.svg" alt="Availability"></a>
<a href="https://github.com/jarun/googler/blob/master/LICENSE"><img src="https:/ /img.shields.io/badge/license-GPLv3-yellow.svg?maxAge=2592000" alt="License" />< /a> <a href="https://github.com/jarun/googler/blob/master/LICENSE"><img src="https:/ /img.shields.io/badge/license-GPLv3-yellow.svg?maxAge=2592000" alt="License" />< /a>
<a href="https://circleci.com/gh/jarun/workflows/googler"><img src="https://img. shields.io/circleci/project/github/jarun/googler.svg" alt="Build Status" /></a> <a href="https://circleci.com/gh/jarun/workflows/googler"><img src="https://img. shields.io/circleci/project/github/jarun/googler.svg" alt="Build Status" /></a>
<a href="https://repl.it/github/jarun/googler"><img src="https://repl.it/badge/g
ithub/jarun/googler?maxAge=2592000" alt="Repl.it" /></a>
</p> </p>
<p align="center"> <p align="center">
<a href="https://asciinema.org/a/85019"><img src="https://i.imgur.com/EbZof9q.pn g" alt="Asciicast" width="734"/></a> <a href="https://asciinema.org/a/85019"><img src="https://i.imgur.com/EbZof9q.pn g" alt="Asciicast" width="734"/></a>
</p> </p>
`googler` is a power tool to Google (Web & News) and Google Site Search from the command-line. It shows the title, URL and abstract for each result, which can b e directly opened in a browser from the terminal. Results are fetched in pages ( with page navigation). Supports sequential searches in a single `googler` instan ce. `googler` is a power tool to Google (Web & News) and Google Site Search from the command-line. It shows the title, URL and abstract for each result, which can b e directly opened in a browser from the terminal. Results are fetched in pages ( with page navigation). Supports sequential searches in a single `googler` instan ce.
`googler` was initially written to cater to headless servers without X. You can integrate it with a text-based browser. However, it has grown into a very handy and flexible utility that delivers much more. For example, fetch any number of r esults or start anywhere, limit search by any duration, define aliases to google search any number of websites, switch domains easily... all of this in a very c lean interface without ads or stray URLs. The shell completion scripts make sure you don't need to remember any options. `googler` was initially written to cater to headless servers without X. You can integrate it with a text-based browser. However, it has grown into a very handy and flexible utility that delivers much more. For example, fetch any number of r esults or start anywhere, limit search by any duration, define aliases to google search any number of websites, switch domains easily... all of this in a very c lean interface without ads or stray URLs. The shell completion scripts make sure you don't need to remember any options.
skipping to change at line 40 skipping to change at line 33
- [googler on the iPad](https://github.com/jarun/googler/wiki/googler-on-the-iPa d) - [googler on the iPad](https://github.com/jarun/googler/wiki/googler-on-the-iPa d)
- [Print content of results to terminal or listen to it](https://github.com/jaru n/googler/wiki/Print-content-of-results-to-terminal-or-listen-to-it) - [Print content of results to terminal or listen to it](https://github.com/jaru n/googler/wiki/Print-content-of-results-to-terminal-or-listen-to-it)
- [Terminal Reading Mode or Reader View](https://github.com/jarun/googler/wiki/T erminal-Reading-Mode-or-Reader-View) - [Terminal Reading Mode or Reader View](https://github.com/jarun/googler/wiki/T erminal-Reading-Mode-or-Reader-View)
- [Stream YouTube videos on desktop](https://github.com/jarun/googler/wiki/Strea m-YouTube-videos-on-desktop) - [Stream YouTube videos on desktop](https://github.com/jarun/googler/wiki/Strea m-YouTube-videos-on-desktop)
- [Search error on StackOverflow from terminal](https://github.com/jarun/googler /wiki/Search-error-on-StackOverflow-from-terminal) - [Search error on StackOverflow from terminal](https://github.com/jarun/googler /wiki/Search-error-on-StackOverflow-from-terminal)
*Love smart and efficient utilities? Explore [my repositories](https://github.co m/jarun?tab=repositories). Buy me a cup of coffee if they help you.* *Love smart and efficient utilities? Explore [my repositories](https://github.co m/jarun?tab=repositories). Buy me a cup of coffee if they help you.*
<p align="center"> <p align="center">
<a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RM LTQ76JSXJ4Q"><img src="https://img.shields.io/badge/PayPal-donate-1eb0fc.svg" al t="Donate via PayPal!" /></a> <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RM LTQ76JSXJ4Q"><img src="https://img.shields.io/badge/donate-PayPal-1eb0fc.svg" al t="Donate via PayPal!" /></a>
</p> </p>
### Table of contents ### Table of contents
- [Features](#features) - [Features](#features)
- [Installation](#installation) - [Installation](#installation)
- [Dependencies](#dependencies) - [Dependencies](#dependencies)
- [From a package manager](#from-a-package-manager) - [From a package manager](#from-a-package-manager)
- [Tips for packagers](#tips-for-packagers) - [Tips for packagers](#tips-for-packagers)
- [Release packages](#release-packages) - [Release packages](#release-packages)
skipping to change at line 70 skipping to change at line 63
- [Colors](#colors) - [Colors](#colors)
- [Domain-only URL](#domain-only-url) - [Domain-only URL](#domain-only-url)
- [Examples](#examples) - [Examples](#examples)
- [Troubleshooting](#troubleshooting) - [Troubleshooting](#troubleshooting)
- [Notes](#notes) - [Notes](#notes)
- [Contributions](#contributions) - [Contributions](#contributions)
- [Developers](#developers) - [Developers](#developers)
### Features ### Features
- Google Search, Google Site Search, Google News - Google Search, Google Site Search, Google News, Google Videos
- Fast and clean (no ads, stray URLs or clutter), custom color - Fast and clean (no ads, stray URLs or clutter), custom color
- Navigate result pages from omniprompt, open URLs in browser - Navigate result pages from omniprompt, open URLs in browser
- Effortless keyword-based site search with googler @t add-on - Effortless keyword-based site search with googler @t add-on
- Search and option completion scripts for Bash, Zsh and Fish - Search and option completion scripts for Bash, Zsh and Fish
- Fetch n results in a go, start at the n<sup>th</sup> result - Fetch n results in a go, start at the n<sup>th</sup> result
- Disable automatic spelling correction and search exact keywords - Disable automatic spelling correction and search exact keywords
- Specify duration, country/domain (default: worldwide/.com), language - Specify duration, country/domain (default: worldwide/.com), language
- Google keywords (e.g. `filetype:mime`, `site:somesite.com`) support - Google keywords (e.g. `filetype:mime`, `site:somesite.com`) support
- Open the first result directly in browser (as in *I'm Feeling Lucky*) - Open the first result directly in browser (as in *I'm Feeling Lucky*)
- Non-stop searches: fire new searches at omniprompt without exiting - Non-stop searches: fire new searches at omniprompt without exiting
skipping to change at line 95 skipping to change at line 88
### Installation ### Installation
#### Dependencies #### Dependencies
`googler` requires Python 3.5 or later. Only the latest patch release of each mi nor version is supported. `googler` requires Python 3.5 or later. Only the latest patch release of each mi nor version is supported.
To copy url to clipboard at the omniprompt, `googler` looks for `xsel` or `xclip ` or `termux-clipboard-set` (in the same order) on Linux, `pbcopy` (default inst alled) on macOS and `clip` (default installed) on Windows. It also supports GNU Screen and tmux copy-paste buffers in the absence of X11. To copy url to clipboard at the omniprompt, `googler` looks for `xsel` or `xclip ` or `termux-clipboard-set` (in the same order) on Linux, `pbcopy` (default inst alled) on macOS and `clip` (default installed) on Windows. It also supports GNU Screen and tmux copy-paste buffers in the absence of X11.
#### From a package manager #### From a package manager
- [AUR](https://aur.archlinux.org/packages/googler/) (`yay -S googler`) Install `googler` from your package manager. If the version available is dated t
- [Chocolatey](https://chocolatey.org/packages/googler) (`choco install googler` ry an alternative installation method.
)
- [Debian](https://packages.debian.org/search?keywords=googler&searchon=names) ( <details><summary>Packaging status (expand)</summary>
`apt-get install googler`) <p>
- [Fedora](https://apps.fedoraproject.org/packages/googler) (`dnf install google <br>
r`) <a href="https://repology.org/project/googler/versions"><img src="https://repolo
- [FreeBSD](https://www.freshports.org/www/googler/) (`pkg install googler`) gy.org/badge/vertical-allrepos/googler.svg" alt="Packaging status"></a>
- [macOS/Homebrew](http://formulae.brew.sh/formula/googler) (`brew install googl </p>
er`) Unlisted packagers:
- [NixOS](https://github.com/NixOS/nixpkgs/tree/master/pkgs/applications/misc/go <p>
ogler) (`nix-env -i googler`) <br>
- [openSUSE](https://software.opensuse.org/search?q=googler) (`zypper in googler ● <a href="https://snapcraft.io/googler">Snap Store</a> (<code>snap install goog
`) ler</code>)<br>
- [Raspbian Testing](https://archive.raspbian.org/raspbian/pool/main/g/googler/) </p>
(`apt-get install googler`) </details>
- [Slackware](http://slackbuilds.org/repository/14.2/network/googler/) (`slackpk
g install googler`)
- [Snap Store](https://snapcraft.io/googler) (`snap install googler`)
- [Ubuntu](https://packages.ubuntu.com/search?keywords=googler&searchon=names) (
`apt-get install googler`)
- [Void Linux](https://github.com/void-linux/void-packages/blob/master/srcpkgs/g
oogler/template) (`xbps-install -S googler`)
##### Tips for packagers ##### Tips for packagers
`googler` v2.7 and later ships with an in-place self-upgrade mechanism which you may want to disable. To do this, run `googler` v2.7 and later ships with an in-place self-upgrade mechanism which you may want to disable. To do this, run
$ make disable-self-upgrade $ make disable-self-upgrade
before installation. before installation.
#### Release packages #### Release packages
skipping to change at line 147 skipping to change at line 140
`googler` is a standalone executable (and can run even on environments like Term ux). From the containing directory: `googler` is a standalone executable (and can run even on environments like Term ux). From the containing directory:
$ ./googler $ ./googler
#### Downloading a single file #### Downloading a single file
`googler` is a single standalone script, so you could download just a single fil e if you'd like to. `googler` is a single standalone script, so you could download just a single fil e if you'd like to.
To install the latest stable version, run To install the latest stable version, run
$ sudo curl -o /usr/local/bin/googler https://raw.githubusercontent.com/jaru n/googler/v4.0/googler && sudo chmod +x /usr/local/bin/googler $ sudo curl -o /usr/local/bin/googler https://raw.githubusercontent.com/jaru n/googler/v4.1/googler && sudo chmod +x /usr/local/bin/googler
You could then let googler upgrade itself by running You could then let googler upgrade itself by running
$ sudo googler -u $ sudo googler -u
Similarly, if you want to install from git master (*risky*), run Similarly, if you want to install from git master (*risky*), run
$ sudo curl -o /usr/local/bin/googler https://raw.githubusercontent.com/jaru n/googler/master/googler && sudo chmod +x /usr/local/bin/googler $ sudo curl -o /usr/local/bin/googler https://raw.githubusercontent.com/jaru n/googler/master/googler && sudo chmod +x /usr/local/bin/googler
and upgrade by running and upgrade by running
skipping to change at line 170 skipping to change at line 163
### Shell completion ### Shell completion
Search keyword and option completion scripts for Bash, Fish and Zsh can be found in respective subdirectories of [`auto-completion/`](auto-completion). Please r efer to your shell's manual for installation instructions. Search keyword and option completion scripts for Bash, Fish and Zsh can be found in respective subdirectories of [`auto-completion/`](auto-completion). Please r efer to your shell's manual for installation instructions.
### Usage ### Usage
#### Cmdline options #### Cmdline options
``` ```
usage: googler [-h] [-s N] [-n N] [-N] [-c TLD] [-l LANG] [-x] usage: googler [-h] [-s N] [-n N] [-N] [-V] [-c TLD] [-l LANG] [-x]
[--colorize [{auto,always,never}]] [-C] [--colors COLORS] [-j] [--colorize [{auto,always,never}]] [-C] [--colors COLORS] [-j]
[-t dN] [-w SITE] [--unfilter] [-p PROXY] [--noua] [--notweak] [-t dN] [--from FROM] [--to TO] [-w SITE] [--unfilter]
[--json] [--url-handler UTIL] [--show-browser-logs] [--np] [-u] [-p PROXY] [--noua] [--notweak] [--json] [--url-handler UTIL]
[--include-git] [-v] [-d] [--show-browser-logs] [--np] [-u] [--include-git] [-v] [-d]
[KEYWORD [KEYWORD ...]] [KEYWORD [KEYWORD ...]]
Google from the command-line. Google from the command-line.
positional arguments: positional arguments:
KEYWORD search keywords KEYWORD search keywords
optional arguments: optional arguments:
-h, --help show this help message and exit -h, --help show this help message and exit
-s N, --start N start at the Nth result -s N, --start N start at the Nth result
-n N, --count N show N results (default 10) -n N, --count N show N results (default 10)
-N, --news show results from news section -N, --news show results from news section
-V, --videos show results from videos section
-c TLD, --tld TLD country-specific search with top-level domain .TLD, -c TLD, --tld TLD country-specific search with top-level domain .TLD,
e.g., 'in' for India e.g., 'in' for India
-l LANG, --lang LANG display in language LANG -l LANG, --lang LANG display in language LANG
-x, --exact disable automatic spelling correction -x, --exact disable automatic spelling correction
--colorize [{auto,always,never}] --colorize [{auto,always,never}]
whether to colorize output; defaults to 'auto', which whether to colorize output; defaults to 'auto', which
enables color when stdout is a tty device; using enables color when stdout is a tty device; using
--colorize without an argument is equivalent to --colorize without an argument is equivalent to
--colorize=always --colorize=always
-C, --nocolor equivalent to --colorize=never -C, --nocolor equivalent to --colorize=never
--colors COLORS set output colors (see man page for details) --colors COLORS set output colors (see man page for details)
-j, --first, --lucky open the first result in web browser and exit -j, --first, --lucky open the first result in web browser and exit
-t dN, --time dN time limit search [h5 (5 hrs), d5 (5 days), w5 (5 -t dN, --time dN time limit search [h5 (5 hrs), d5 (5 days), w5 (5
weeks), m5 (5 months), y5 (5 years)] weeks), m5 (5 months), y5 (5 years)]
--from FROM starting date/month/year of date range; must use
American date format with slashes, e.g., 2/24/2020,
2/2020, 2020; can be used in conjuction with --to,
and overrides -t, --time
--to TO ending date/month/year of date range; see --from
-w SITE, --site SITE search a site using Google -w SITE, --site SITE search a site using Google
--unfilter do not omit similar results --unfilter do not omit similar results
-p PROXY, --proxy PROXY -p PROXY, --proxy PROXY
tunnel traffic through an HTTP proxy; PROXY is of the tunnel traffic through an HTTP proxy; PROXY is of the
form [http://][user:password@]proxyhost[:port] form [http://][user:password@]proxyhost[:port]
--noua legacy option (no effect) --noua legacy option (no effect)
--notweak disable TCP optimizations and forced TLS 1.2 --notweak disable TCP optimizations and forced TLS 1.2
--json output in JSON format; implies --noprompt --json output in JSON format; implies --noprompt
--url-handler UTIL custom script or cli utility to open results --url-handler UTIL custom script or cli utility to open results
--show-browser-logs do not suppress browser output (stdout and stderr) --show-browser-logs do not suppress browser output (stdout and stderr)
skipping to change at line 436 skipping to change at line 435
export DISABLE_PROMPT_COLOR=1 export DISABLE_PROMPT_COLOR=1
### Notes ### Notes
1. Initially I raised a pull request but I could see that the last change was ma de 7 years earlier. In addition, there is no GitHub activity from the original a uthor [Henri Hakkinen](https://github.com/henux) in past year. I have created th is independent repo for the project with the name `googler`. I retained the orig inal copyright information (though `googler` is organically different now). 1. Initially I raised a pull request but I could see that the last change was ma de 7 years earlier. In addition, there is no GitHub activity from the original a uthor [Henri Hakkinen](https://github.com/henux) in past year. I have created th is independent repo for the project with the name `googler`. I retained the orig inal copyright information (though `googler` is organically different now).
2. Google provides a search API which returns the results in JSON format. Howeve r, as per my understanding from the [official docs](https://developers.google.co m/custom-search/json-api/v1/overview), the API issues the queries against an exi sting instance of a custom search engine and is limited by 100 search queries pe r day for free. In addition, I have reservations in paying if they ever change t heir plan or restrict the API in other ways. So I refrained from coupling with G oogle plans & policies or exposing my trackable personal custom search API key a nd identifier for the public. I retained the browser-way of doing it by fetching html, which is a open and free specification. 2. Google provides a search API which returns the results in JSON format. Howeve r, as per my understanding from the [official docs](https://developers.google.co m/custom-search/json-api/v1/overview), the API issues the queries against an exi sting instance of a custom search engine and is limited by 100 search queries pe r day for free. In addition, I have reservations in paying if they ever change t heir plan or restrict the API in other ways. So I refrained from coupling with G oogle plans & policies or exposing my trackable personal custom search API key a nd identifier for the public. I retained the browser-way of doing it by fetching html, which is a open and free specification.
3. You can find a rofi script for `googler` [here](http://hastebin.com/fonowacij a.bash). Written by an anonymous user, untested and we don't maintain it. 3. You can find a rofi script for `googler` [here](http://hastebin.com/fonowacij a.bash). Written by an anonymous user, untested and we don't maintain it.
4. The Albert Launcher python plugins repo
([awesome-albert-plugins](https://github.com/bergercookie/awesome-albert-plugins
))
includes suggestions-enabled search plugins for a variety of websites using
googler. Refer to the latter for demos and usage instructions.
### Contributions ### Contributions
Pull requests are welcome. Please visit [#209](https://github.com/jarun/googler/ issues/209) for a list of TODOs. Pull requests are welcome. Please visit [#209](https://github.com/jarun/googler/ issues/209) for a list of TODOs.
<br> <br>
<p><a href="https://gitter.im/jarun/googler"><img src="https://img.shields.io/gi tter/room/jarun/googler.svg?maxAge=2592000" alt="gitter chat" /></a></p> <p><a href="https://gitter.im/jarun/googler"><img src="https://img.shields.io/gi tter/room/jarun/googler.svg?maxAge=2592000" alt="gitter chat" /></a></p>
### Developers ### Developers
1. Copyright © 2008 Henri Hakkinen 1. Copyright © 2008 Henri Hakkinen
2. Copyright © 2015-2019 [Arun Prakash Jana](https://github.com/jarun) 2. Copyright © 2015-2020 [Arun Prakash Jana](https://github.com/jarun)
3. [Zhiming Wang](https://github.com/zmwangx) 3. [Zhiming Wang](https://github.com/zmwangx)
4. [Johnathan Jenkins](https://github.com/shaggytwodope) 4. [Johnathan Jenkins](https://github.com/shaggytwodope)
5. [SZ Lin](https://github.com/szlin) 5. [SZ Lin](https://github.com/szlin)
Special thanks to [jeremija](https://github.com/jeremija) and [Narrat](https://g ithub.com/Narrat) for their contributions. Special thanks to [jeremija](https://github.com/jeremija) and [Narrat](https://g ithub.com/Narrat) for their contributions.
### Logo ### Logo
Logo copyright © 2017 Zhiming Wang. Logo copyright © 2017 Zhiming Wang.
 End of changes. 12 change blocks. 
51 lines changed or deleted 41 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)