NAME¶

SYNOPSIS¶

DESCRIPTION¶

Features

* Fast and clean (no ads, stray URLs or clutter), custom color * Designed to deliver maximum readability at minimum space * Instant answers (which appear in the html version of DDG) * Specify the number of search results to show per page * Navigate result pages from omniprompt, open URLs in browser * Search and option completion scripts for Bash, Zsh and Fish * DuckDuckGo Bang support (along with completion) * Open the first result directly in browser (as in I'm Feeling Ducky) * Non-stop searches: fire new searches at omniprompt without exiting * Keywords (e.g. filetype:mime, site:somesite.com) support * Limit search by time, specify region, disable safe search * HTTPS proxy support, Do Not Track set, optionally disable User Agent * Support custom url handler script or cmdline utility * Comprehensive documentation, man page with handy usage examples * Minimal dependencies

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] (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.

-I, --noinstant

Disable instant answer.

--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.

--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.

OMNIPROMPT KEYS¶

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.

d keywords

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.

c index

Copy url to clipboard.

q, ^D, double Enter

Exit ddgr.

?

Show omniprompt help.

*

Any other string initiates a new search with original options.

COLORS¶

-

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.

ENVIRONMENT¶

BROWSER

Overrides the default browser. Ref: http://docs.python.org/library/webbrowser.html

DDGR_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.

EXAMPLES¶

1.

DuckDuckGo hello world:

ddgr hello world
    

2.

I'm Feeling Ducky search:

ddgr -j lucky ducks
    

3.

DuckDuckGo Bang search 'hello world' in Wikipedia:

ddgr !w hello world
ddgr \!w hello world // bash-specific, need to escape ! on bash
    

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

4.

Bang alias to fire from the cmdline, open results in a GUI browser and exit:

alias bang='ddgr --gb --np'
    

bang !w hello world
bang \!w hello world // bash-specific, need to escape ! on bash
    

5.

Website specific search:

ddgr -w amazon.com digital camera
    

Site specific search continues at omniprompt.

6.

Search for a specific file type:

ddgr instrumental filetype:mp3
    

7.

Fetch results on IPL cricket from India in English:

ddgr -r in-en IPL cricket
    

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

8.

Search quoted text:

ddgr it\'s a \"beautiful world\" in spring
    

9.

Show complete urls in search results (instead of only domain name):

ddgr -x ddgr
    

10.

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

ddgr --colors bjdxxy hello world
    

DDGR_COLORS=bjdxxy ddgr hello world
    

11.

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

ddgr --proxy localhost:8118 hello world
    

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

12.

Look up n, p, o, O, q, d keywords 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.,

d n
    

d d keywords
    

d 1

    

AUTHOR¶

HOME¶

REPORTING BUGS¶

LICENSE¶

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.