ddgr - DuckDuckGo from the terminal

       Arun Prakash Jana <engineerarun@gmail.com>

ddgr  allows  you to customize the color scheme via a six-letter string, reminiscent of BSD LSCOLORS. The
       six letters represent the colors of

       - indices
       - titles
       - URLs
       - metadata/publishing info
       - abstracts
       - prompts

       respectively. The six-letter string is passed in either as the argument to the --colors option, or as the
       value of the environment variable DDGR_COLORS.

       We offer the following colors/styles:
         ┌────────┬───────────────────────────────────────────────────┐
         │ Letter │ Color/Style                                       │
         ├────────├───────────────────────────────────────────────────┤
         │ a      │ black                                             │
         │ b      │ red                                               │
         │ c      │ green                                             │
         │ d      │ yellow                                            │
         │ e      │ blue                                              │
         │ f      │ magenta                                           │
         │ g      │ cyan                                              │
         │ h      │ white                                             │
         │ i      │ bright black                                      │
         │ j      │ bright red                                        │
         │ k      │ bright green                                      │
         │ l      │ bright yellow                                     │
         │ m      │ bright blue                                       │
         │ n      │ bright magenta                                    │
         │ o      │ bright cyan                                       │
         │ p      │ bright white                                      │
         │ A-H    │ bold version of the lowercase-letter color        │
         │ I-P    │ bold version of the lowercase-letter bright color │
         │ x      │ normal                                            │
         │ X      │ bold                                              │
         │ y      │ reverse video                                     │
         │ Y      │ bold reverse video                                │
         └────────┴───────────────────────────────────────────────────┘

       The default colors string is oCdgxy, which stands for

       - bright cyan indices
       - bold green titles
       - yellow URLs
       - cyan metadata/publishing info
       - normal abstracts
       - reverse video prompts

       Note that

       - Bright colors (implemented as \x1b[90m - \x1b[97m) may not be available in all  color-capable  terminal
         emulators;

       - Some terminal emulators draw bold text in bright colors instead;

       - Some terminal emulators only distinguish between bold and bright colors via a default-off switch.

       Please consult the manual of your terminal emulator as well as
       https://en.wikipedia.org/wiki/ANSI_escape_code for details.

ddgr  is  a  command-line  tool  to  search DuckDuckGo (html version). ddgr shows the title, URL and text
       context for each result. Results are  fetched  in  pages.  Keyboard  shortcuts  are  available  for  page
       navigation. Results are indexed and a result URL can be opened in a browser using the index number. There
       is no configuration file as aliases serve the same purpose for this utility. Supports sequential searches
       in a single instance.

       Features

         * Fast and clean; custom color
         * Designed for maximum readability at minimum space
         * Instant answers (supported by DDG html version)
         * Custom number of results per page
         * Navigation, browser integration
         * Search and option completion scripts (Bash, Fish, Zsh)
         * DuckDuckGo Bangs (along with completion)
         * Open the first result in browser (I'm Feeling Ducky)
         * REPL for continuous searches
         * Keywords (e.g. `filetype:mime`, `site:somesite.com`)
         * Limit search by time, specify region, disable safe search
         * HTTPS proxy support, optionally disable User Agent
         * Do Not Track set by default
         * Supports custom url handler script or cmdline utility
         * Thoroughly documented, man page with examples
         * Minimal dependencies

BROWSER
              Overrides the default browser. Ref: http://docs.python.org/library/webbrowser.htmlDDGR_COLORS
              Refer to the COLORS section.

       DISABLE_PROMPT_COLOR
              Force a plain omniprompt if you are facing issues with colors at the prompt.

       HTTPS_PROXY,https_proxy
              Refer to the --proxy option.

       1.  DuckDuckGo helloworld:

              ddgrhelloworld

       2.  I'mFeelingDucky search:

              ddgr-jluckyducks

       3.  DuckDuckGoBang search 'hello world' in Wikipedia:

              ddgr!whelloworldddgr\!whelloworld//bash-specific,needtoescape!onbash

           Bangs work at the omniprompt too. To look up bangs, visit https://duckduckgo.com/bang?#bangs-list.

       4.  Bangalias to fire from the cmdline, open results in a GUI browser and exit:

              aliasbang='ddgr--gb--np'bang!whelloworldbang\!whelloworld//bash-specific,needtoescape!onbash

       5.  Websitespecific search:

              ddgr-wamazon.comdigitalcamera

           Site specific search continues at omniprompt.

       6.  Search for a specificfiletype:

              ddgrinstrumentalfiletype:mp3

       7.  Fetch results on IPL cricket from India in English:

              ddgr-rin-enIPLcricket

           To find your region parameter token visit https://duckduckgo.com/params.

       8.  Search quotedtext:

              ddgrit\'sa\"beautifulworld\"inspring

       9.  Show completeurls in search results (instead of only domain name):

              ddgr-xddgr

       10. Use a customcolorscheme, e.g., one warm color scheme designed for Solarized Dark:

              ddgr--colorsbjdxxyhelloworldDDGR_COLORS=bjdxxyddgrhelloworld

       11. Tunnel traffic through an HTTPSproxy, e.g., a local Privoxy instance listening on port 8118:

              ddgr--proxylocalhost:8118helloworld

           By default the environment variable https_proxy (or HTTPS_PROXY) is used, if defined.

       12. Look  up  n, p, o, O, q, dkeywords or a result index at the omniprompt: as the omniprompt recognizes
           these keys or index strings as commands, you need to prefix them with d, e.g.,

              dnddkeywordsd1

https://github.com/jarun/ddgr

       Copyright © 2016-2024 Arun Prakash Jana <engineerarun@gmail.com>

       License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it. There is NO WARRANTY,  to  the  extent
       permitted by law.

Version 2.2                                        29 Dec 2023                                           DDGR(1)

       ddgr - DuckDuckGo from the terminal

n,p,f
              Fetch the next, previous or first set of search results.

       index  Open the result corresponding to index in browser.

       o[index|range|a...]
              Open space-separated result indices, numeric ranges or all indices, if 'a' is  specified,  in  the
              browser.

       O[index|range|a...]
              Works  similar  to  key  'o', but tries to ignore text-based browsers (even if BROWSER is set) and
              open links in a GUI browser.

       dkeywords
              Initiate a new DuckDuckGo search for keywords with original options. This key should  be  used  to
              search omniprompt keys (including itself) and indices.

       x      Toggle url expansion.

       cindex
              Copy url to clipboard.

       q,^D,doubleEnter
              Exit ddgr.

       ?      Show omniprompt help.

       *      Any other string initiates a new search with original options.

-h,--help
              Show help text and exit.

       -n,--num=N
              Show  N  results  per page (default 10). N must be between 0 and 25. N=0 disables fixed paging and
              shows actual number of results fetched per page.

       -r,--reg=REG
              Region-specific search e.g. 'us-en' for US (default); visit https://duckduckgo.com/params.

       -C,--nocolor
              Disable color output.

       --colors=COLORS
              Set output colors. Refer to the COLORS section below for details.

       -j,--ducky
              Open the first result in a web browser; implies --noprompt. Feeling Ducky?

       -t,--time=SPAN
              Time limit search [d=past day, w=past week, m=past month, y=past year] (default=any time).

       -w,--site=SITE
              Search a site using DuckDuckGo.

       -x,--expand
              Expand URLs instead of showing only the domain name (default).

       -p,--proxy=URI
              Tunnel traffic through an HTTP proxy. URI is of the form  [http[s]://][user:pwd@]host[:port].  The
              proxy  server  must  support  HTTP  CONNECT tunneling and must not block port 443 for the relevant
              DuckDuckGo hosts. If a proxy is not explicitly given, the https_proxy or  HTTPS_PROXY  environment
              variable (if available) is used instead.

       --unsafe
              Disable safe search.

       --noua Disable user agent. Results are fetched faster.

       --json Output in JSON format; implies --noprompt.

       --gb,--gui-browser
              Open a bang directly in a GUI browser.

       --np,--noprompt
              Perform search and exit; do not prompt for further interactions.

       --rev,--reverse
              List the entries in reversed order.

       --url-handler=UTIL
              Custom script or command-line utility to open urls with.

       --show-browser-logs
              Do  not suppress browser output when opening result in browser; that is, connect stdout and stderr
              of the browser to ddgr's stdout and stderr instead of /dev/null. By  default,  browser  output  is
              suppressed  (due  to  certain  graphical  browsers spewing messages to console) unless the BROWSER
              environment variable is a known text-based browser: elinks, links, lynx, w3m or www-browser.

       -v,--version
              Show version number and exit.

       -d,--debug
              Enable debugging.

https://github.com/jarun/ddgr/issues

ddgr[OPTIONS][KEYWORD[KEYWORD...]]