# sahir247/google-dorking-tool architecture

> Architecture diagram of the GitHub repository sahir247/google-dorking-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sahir247/google-dorking-tool
- Repository: https://github.com/sahir247/google-dorking-tool

## Overview

Google Dorking Tool is a PySide6 desktop app for authorized OSINT query building and search. The primary workflow starts in the search tab, where targets and query forms/templates produce dorks; users run them through the main-window orchestration, then inspect results or export reports. Separate capabilities cover direct browser searches, credentials and quota, saved bookmarks/history, and help. Edges reflect calls or wiring visible in excerpts or README; unsampled subsystems are represented only where documented, and their internal links are omitted when unverified.

Main entry points: [`dork_tool/ui/main_window.py`](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/main_window.py) (Main window), [`dork_tool/ui/search_tab.py`](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/search_tab.py) (Search builder), [`dork_tool/workers.py`](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/workers.py) (Search workers), [`dork_tool/ui/creds_tab.py`](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/creds_tab.py) (Credentials and quota)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Application entry<br/>[main.py]"]
  node_window["Main window<br/>[main_window.py]"]
  node_searchtab["Search builder<br/>[search_tab.py]"]
  node_resulttab["Results explorer<br/>[results_tab.py]"]
  node_savedtab["Saved and history<br/>[saved_tab.py]"]
  node_credtab["Credentials and quota<br/>[creds_tab.py]"]
  node_helptab["Reference guide<br/>[help_tab.py]"]
  node_loader["UI loader<br/>[loader.py]"]
end

subgraph group_query["Query construction"]
  node_engine["Dork engine<br/>[engine.py]"]
end

subgraph group_search["Search execution"]
  node_browser["Google browser search<br/>[search_tab.py]"]
  node_worker["Search workers<br/>[workers.py]"]
  node_model["Search result model<br/>[models.py]"]
end

subgraph group_data["Persistence and output"]
  node_exporter["Report exporter<br/>[exporter.py]"]
  node_credentials["Credential manager<br/>[security.py]"]
  node_limiter["Quota limiter<br/>[rate_limiter.py]"]
  node_bookmarks[("Bookmarks and history<br/>[bookmarks.py]")]
end

node_user(("Investigator"))
node_google["Google Custom Search API"]

node_user -->|"launches"| node_app
node_app -->|"creates"| node_window
node_window -->|"loads UI"| node_loader
node_window -->|"creates tab"| node_searchtab
node_window -->|"creates tab"| node_resulttab
node_window -->|"creates tab"| node_savedtab
node_window -->|"creates tab"| node_credtab
node_window -->|"creates tab"| node_helptab
node_searchtab -->|"builds queries"| node_engine
node_searchtab -->|"opens search"| node_browser
node_window -->|"starts worker"| node_worker
node_worker -->|"requests results"| node_google
node_worker -->|"records requests"| node_limiter
node_worker -->|"creates results"| node_model
node_window -->|"routes updates"| node_resulttab
node_resulttab -->|"exports reports"| node_exporter
node_window -->|"loads credentials"| node_credentials
node_window -->|"tracks quota"| node_limiter
node_credtab -->|"manages credentials"| node_credentials
node_credtab -->|"shows quota"| node_limiter
node_window -->|"uses history"| node_bookmarks
node_savedtab -->|"manages saved data"| node_bookmarks
node_searchtab -->|"records browser history"| node_bookmarks

