Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

95 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

DDGS

Dux Distributed Global Search β€” Metasearch across 14 engines with full privacy-first protection

Google Play Store Windows EXE Linux DEB Linux RPM Flet Python


Download

Platform Download Notes
πŸ€– Android Play Store Recommended for Android mobile users
πŸͺŸ Windows Windows Release Automated standalone setup installer with desktop shortcut integration
🐧 Linux (Debian/Ubuntu) Linux DEB Desktop package tailored for Ubuntu, Debian, Linux Mint & Pop!_OS
🎩 Linux (Fedora/RHEL) Linux RPM Desktop package tailored for Fedora, openSUSE, RHEL & CentOS
πŸ“¦ Linux (Universal Portable) Linux TAR.GZ Universal standalone portable archive for Arch, Alpine, Steam Deck & all distros

Android Architecture Build Splits

Variant Download Notes
πŸ“± ARM64 (most phones) ddgs-arm64-v8a.apk Modern 64-bit Android devices
πŸ“± ARMv7 (older phones) ddgs-armeabi-v7a.apk Legacy 32-bit Android devices
πŸ’» x86_64 (emulators) ddgs-x86_64.apk Chromebooks & Android emulators

Core Capabilities

Capability Description
14 Search Engines Simultaneously queries Brave, DuckDuckGo, Google, Bing, Yahoo, Yandex, Startpage, Mojeek, Wikipedia, Grokipedia, and more.
All Media Types Search the web, images, videos, news, and books β€” all in one app.
Page Extraction Extract any webpage as Markdown, plain text, rich text, raw HTML, or binary content.
Backend Selection Choose specific search engines or let Auto pick the best combination.
Time Filters Filter results by day, week, month, or year.
Safe Search Three levels: off, moderate, and strict content filtering.
Full Transparency Every search is logged for debugging. No data leaves your device.
Privacy-First No tracking, no logging, no middleman. Direct connections from your device.

Features

  • Privacy-First Metasearch β€” No tracking, no logging, no middleman. Direct connections from your device to the search engines.
  • All DDGS Capabilities β€” Web, images, videos, news, books, and page extraction β€” every DDGS method exposed.
  • Backend Selection β€” Choose from 14 search engines or let Auto select the best combination.
  • Time Filters β€” Filter by day, week, month, or year for any search type.
  • Safe Search β€” Three levels of content filtering (off, moderate, strict).
  • Proxy & SSL Config β€” Configure proxy and SSL verification for network-restricted environments.
  • Thread Control β€” Adjust max threads for performance tuning.
  • Page Extraction β€” Extract any URL as Markdown, plain text, rich text, raw HTML, or binary content.
  • Full Debug Logging β€” Every DDGS call, every error, every performance metric logged to file and stdout for primp crash investigation.
  • Ruff Compliance β€” Clean, formatted, and strictly linted Python codebase.

Screenshots

Mobile Home Dashboard

Home Dashboard Light Home Dashboard Dark
Home Dashboard (Light Mode) β€” Clean search categories grid and parameters bar. Home Dashboard (Dark Mode) β€” Sleek slate-black interface displaying recent queries.

Search Results Views

Text Search Results Image Search Results Video Search Results
Web Search β€” Clean card-based metasearch results with integrated sponsored ads. Image Grid β€” 2-column scrollable image search with dimension overlays. Video Index β€” Rich streaming lists with video duration tags and view counts.

Page Extraction & News Results

Web Page Extraction News Results
Page Extraction β€” Rendered Markdown reader with source link browser launching. News Results β€” Live news feed with publisher details and thumbnails.

Advanced Settings & History

Settings - Search Rules Settings - Backends & Downloads Settings - Network & Terminal
Theme & Rules β€” Safe-search toggles, max results slider, and region filters. Backends & Downloads β€” Preferred video qualities and extraction defaults. Proxies & Diagnostics β€” Network proxy configurations and live activity logs terminal.

