<h1 align="center"ddgr</h1
<p align="center" <a href="https://github.com/jarun/ddgr/releases/latest"<img src="https://img.shields.io/github/release/jarun/ddgr.svg?maxAge=600" alt="Latest release" /</a <a href="https://repology.org/project/ddgr/versions"<img src="https://repology.org/badge/tiny-repos/ddgr.svg?header=repos" alt="Availability"</a <a href="https://pypi.org/project/ddgr/"<img src="https://img.shields.io/pypi/v/ddgr.svg?maxAge=600" alt="PyPI" /</a <a href="https://circleci.com/gh/jarun/workflows/ddgr"<img src="https://img.shields.io/circleci/project/github/jarun/ddgr.svg" alt="Build Status" /</a <a href="https://en.wikipedia.org/wiki/Privacy-invasivesoftware"<img src="https://img.shields.io/badge/privacy-✓-crimson" alt="Privacy Awareness" /</a <a href="https://github.com/jarun/ddgr/blob/master/LICENSE"<img src="https://img.shields.io/badge/license-GPLv3-yellowgreen.svg?maxAge=2592000" alt="License" /</a </p
<p align="center" <a href="https://asciinema.org/a/212198"<img src="https://github.com/user-attachments/assets/52a51b1c-656e-41c6-85ec-3d20319fda70" alt="Asciicast" width="734"/</a </p
ddgr is a cmdline utility to search DuckDuckGo (html version) from the terminal. While googler is extremely popular among cmdline users, in many forums the need of a similar utility for privacy-aware DuckDuckGo came up. DuckDuckGo Bangs are super-cool too! So here's ddgr for you!
Unlike the web interface, you can specify the number of search results you would like to see per page. It's more convenient than skimming through 30-odd search results per page. The default interface is carefully designed to use minimum space without sacrificing readability.
A big advantage of ddgr over googler is DuckDuckGo works over the Tor network.
ddgr isn't affiliated to DuckDuckGo in any way.
<p align="center" <a href="https://www.paypal.com/cgi-bin/webscr?cmd=s-xclick&hostedbuttonid=RMLTQ76JSXJ4Q"<img src="https://img.shields.io/badge/donate-@PayPal-1eb0fc.svg" alt="Donate via PayPal!" /</a </p
Table of contents
- Features
- Installation
- Dependencies
- From a package manager
- From source
- Running standalone
- Shell completion
- Usage
- Cmdline options
- Configuration file
- Text-based browser integration
- Colors
- Examples
- Troubleshooting
- Notes
- Collaborators
- In the Press
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
- Privacy-aware (no unconfirmed user data collection)
- Thoroughly documented, man page with examples
- Minimal dependencies
Installation
#### Dependencies