LinuxCommandLibrary

googler

Search Google from the command line

TLDR

Search Google for a keyword

$ googler [keyword]
copy

Search Google and open the first result in web browser
$ googler [[-j|--first]] [keyword]
copy

Show n search results (default: 10)
$ googler [[-n|--count]] [n] [keyword]
copy

Disable automatic spelling correction
$ googler [[-x|--exact]] [keyword]
copy

Search one site for a keyword
$ googler [[-w|--site]] [site] [keyword]
copy

Show Google search result in JSON format
$ googler --json [keyword]
copy

Perform in-place self-upgrade
$ googler [[-u|--upgrade]]
copy

Display help in interactive mode
$ <?>
copy

SYNOPSIS

googler [options] query

PARAMETERS

-n
    Number of results to display (default: 10).

-N
    Start displaying results from the Nth result.

-w
    Search only within a specific website.

-g
    Search Google for a specific country/region (e.g., 'us', 'in').

-l
    Set the search language.

-t
    Limit search to a specified duration (e.g., 'h5' for 5 hours, 'd2' for 2 days, 'w1' for 1 week).

-c
    Country code to use for search (e.g., 'US', 'IN').

-x
    Open the first result in the browser.

-o
    Open all results in the browser.

-j
    Open the result specified by a search result number in the browser.

-u
    Do not display URL links, show only titles.

-C
    Disable color output.

-s
    Specify the search engine to use. Some options include 'google', 'duckduckgo', 'bing'.

-i
    Perform image search.

-v
    Print version information and exit.

-h
    Display help message and exit.

DESCRIPTION

The googler command is a powerful command-line tool that allows you to access Google Search (and other search engines) directly from your terminal.
It provides a clean, distraction-free interface to view search results without needing a web browser.
You can use it for quick lookups, researching programming topics, or any other information-gathering task. Googler supports various features like specifying the number of results, searching specific websites, using keywords, opening results directly in a browser, and even searching for images.
It is highly customizable through configuration files and command-line options, enabling you to tailor the search experience to your specific needs. It is particularly useful for developers, system administrators, and anyone who frequently works in the terminal and wants a fast and efficient way to access online information. It uses a text-based interface for results.

CAVEATS

Googler relies on scraping the Google search results page, which is against Google's terms of service.
The search engine may change its HTML structure, potentially breaking Googler's functionality.
Use responsibly and consider respecting the robots.txt file.

CONFIGURATION

Googler can be configured through a configuration file located at ~/.config/googler/config. This file allows you to customize various aspects of Googler's behavior, such as default number of results, color schemes, and other settings. You can also define aliases for common search queries to simplify your workflow.

AUTHENTICATION

For some search engines or advanced features, Googler might require authentication.
The details on how to configure authentication are available in the Googler documentation on Github.

HISTORY

Googler was created to provide a terminal-based interface to Google Search, offering a more efficient and distraction-free way to access information. It gained popularity among developers and system administrators who prefer working within the terminal. It's actively maintained and updated to adapt to changes in Google's search engine and add new features.

SEE ALSO

curl(1), wget(1)

Copied to clipboard