Search History

Local Search History (Light Mode) β€” Chronological log of recent search queries and extraction runs with clear-all controls and instant rerun shortcuts.


Architecture

Layer Technology Purpose
Frontend Flet (Flutter engine) Cross-platform UI with clean responsive views and smooth page transitions
Search Core ddgs (DDGS library) Metasearch engine aggregating results from 14 providers
HTTP Client primp (Rust-based) Fast async HTTP/2 client with browser emulation and TLS fingerprinting
Local Storage Flet Client Storage Ultra-fast local key-value storage for settings, theme state, and logs
Async Runtime asyncio + threading Thread-safe progress reporting with cancellation support

Visual Flow

graph TB
    subgraph DDGS_CLIENT ["πŸ“± DDGS CLIENT (Local-First Metasearch App)"]
        UI["🎨 Flet Reactive UI (Home | Results | History | Settings)"]
        Engine["βš™οΈ DDGS Search Engine (ddgs library)"]
        Storage["πŸ’Ύ Local Storage (flet client_storage)"]
        UI --> Engine
        UI --> Storage
    end

    subgraph SEARCH_PROVIDERS ["🌐 14 SEARCH ENGINES"]
        DDG["πŸ¦† DuckDuckGo"]
        Google["πŸ” Google"]
        Brave["🦁 Brave"]
        Bing["πŸ”΅ Bing"]
        Yahoo["πŸ‘» Yahoo"]
        Yandex["πŸ”΄ Yandex"]
        Others["πŸ“‘ Wikipedia, Startpage, Mojeek, Grokipedia, AnnasArchive & more"]
    end

    subgraph DEBUG ["πŸ”§ PRIMP CRASH DETECTION"]
        Logs["πŸ“ File + stdout logging"]
        Logcat["πŸ“± ADB logcat monitoring"]
    end

    Engine ==>|primp HTTP/2| DDG
    Engine ==>|primp HTTP/2| Google
    Engine ==>|primp HTTP/2| Brave
    Engine ==>|primp HTTP/2| Bing
    Engine ==>|primp HTTP/2| Yahoo
    Engine ==>|primp HTTP/2| Yandex
    Engine ==>|primp HTTP/2| Others
    Engine -.->|DDGS_CALL_FAILED| Logs
    Engine -.->|PRIMP_CRASH_DETECTED| Logcat
Loading

Search Performance Guide

Search Type Backend Typical Results
Web Auto (all engines) 20-100 results in 2-5 seconds
Images DuckDuckGo / Bing 20-60 results in 1-3 seconds
Videos DuckDuckGo 10-30 results in 1-3 seconds
News DuckDuckGo / Bing / Yahoo 20-50 results in 1-3 seconds
Books Anna's Archive 10-20 results in 2-4 seconds
Page Extract Direct HTTP fetch Instant content extraction

Privacy & Security

DDGS is designed with a strict Privacy-First philosophy:

  1. Local Connections: All searches are sent directly from your own device IP address. No middleman, proxy, or server tracking.
  2. Zero Logging: We do not log, track, or share your search history, queries, or results.
  3. No Account Required: No sign-up, no tracking cookies, no personal data collection.
  4. Full Configurability: Proxy support, SSL verification toggle, and backend selection give you full control.

Legal Disclaimer

DDGS is a metasearch tool that aggregates results from public search engines. It does not store, cache, or redistribute search results. Users are solely responsible for ensuring compliance with target search engines' Terms of Service and local privacy regulations (e.g. GDPR, CCPA). The authors take no responsibility for misuse of this tool.


Credits

  • Search core: the ddgs library (MIT) by deedy5
  • HTTP client: primp (Rust, HTTP/2)
  • UI: Flet (Flutter engine)

About

Metasearch across 14 engines (DuckDuckGo, Google, Brave, Bing, Yahoo, Yandex, Startpage, Wikipedia, and more) with full privacy. Built with Flet for Android.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages