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):
CODEBLOCK0
Via PPA:
CODEBLOCK1
From source:
CODEBLOCK2
Dependencies: Python 3.8 or later
Basic Usage
Simple search (non-interactive):
CODEBLOCK3
Search with specific number of results:
CODEBLOCK4
Search with time limit:
CODEBLOCK5
Site-specific search:
CODEBLOCK6
JSON output:
CODEBLOCK7
Open first result in browser:
CODEBLOCK8
Interactive Mode
Run without --np to enter interactive mode:
CODEBLOCK9
Interactive commands:
- -
1, 2, 3... → open result in browser - INLINECODE4 → next page of results
- INLINECODE5 → previous page of results
- INLINECODE6 or
Ctrl+D → quit - INLINECODE8 → show help
Advanced Options
| Option | Description |
|---|
| INLINECODE9 , INLINECODE10 | Show N results per page (0-25, default 10) |
| INLINECODE11 , INLINECODE12 |
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:
CODEBLOCK10
Make it Easier with an Alias
Add to ~/.bashrc or ~/.zshrc:
CODEBLOCK11
Then use:
CODEBLOCK12
Privacy 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:
CODEBLOCK13
Find Ubuntu tutorials:
CODEBLOCK14
Search recent Python documentation:
CODEBLOCK15
Use bang to search Wikipedia:
CODEBLOCK16
Troubleshooting
Command not found:
- - Ensure ddgr is installed via snap: INLINECODE26
- Use full command:
snap run ddgr instead of just INLINECODE28
No results:
- - Check internet connection
- Try without
--np to see if interactive mode works - Verify DuckDuckGo is accessible in your region
Slow response:
- - DuckDuckGo HTML interface can be slower than main site
- Use
--time to limit results by time for faster queries
More Information
- - GitHub: https://github.com/jarun/ddgr
- DuckDuckGo: https://duckduckgo.com
- Bangs: https://duckduckgo.com/bang
ddgr - 终端中的DuckDuckGo
ddgr 是一个命令行工具，用于在终端中搜索DuckDuckGo。它提供快速、注重隐私的网络搜索，无需打开浏览器。
安装
通过Snap安装（推荐Ubuntu用户）：
bash
sudo snap install ddgr
通过PPA安装：
bash
sudo add-apt-repository ppa:twodopeshaggy/jarun
sudo apt-get update
sudo apt-get install ddgr
从源码安装：
bash
git clone https://github.com/jarun/ddgr.git
cd ddgr
sudo make install
依赖项： Python 3.8 或更高版本
基本用法
简单搜索（非交互模式）：
bash
snap run ddgr 搜索关键词 --np
指定结果数量的搜索：
bash
snap run ddgr 搜索关键词 --num 5 --np
带时间限制的搜索：
bash
snap run ddgr 关键词 --time w --np # 过去一周
snap run ddgr 关键词 --time m --np # 过去一个月
snap run ddgr 关键词 --time y --np # 过去一年
指定网站搜索：
bash
snap run ddgr 关键词 --site github.com --np
JSON输出：
bash
snap run ddgr 关键词 --json --np
在浏览器中打开第一个结果：
bash
snap run ddgr 关键词 --ducky
交互模式
不使用 --np 运行即可进入交互模式：
bash
snap run ddgr 搜索关键词
交互命令：
- - 1、2、3... → 在浏览器中打开结果
- n → 下一页结果
- p → 上一页结果
- q 或 Ctrl+D → 退出
- ? → 显示帮助
高级选项
| 选项 | 描述 |
|---|
| -n N, --num N | 每页显示N个结果（0-25，默认10） |
| -r REG, --reg REG |
区域特定搜索（例如 us-en、uk-en） |
| -t SPAN, --time SPAN | 时间限制：d（天）、w（周）、m（月）、y（年） |
| -w SITE, --site SITE | 搜索特定网站 |
| -x, --expand | 显示完整URL |
| --json | 以JSON格式输出 |
| --ducky | 在浏览器中打开第一个结果 |
| --np, --noprompt | 非交互模式 |
| --unsafe | 禁用安全搜索 |
DuckDuckGo快捷搜索
使用DuckDuckGo快捷搜索特定网站：
bash
snap run ddgr !w Linux --np # 维基百科搜索
snap run ddgr !yt music --np # YouTube搜索
snap run ddgr !gh python --np # GitHub搜索
snap run ddgr !a books --np # 亚马逊搜索
使用别名简化操作
添加到 ~/.bashrc 或 ~/.zshrc：
bash
alias ddg=snap run ddgr
然后使用：
bash
ddg 搜索关键词 --np
隐私功能
- - 无用户跟踪或画像
- 默认启用请勿追踪
- 支持通过Tor网络运行（需代理）
- 支持HTTPS代理
- 不存储搜索历史
示例
搜索科技新闻：
bash
snap run ddgr 2025年最新AI新闻 --num 5 --np
查找Ubuntu教程：
bash
snap run ddgr Ubuntu教程 --site askubuntu.com --np
搜索近期Python文档：
bash
snap run ddgr Python 3.12 特性 --time m --np
使用快捷搜索维基百科：
bash
snap run ddgr !w OpenClaw --np
故障排除
命令未找到：
- - 确保已通过snap安装ddgr：sudo snap install ddgr
- 使用完整命令：snap run ddgr 而不是仅 ddgr
无结果：
- - 检查网络连接
- 尝试不使用 --np 查看交互模式是否正常工作
- 确认DuckDuckGo在您所在地区可访问
响应缓慢：
- - DuckDuckGo的HTML界面可能比主站慢
- 使用 --time 按时间限制结果以加快查询速度
更多信息
- - GitHub：https://github.com/jarun/ddgr
- DuckDuckGo：https://duckduckgo.com
- 快捷搜索：https://duckduckgo.com/bang
