# dharineeshj/pytster architecture

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

- Interactive diagram: https://gitdiagram.com/dharineeshj/pytster
- Repository: https://github.com/dharineeshj/pytster

## Overview

Pytster accepts an indicator, queries OSINT services, and presents consolidated findings as text with optional JSON/PDF reports. The repository has two front ends: a command-line Python scanner and a Qt GUI that starts a Python analysis script and displays its standard output. The GUI script is located under a build-named directory in the checked-in tree; its relationship to the GUI is shown directly in the widget source. The excerpts show representative service calls and report handling, but not every branch or GUI detail.

Main entry points: [`GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`](https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py) (GUI analyzer), [`GUI/IOC_Project/widget.cpp`](https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/widget.cpp) (Input interface), [`Command Line/pytster-cmd.py`](https://github.com/dharineeshj/pytster/blob/main/Command%20Line/pytster-cmd.py) (CLI scanner), [`GUI/IOC_Project/main.cpp`](https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/main.cpp) (Qt entry point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["Qt GUI"]
  node_qt_entry["Qt entry point<br/>[main.cpp]"]
  node_widget["Input interface<br/>[widget.cpp]"]
  node_gui_validation["Input validation<br/>[widget.cpp]"]
  node_gui_runner["Python process runner<br/>[widget.cpp]"]
end

subgraph group_analysis["Indicator analysis"]
  node_cli["CLI scanner<br/>[pytster-cmd.py]"]
  node_gui_analyzer["GUI analyzer<br/>[Main.py]"]
  node_email["Email checks<br/>[Main.py]"]
  node_url["URL checks<br/>[Main.py]"]
  node_ip["IP checks<br/>[Main.py]"]
  node_domain["Domain checks<br/>[Main.py]"]
  node_hash["Hash checks<br/>[Main.py]"]
end

subgraph group_reports["Report output"]
  node_report["Report conversion<br/>[Main.py]"]
  node_results["Result files<br/>[Main.py]"]
end

subgraph group_integrations["OSINT integrations"]
  node_osint{{"OSINT websites"}}
end

node_user(("Analyst"))

node_user -->|"enters indicator"| node_widget
node_user -->|"runs scan"| node_cli
node_qt_entry -->|"creates window"| node_widget
node_widget -->|"validates input"| node_gui_validation
node_widget -->|"starts scan"| node_gui_runner
node_gui_runner -->|"passes arguments"| node_gui_analyzer
node_gui_runner -->|"reads standard output"| node_widget
node_gui_analyzer -->|"dispatches by type"| node_email
node_gui_analyzer -->|"dispatches by type"| node_url
node_gui_analyzer -->|"dispatches by type"| node_ip
node_gui_analyzer -->|"dispatches by type"| node_domain
node_gui_analyzer -->|"dispatches by type"| node_hash
node_email -->|"queries services"| node_osint
node_url -->|"queries services"| node_osint
node_ip -->|"queries services"| node_osint
node_domain -->|"queries services"| node_osint
node_hash -->|"queries services"| node_osint
node_email -->|"writes findings"| node_results
node_url -->|"writes findings"| node_results
node_ip -->|"writes findings"| node_results
node_domain -->|"writes findings"| node_results
node_hash -->|"writes findings"| node_results
node_gui_analyzer -->|"converts reports"| node_report
node_report -->|"writes JSON/PDF"| node_results
node_cli -->|"queries services"| node_osint
node_cli -->|"writes reports"| node_results

click node_qt_entry "https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/main.cpp"
click node_widget "https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/widget.cpp"
click node_gui_validation "https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/widget.cpp"
click node_gui_runner "https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/widget.cpp"
click node_cli "https://github.com/dharineeshj/pytster/blob/main/Command%20Line/pytster-cmd.py"
click node_gui_analyzer "https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py"
click node_email "https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py"
click node_url "https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py"
click node_ip "https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py"
click node_domain "https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py"
click node_hash "https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py"
click node_report "https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py"
click node_results "https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.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_qt_entry,node_widget,node_gui_validation,node_gui_runner toneBlue
class node_cli,node_gui_analyzer,node_email,node_url,node_ip,node_domain,node_hash toneAmber
class node_report,node_results toneMint
class node_osint toneRose
class node_user toneIndigo
```

## Components

### Qt GUI

- [Qt entry point](https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/main.cpp): `GUI/IOC_Project/main.cpp`
- [Input interface](https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/widget.cpp): `GUI/IOC_Project/widget.cpp`
- [Input validation](https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/widget.cpp): `GUI/IOC_Project/widget.cpp`
- [Python process runner](https://github.com/dharineeshj/pytster/blob/main/GUI/IOC_Project/widget.cpp): `GUI/IOC_Project/widget.cpp`

### Indicator analysis

- [CLI scanner](https://github.com/dharineeshj/pytster/blob/main/Command%20Line/pytster-cmd.py): `Command Line/pytster-cmd.py`
- [GUI analyzer](https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py): `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`
- [Email checks](https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py): `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`
- [URL checks](https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py): `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`
- [IP checks](https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py): `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`
- [Domain checks](https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py): `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`
- [Hash checks](https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py): `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`

### Report output

- [Report conversion](https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py): `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`
- [Result files](https://github.com/dharineeshj/pytster/blob/main/GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python%20File/Main.py): `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`

### OSINT integrations

- **OSINT websites**

### Other components

- **Analyst**

## Connections

- Analyst → Input interface: enters indicator (evidence: `README.md`)
- Analyst → CLI scanner: runs scan (evidence: `README.md`)
- Qt entry point → Input interface: creates window (evidence: `GUI/IOC_Project/main.cpp`)
- Input interface → Input validation: validates input (evidence: `GUI/IOC_Project/widget.cpp`)
- Input interface → Python process runner: starts scan (evidence: `GUI/IOC_Project/widget.cpp`)
- Python process runner → GUI analyzer: passes arguments (evidence: `GUI/IOC_Project/widget.cpp`)
- Python process runner → Input interface: reads standard output (evidence: `GUI/IOC_Project/widget.cpp`)
- GUI analyzer → Email checks: dispatches by type (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- GUI analyzer → URL checks: dispatches by type (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- GUI analyzer → IP checks: dispatches by type (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- GUI analyzer → Domain checks: dispatches by type (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- GUI analyzer → Hash checks: dispatches by type (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- Email checks → OSINT websites: queries services (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- URL checks → OSINT websites: queries services (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- IP checks → OSINT websites: queries services (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- Domain checks → OSINT websites: queries services (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- Hash checks → OSINT websites: queries services (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- Email checks → Result files: writes findings (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- URL checks → Result files: writes findings (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- IP checks → Result files: writes findings (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- Domain checks → Result files: writes findings (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- Hash checks → Result files: writes findings (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- GUI analyzer → Report conversion: converts reports (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- Report conversion → Result files: writes JSON/PDF (evidence: `GUI/build-IOC_Project-Desktop_Qt_6_5_1_MinGW_64_bit-Debug/Python File/Main.py`)
- CLI scanner → OSINT websites: queries services (evidence: `Command Line/pytster-cmd.py`)
- CLI scanner → Result files: writes reports (evidence: `Command Line/pytster-cmd.py`)
