# thevoid-001/windows-keylogger architecture

> Architecture diagram of the GitHub repository thevoid-001/windows-keylogger, 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/thevoid-001/windows-keylogger
- Repository: https://github.com/thevoid-001/windows-keylogger

## Overview

This small C program installs a Windows low-level keyboard hook, runs a message loop so hook events are delivered, interprets key events, and prints readable output to the console. The callback also queries keyboard state for character translation and passes events onward. The implementation is in one file, so several responsibilities share its path; the graph does not imply separate modules.

Main entry points: [`keylogger.c`](https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c) (Hook callback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Keyboard capture"]
  node_app["Application entry<br/>[keylogger.c]"]
  node_hook["Hook registration<br/>[keylogger.c]"]
  node_loop["Message loop<br/>[keylogger.c]"]
  node_callback["Hook callback<br/>[keylogger.c]"]
  node_decode["Key interpretation<br/>[keylogger.c]"]
end

node_user(("Keyboard user"))
node_winapi["Windows APIs"]
node_console["Console output"]

node_app -->|"installs"| node_hook
node_hook -->|"registers callback"| node_callback
node_app -->|"runs"| node_loop
node_winapi -->|"delivers events"| node_callback
node_user -->|"provides input"| node_winapi
node_callback -->|"interprets keys"| node_decode
node_decode -->|"queries key state"| node_winapi
node_decode -->|"prints characters"| node_console
node_callback -->|"forwards event"| node_winapi
node_app -->|"removes hook"| node_winapi

click node_app "https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c"
click node_hook "https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c"
click node_loop "https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c"
click node_callback "https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c"
click node_decode "https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c"

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_hook,node_loop,node_callback,node_decode,node_user toneBlue
class node_winapi toneMint
class node_console toneIndigo
```

## Components

### Keyboard capture

- [Application entry](https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c): `keylogger.c`
- [Hook registration](https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c): `keylogger.c`
- [Message loop](https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c): `keylogger.c`
- [Hook callback](https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c): `keylogger.c`
- [Key interpretation](https://github.com/thevoid-001/windows-keylogger/blob/main/keylogger.c): `keylogger.c`

### Other components

- **Keyboard user**
- **Windows APIs**
- **Console output**

## Connections

- Application entry → Hook registration: installs (evidence: `keylogger.c`)
- Hook registration → Hook callback: registers callback (evidence: `keylogger.c`)
- Application entry → Message loop: runs (evidence: `keylogger.c`)
- Windows APIs → Hook callback: delivers events (evidence: `README.md`)
- Keyboard user → Windows APIs: provides input (evidence: `README.md`)
- Hook callback → Key interpretation: interprets keys (evidence: `keylogger.c`)
- Key interpretation → Windows APIs: queries key state (evidence: `keylogger.c`)
- Key interpretation → Console output: prints characters (evidence: `keylogger.c`)
- Hook callback → Windows APIs: forwards event (evidence: `keylogger.c`)
- Application entry → Windows APIs: removes hook (evidence: `keylogger.c`)