click node_app "https://github.com/sahir247/google-dorking-tool/blob/main/main.py"
click node_window "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/main_window.py"
click node_searchtab "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/search_tab.py"
click node_resulttab "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/results_tab.py"
click node_savedtab "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/saved_tab.py"
click node_credtab "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/creds_tab.py"
click node_helptab "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/help_tab.py"
click node_loader "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/loader.py"
click node_engine "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/engine.py"
click node_browser "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/search_tab.py"
click node_worker "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/workers.py"
click node_model "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/models.py"
click node_exporter "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/exporter.py"
click node_credentials "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/security.py"
click node_limiter "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/rate_limiter.py"
click node_bookmarks "https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/bookmarks.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_window,node_searchtab,node_resulttab,node_savedtab,node_credtab,node_helptab,node_loader toneBlue
class node_engine toneAmber
class node_browser,node_worker,node_model,node_google toneMint
class node_exporter,node_credentials,node_limiter,node_bookmarks toneRose
class node_user toneIndigo
```

## Components

### Desktop interface

- [Application entry](https://github.com/sahir247/google-dorking-tool/blob/main/main.py): `main.py`
- [Main window](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/main_window.py): `dork_tool/ui/main_window.py`
- [Search builder](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/search_tab.py): `dork_tool/ui/search_tab.py`
- [Results explorer](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/results_tab.py): `dork_tool/ui/results_tab.py`
- [Saved and history](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/saved_tab.py): `dork_tool/ui/saved_tab.py`
- [Credentials and quota](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/creds_tab.py): `dork_tool/ui/creds_tab.py`
- [Reference guide](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/help_tab.py): `dork_tool/ui/help_tab.py`
- [UI loader](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/loader.py): `dork_tool/ui/loader.py`

### Query construction

- [Dork engine](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/engine.py): `dork_tool/engine.py`

### Search execution

- [Google browser search](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/ui/search_tab.py): `dork_tool/ui/search_tab.py`
- [Search workers](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/workers.py): `dork_tool/workers.py`
- [Search result model](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/models.py): `dork_tool/models.py`

### Persistence and output

- [Report exporter](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/exporter.py): `dork_tool/exporter.py`
- [Credential manager](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/security.py): `dork_tool/security.py`
- [Quota limiter](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/rate_limiter.py): `dork_tool/rate_limiter.py`
- [Bookmarks and history](https://github.com/sahir247/google-dorking-tool/blob/main/dork_tool/bookmarks.py): `dork_tool/bookmarks.py`

### Other components

- **Investigator**
- **Google Custom Search API**

## Connections

- Investigator → Application entry: launches (evidence: `README.md`)
- Application entry → Main window: creates (evidence: `main.py`)
- Main window → UI loader: loads UI (evidence: `dork_tool/ui/main_window.py`)
- Main window → Search builder: creates tab (evidence: `dork_tool/ui/main_window.py`)
- Main window → Results explorer: creates tab (evidence: `dork_tool/ui/main_window.py`)
- Main window → Saved and history: creates tab (evidence: `dork_tool/ui/main_window.py`)
- Main window → Credentials and quota: creates tab (evidence: `dork_tool/ui/main_window.py`)
- Main window → Reference guide: creates tab (evidence: `dork_tool/ui/main_window.py`)
- Search builder → Dork engine: builds queries (evidence: `dork_tool/ui/search_tab.py`)
- Search builder → Google browser search: opens search (evidence: `dork_tool/ui/search_tab.py`)
- Main window → Search workers: starts worker (evidence: `dork_tool/ui/main_window.py`)
- Search workers → Google Custom Search API: requests results (evidence: `dork_tool/workers.py`)
- Search workers → Quota limiter: records requests (evidence: `dork_tool/workers.py`)
- Search workers → Search result model: creates results (evidence: `dork_tool/workers.py`)
- Main window → Results explorer: routes updates (evidence: `dork_tool/ui/main_window.py`)
- Results explorer → Report exporter: exports reports (evidence: `dork_tool/ui/results_tab.py`)
- Main window → Credential manager: loads credentials (evidence: `dork_tool/ui/main_window.py`)
- Main window → Quota limiter: tracks quota (evidence: `dork_tool/ui/main_window.py`)
- Credentials and quota → Credential manager: manages credentials (evidence: `dork_tool/ui/creds_tab.py`)
- Credentials and quota → Quota limiter: shows quota (evidence: `dork_tool/ui/creds_tab.py`)
- Main window → Bookmarks and history: uses history (evidence: `dork_tool/ui/main_window.py`)
- Saved and history → Bookmarks and history: manages saved data (evidence: `dork_tool/ui/saved_tab.py`)
- Search builder → Bookmarks and history: records browser history (evidence: `dork_tool/ui/search_tab.py`)
