# vickymac1011/keylogger architecture

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

- Interactive diagram: https://gitdiagram.com/vickymac1011/keylogger
- Repository: https://github.com/vickymac1011/keylogger

## Overview

The README describes a packaged Python keylogger workflow: a user configures an email address and interval in a GUI, submits, and the program captures data, stores it locally, and emails it. It also lists remote-server delivery as an optional capability. No source excerpts or unpacked files are available, so implementation paths and internal call relationships cannot be verified; documented relationships cite the README.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup"]
  node_gui["Configuration GUI"]
  node_runtime["KeyLogger executable"]
end

subgraph group_capture["Capture"]
  node_keyboard["Keystroke capture"]
  node_clipboard["Clipboard capture"]
  node_system["System info capture"]
  node_screenshots["Screenshot capture"]
  node_microphone["Microphone capture"]
end

subgraph group_delivery["Data handling"]
  node_local[("Local log storage")]
end

node_user(("User"))
node_smtp["SMTP email service"]
node_remote["Remote server"]

node_user -->|"enters settings"| node_gui
node_gui -->|"submits settings"| node_runtime
node_runtime -->|"records keys"| node_keyboard
node_runtime -->|"captures clipboard"| node_clipboard
node_runtime -->|"captures system info"| node_system
node_runtime -->|"captures screenshots"| node_screenshots
node_runtime -->|"captures audio"| node_microphone
node_runtime -->|"stores captured data"| node_local
node_runtime -->|"emails logs"| node_smtp
node_runtime -.->|"sends logs"| node_remote

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_gui,node_runtime,node_user toneBlue
class node_keyboard,node_clipboard,node_system,node_screenshots,node_microphone toneAmber
class node_local,node_remote toneMint
class node_smtp toneIndigo
```

## Components

### Setup

- **Configuration GUI**
- **KeyLogger executable**

### Capture

- **Keystroke capture**
- **Clipboard capture**
- **System info capture**
- **Screenshot capture**
- **Microphone capture**

### Data handling

- **Local log storage**

### Other components

- **User**
- **SMTP email service**
- **Remote server**

## Connections

- User → Configuration GUI: enters settings (evidence: `README.md`)
- Configuration GUI → KeyLogger executable: submits settings (evidence: `README.md`)
- KeyLogger executable → Keystroke capture: records keys (evidence: `README.md`)
- KeyLogger executable → Clipboard capture: captures clipboard (evidence: `README.md`)
- KeyLogger executable → System info capture: captures system info (evidence: `README.md`)
- KeyLogger executable → Screenshot capture: captures screenshots (evidence: `README.md`)
- KeyLogger executable → Microphone capture: captures audio (evidence: `README.md`)
- KeyLogger executable → Local log storage: stores captured data (evidence: `README.md`)
- KeyLogger executable → SMTP email service: emails logs (evidence: `README.md`)
- KeyLogger executable → Remote server: sends logs (evidence: `README.md`)
