- name
- ddg
- description
- Use ddgr (DuckDuckGo from the terminal) to perform privacy-focused web searches from the command line. Use when the user wants to (1) Search the web from the terminal, (2) Perform DuckDuckGo searches without opening a browser, (3) Get quick search results in text format, (4) Search privately without tracking, (5) Use DuckDuckGo bangs (!) from terminal.
ddgr - DuckDuckGo from the Terminal
ddgr is a command-line utility to search DuckDuckGo from the terminal. It provides fast, privacy-focused web searches without opening a browser.
Installation
Via Snap (recommended for Ubuntu):
sudo snap install ddgrVia PPA:
sudo add-apt-repository ppa:twodopeshaggy/jarun
sudo apt-get update
sudo apt-get install ddgrFrom source:
git clone https://github.com/jarun/ddgr.git
cd ddgr
sudo make installDependencies: Python 3.8 or later
Basic Usage
Simple search (non-interactive):
snap run ddgr "search query" --npSearch with specific number of results:
snap run ddgr "search query" --num 5 --npSearch with time limit:
snap run ddgr "query" --time w --np # past week
snap run ddgr "query" --time m --np # past month
snap run ddgr "query" --time y --np # past yearSite-specific search:
snap run ddgr "query" --site github.com --npJSON output:
snap run ddgr "query" --json --npOpen first result in browser:
snap run ddgr "query" --duckyInteractive Mode
Run without --np to enter interactive mode:
snap run ddgr "search query"Interactive commands:
1,2,3... → open result in browsern→ next page of resultsp→ previous page of resultsqorCtrl+D→ quit?→ show help
Advanced Options
| Option | Description |
|---|---|
-n N, --num N | Show N results per page (0-25, default 10) |
-r REG, --reg REG | Region-specific search (e.g., 'us-en', 'uk-en') |
-t SPAN, --time SPAN | Time limit: d (day), w (week), m (month), y (year) |
-w SITE, --site SITE | Search specific site |
-x, --expand | Show complete URLs |
--json | Output in JSON format |
--ducky | Open first result in browser |
--np, --noprompt | Non-interactive mode |
--unsafe | Disable safe search |
DuckDuckGo Bangs
Use DuckDuckGo bangs to search specific sites:
snap run ddgr "!w Linux" --np # Wikipedia search
snap run ddgr "!yt music" --np # YouTube search
snap run ddgr "!gh python" --np # GitHub search
snap run ddgr "!a books" --np # Amazon searchMake it Easier with an Alias
Add to ~/.bashrc or ~/.zshrc:
alias ddg='snap run ddgr'Then use:
ddg "search query" --npPrivacy Features
- No user tracking or profiling
- Do Not Track enabled by default
- Works over Tor network (with proxy)
- HTTPS proxy support
- No stored search history
Examples
Search for tech news:
snap run ddgr "latest AI news 2025" --num 5 --npFind Ubuntu tutorials:
snap run ddgr "Ubuntu tutorial" --site askubuntu.com --npSearch recent Python documentation:
snap run ddgr "Python 3.12 features" --time m --npUse bang to search Wikipedia:
snap run ddgr "!w OpenClaw" --npTroubleshooting
Command not found:
- Ensure ddgr is installed via snap:
sudo snap install ddgr - Use full command:
snap run ddgrinstead of justddgr
No results:
- Check internet connection
- Try without
--npto see if interactive mode works - Verify DuckDuckGo is accessible in your region
Slow response:
- DuckDuckGo HTML interface can be slower than main site
- Use
--timeto limit results by time for faster queries
More Information
- GitHub: https://github.com/jarun/ddgr
- DuckDuckGo: https://duckduckgo.com
- Bangs: https://duckduckgo.com/bang