1GOOGLER(1) User Commands GOOGLER(1)
2
6 googler - Google from the command-line
7
9 googler [OPTIONS] [KEYWORD [KEYWORD ...]]
10
12 googler is a command-line tool to search Google (Web & News) from the
13 terminal. Google site search works too. googler shows the title, URL
14 and text context for each result. Results are fetched in pages. Next or
15 previous page navigation is possible using keyboard shortcuts. Results
16 are indexed and a result URL can be opened in a browser using the index
17 number. There is no configuration file as aliases serve the same pur‐
18 pose for this utility. Supports sequential searches in a single
19 instance.
20 Features
22 * Google Search, Google Site Search, Google News
24 * Fast and clean (no ads, stray URLs or clutter), custom color
25 * Navigate result pages from omniprompt, open URLs in browser
26 * Effortless keyword-based site search with googler @t add-on
27 * Search and option completion scripts for Bash, Zsh and Fish
28 * Fetch n results in a go, start at the n<sup>th</sup> result
29 * Disable automatic spelling correction and search exact keywords
30 * Specify duration, country/domain (default: worldwide/.com), lan‐
31 guage
32 * Google keywords (e.g. filetype:mime, site:somesite.com) support
33 * Open the first result directly in browser (as in I'm Feeling Lucky)
34 * Non-stop searches: fire new searches at omniprompt without exiting
35 * HTTPS proxy, User Agent, TLS 1.2 (default) support
36 * Comprehensive documentation, man page with handy usage examples
37 * Minimal dependencies
38
40 -h, --help
41 Show help text and exit.
42 -s, --start=N
44 Start at the Nth result.
45 -n, --count=N
47 Show N results (default 10).
48 -N, --news
50 Show results from news section.
51 -c, --tld=TLD
53 Country-specific search with top-level domain .TLD, e.g., in for
54 India.
55 -l, --lang=LANG
57 Search for the language LANG, e.g., fi for Finnish.
58 -x, --exact
60 Disable automatic spelling correction. Search exact keywords.
61 -C, --nocolor
63 Disable color output.
64 --colors=COLORS
66 Set output colors. Refer to the COLORS section below for
67 details.
68 -j, --first, --lucky
70 Open the first result in a web browser; implies --noprompt.
71 Feeling Lucky?
72 -t, --time=dN
74 Time limit search [h5 (5 hrs), d5 (5 days), w5 (5 weeks), m5 (5
75 months), y5 (5 years)].
76 -w, --site=SITE
78 Search a site using Google.
79 --unfilter
81 Do not omit similar results.
82 -p, --proxy=PROXY
84 Tunnel traffic through an HTTP proxy. PROXY is of the form
85 [http://][user:password@]proxyhost[:port]. The proxy server must
86 support HTTP CONNECT tunneling and must not block port 443 for
87 the relevant Google hosts. If a proxy is not explicitly given,
88 the https_proxy environment variable (if available) is used
89 instead.
90 --noua Disable user agent. Results are fetched faster.
92 --notweak
94 Disable TCP optimizations. Negotiate Transport Layer Security
95 protocol instead of forcing TLS 1.2 (on Python 3.4 and above).
96 Should be used only in case of connection issues.
97 --json Output in JSON format; implies --noprompt.
99 --url-handler=UTIL
101 Custom script or command-line utility to open urls with.
102 --show-browser-logs
104 Do not suppress browser output when opening result in browser;
105 that is, connect stdout and stderr of the browser to googler's
106 stdout and stderr instead of /dev/null. By default, browser out‐
107 put is suppressed (due to certain graphical browsers spewing
108 messages to console) unless the BROWSER environment variable is
109 a known text-based browser: elinks, links, lynx, w3m or www-
110 browser.
111 --np, --noprompt
113 Perform search and exit; do not prompt for further interactions.
114 -u, --upgrade
116 Perform in-place self-upgrade. By default, the latest stable
117 version is used. However, the latest git master is used instead
118 if --include-git is also supplied. This mechanism is not avail‐
119 able on Windows (including Cygwin), and if you installed googler
120 with a package manager, this mechanism may have been disabled by
121 your packager at packaging or install time.
122 --include-git
124 See --upgrade.
125 -v, --version
127 Show version number and exit.
128 -d, --debug
130 Enable debugging.
131
133 n, p Fetch the next or previous set of search results.
134 index Open the result corresponding to index in browser.
136 f Jump to the first page.
138 o [index|range|a ...]
140 Open space-separated result indices, numeric ranges (sitelinks
141 unsupported in ranges) or all indices, if 'a' is specified, in
142 the browser. Open the current search in the browser, if no argu‐
143 ments.
144 O [index|range|a ...]
146 Works similar to key 'o', but tries to ignore text-based
147 browsers (even if BROWSER is set) and open links in a GUI
148 browser.
149 g keywords
151 Initiate a new Google search for keywords with original options.
152 This key should be used to search omniprompt keys (including
153 itself) and indices.
154 c index
156 Copy url to clipboard.
157 u Toggle url expansion.
159 q, ^D, double Enter
161 Exit googler.
162 ? Show omniprompt help.
164 * Any other string initiates a new search with original options.
166
168 googler @t is a convenient add-on to Google Site Search with unique
169 keywords. While googler has an integrated option to search a site, it
170 could be simplified further with aliases. The file googler_at
171 (https://github.com/jarun/googler/blob/master/auto-comple‐
172 tion/googler_at/googler_at) contains a list of website search aliases.
173 To source it, run:
174 source googler_at
176 or
178 . googler_at
180 With googler @t, the following command searches Wikipedia for hexspeak:
182 @w hexspeak
184 Other googler options can be combined. The shell can be configured to
186 be source the file at start-up for further convenience.
187 All the aliases start with the @ symbol (hence the name googler @t) and
189 there is minimum chance they will conflict with any shell commands.
190 Users can add new aliases to the file.
191
193 googler allows you to customize the color scheme via a six-letter
194 string, reminiscent of BSD LSCOLORS. The six letters represent the col‐
195 ors of
196 - indices
198 - titles
199 - URLs
200 - metadata/publishing info (Google News only)
201 - abstracts
202 - prompts
203 respectively. The six-letter string is passed in either as the argument
205 to the --colors option, or as the value of the environment variable
206 GOOGLER_COLORS.
207 We offer the following colors/styles:
209 ┌───────┬───────────────────────────────────────────────────┐
211 │Letter │ Color/Style │
212 ├───────├───────────────────────────────────────────────────┤
213 │a │ black │
214 │b │ red │
215 │c │ green │
216 │d │ yellow │
217 │e │ blue │
218 │f │ magenta │
219 │g │ cyan │
220 │h │ white │
221 │i │ bright black │
222 │j │ bright red │
223 │k │ bright green │
224 │l │ bright yellow │
225 │m │ bright blue │
226 │n │ bright magenta │
227 │o │ bright cyan │
228 │p │ bright white │
229 │A-H │ bold version of the lowercase-letter color │
230 │I-P │ bold version of the lowercase-letter bright color │
231 │x │ normal │
232 │X │ bold │
233 │y │ reverse video │
234 │Y │ bold reverse video │
235 └───────┴───────────────────────────────────────────────────┘
236 The default colors string is GKlgxy, which stands for
238 - bold bright cyan indices
240 - bold bright green titles
241 - bright yellow URLs
242 - cyan metadata/publishing info
243 - normal abstracts
244 - reverse video prompts
245 Note that
247 - Bright colors (implemented as \x1b[90m - \x1b[97m) may not be
249 available in all color-capable terminal emulators;
250 - Some terminal emulators draw bold text in bright colors
252 instead;
253 - Some terminal emulators only distinguish between bold and
255 bright colors via a default-off switch.
256 Please consult the manual of your terminal emulator as well as
258 https://en.wikipedia.org/wiki/ANSI_escape_code for details.
259
261 BROWSER
262 Overrides the default browser. Ref:
263 http://docs.python.org/library/webbrowser.html
264 GOOGLER_COLORS
266 Refer to the COLORS section.
267 DISABLE_PROMPT_COLOR
269 Force a plain omniprompt if you are facing issues with
270 colors at the prompt.
271 https_proxy
273 Refer to the --proxy option.
274 DISABLE_URL_EXPANSION
276 Show the domain names in search results instead of the
277 expanded URL.
278
280 1. Google hello world:
281 googler hello world
283 2. Fetch 15 results updated within the last 14 months, starting
285 from the 3rd result for the keywords jungle book in site
286 imdb.com:
287 googler -n 15 -s 3 -t m14 -w imdb.com jungle book
289 3. Read recent news on gadgets:
291 googler -N gadgets
293 4. Fetch results on IPL cricket from Google India server in
295 English:
296 googler -c in -l en IPL cricket
298 5. Search quoted text:
300 googler it\'s a \"beautiful world\" in spring
302 6. Search for a specific file type:
304 googler instrumental filetype:mp3
306 7. Disable automatic spelling correction, e.g. fetch results
308 for googler instead of google:
309 googler -x googler
311 8. I'm feeling lucky search:
313 googler -j leather jackets
315 9. Website specific search:
317 googler -w amazon.com -w ebay.com digital camera
319 Site specific search continues at omniprompt.
321 10. Alias to find definitions of words:
323 alias define='googler -n 2 define'
325 11. Look up n, p, o, O, q, g keywords or a result index at the
327 omniprompt: as the omniprompt recognizes these keys or index
328 strings as commands, you need to prefix them with g, e.g.,
329 g n
331 g g keywords
332 g 1
333 12. Input and output redirection:
335 googler -C hello world < input > output
337 Note that -C is required to avoid printing control charac‐
339 ters (for colored output).
340 13. Pipe output:
342 googler -C hello world | tee output
344 14. Use a custom color scheme, e.g., one warm color scheme
346 designed for Solarized Dark:
347 googler --colors bjdxxy google
349 GOOGLER_COLORS=bjdxxy googler google
351 15. Tunnel traffic through an HTTPS proxy, e.g., a local Privoxy
353 instance listening on port 8118:
354 googler --proxy localhost:8118 google
356 By default the environment variable https_proxy is used, if
358 defined.
359 16. Quote multiple search keywords to auto-complete (using com‐
361 pletion script):
362 googler 'hello w<TAB>
364
366 Henri Hakkinen
367 Arun Prakash Jana <engineerarun@gmail.com>
368 Zhiming Wang <zmwangx@gmail.com>
369
371 https://github.com/jarun/googler
372
374 https://github.com/jarun/googler/issues
375
377 Copyright © 2008 Henri Hakkinen
378 Copyright © 2015-2019 Arun Prakash Jana <engineerarun@gmail.com>
379 License GPLv3+: GNU GPL version 3 or later
381 <http://gnu.org/licenses/gpl.html>.
382 This is free software: you are free to change and redistribute
383 it. There is NO WARRANTY, to the extent permitted by law.
384Version 4.0 27 Nov 2019 GOOGLER(1)