# debang5hu/keylogger architecture

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

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

## Overview

This repository contains separate Linux and Windows Python agents that record keyboard input and clipboard contents, save them locally, and periodically send the log to Telegram. Each platform’s entry point starts capture and upload concurrently. The Linux agent additionally daemonizes and installs a cron startup entry; the Windows agent hides a newly created log file. Relationships below are based on the sampled source and README; external keyboard, clipboard, and Telegram services are represented at a high level.

Main entry points: [`Linux/keylogger.py`](https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py) (Input capture), [`Windows/keylogger.py`](https://github.com/debang5hu/keylogger/blob/main/Windows/keylogger.py) (Input capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_linux["Linux agent"]
  node_linux_entry["Linux entry point<br/>[keylogger.py]"]
  node_linux_capture["Input capture<br/>[keylogger.py]"]
  node_linux_log["Local log<br/>[keylogger.py]"]
  node_linux_upload["Periodic uploader<br/>[keylogger.py]"]
  node_linux_persist["Startup persistence<br/>[keylogger.py]"]
end

subgraph group_windows["Windows agent"]
  node_windows_entry["Windows entry point<br/>[keylogger.py]"]
  node_windows_capture["Input capture<br/>[keylogger.py]"]
  node_windows_log["Local log<br/>[keylogger.py]"]
  node_windows_upload["Periodic uploader<br/>[keylogger.py]"]
end

subgraph group_external["External services"]
end

node_keyboard(("Keyboard and clipboard"))
node_telegram{{"Telegram API"}}

node_linux_entry -->|"installs startup"| node_linux_persist
node_linux_entry -->|"starts thread"| node_linux_capture
node_linux_entry -->|"starts thread"| node_linux_upload
node_keyboard -->|"delivers input"| node_linux_capture
node_linux_capture -->|"writes events"| node_linux_log
node_linux_upload -->|"reads file"| node_linux_log
node_linux_upload -->|"uploads log"| node_telegram
node_linux_capture -->|"sends alerts"| node_telegram
node_windows_entry -->|"starts thread"| node_windows_capture
node_windows_entry -->|"starts thread"| node_windows_upload
node_keyboard -->|"delivers input"| node_windows_capture
node_windows_capture -->|"writes events"| node_windows_log
node_windows_upload -->|"reads file"| node_windows_log
node_windows_upload -->|"uploads log"| node_telegram
node_windows_capture -->|"sends alerts"| node_telegram

click node_linux_entry "https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py"
click node_linux_capture "https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py"
click node_linux_log "https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py"
click node_linux_upload "https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py"
click node_linux_persist "https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py"
click node_windows_entry "https://github.com/debang5hu/keylogger/blob/main/Windows/keylogger.py"
click node_windows_capture "https://github.com/debang5hu/keylogger/blob/main/Windows/keylogger.py"
click node_windows_log "https://github.com/debang5hu/keylogger/blob/main/Windows/keylogger.py"
click node_windows_upload "https://github.com/debang5hu/keylogger/blob/main/Windows/keylogger.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_linux_entry,node_linux_capture,node_linux_log,node_linux_upload,node_linux_persist toneBlue
class node_windows_entry,node_windows_capture,node_windows_log,node_windows_upload toneAmber
class node_keyboard toneIndigo
class node_telegram toneMint
```

## Components

### Linux agent

- [Linux entry point](https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py): `Linux/keylogger.py`
- [Input capture](https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py): `Linux/keylogger.py`
- [Local log](https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py): `Linux/keylogger.py`
- [Periodic uploader](https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py): `Linux/keylogger.py`
- [Startup persistence](https://github.com/debang5hu/keylogger/blob/main/Linux/keylogger.py): `Linux/keylogger.py`

### Windows agent

- [Windows entry point](https://github.com/debang5hu/keylogger/blob/main/Windows/keylogger.py): `Windows/keylogger.py`
- [Input capture](https://github.com/debang5hu/keylogger/blob/main/Windows/keylogger.py): `Windows/keylogger.py`
- [Local log](https://github.com/debang5hu/keylogger/blob/main/Windows/keylogger.py): `Windows/keylogger.py`
- [Periodic uploader](https://github.com/debang5hu/keylogger/blob/main/Windows/keylogger.py): `Windows/keylogger.py`

### Other components

- **Keyboard and clipboard**
- **Telegram API**

## Connections

- Linux entry point → Startup persistence: installs startup (evidence: `Linux/keylogger.py`)
- Linux entry point → Input capture: starts thread (evidence: `Linux/keylogger.py`)
- Linux entry point → Periodic uploader: starts thread (evidence: `Linux/keylogger.py`)
- Keyboard and clipboard → Input capture: delivers input (evidence: `Linux/keylogger.py`)
- Input capture → Local log: writes events (evidence: `Linux/keylogger.py`)
- Periodic uploader → Local log: reads file (evidence: `Linux/keylogger.py`)
- Periodic uploader → Telegram API: uploads log (evidence: `Linux/keylogger.py`)
- Input capture → Telegram API: sends alerts (evidence: `Linux/keylogger.py`)
- Windows entry point → Input capture: starts thread (evidence: `Windows/keylogger.py`)
- Windows entry point → Periodic uploader: starts thread (evidence: `Windows/keylogger.py`)
- Keyboard and clipboard → Input capture: delivers input (evidence: `Windows/keylogger.py`)
- Input capture → Local log: writes events (evidence: `Windows/keylogger.py`)
- Periodic uploader → Local log: reads file (evidence: `Windows/keylogger.py`)
- Periodic uploader → Telegram API: uploads log (evidence: `Windows/keylogger.py`)
- Input capture → Telegram API: sends alerts (evidence: `Windows/keylogger.py`)
