# kolod/keepass architecture

> Architecture diagram of the GitHub repository kolod/keepass, 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/kolod/keepass
- Repository: https://github.com/kolod/keepass

## Overview

KeePass is a desktop password manager: users open or create a password database, unlock it with a composite key, manage entries, and save the encrypted database. The tree also shows import/export, search, auto-type, trigger automation, and plugins as product capabilities. The excerpts establish key model, database, placeholder, and UI-manager responsibilities; several UI routing details and unsampled subsystems are represented as unverified rather than asserted as source-confirmed calls.

Main entry points: [`KeePass/Forms/MainForm.cs`](https://github.com/kolod/keepass/blob/master/KeePass/Forms/MainForm.cs) (Main window), [`KeePass/Program.cs`](https://github.com/kolod/keepass/blob/master/KeePass/Program.cs) (Application startup), [`KeePassLib/PwDatabase.cs`](https://github.com/kolod/keepass/blob/master/KeePassLib/PwDatabase.cs) (Vault database), [`KeePassLib/PwEntry.cs`](https://github.com/kolod/keepass/blob/master/KeePassLib/PwEntry.cs) (Entry model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_startup["Application startup<br/>[Program.cs]"]
  node_mainui["Main window<br/>[MainForm.cs]"]
  node_windowmgr["Window manager"]
  node_entryui["Entry editing<br/>[PwEntryForm.cs]"]
end

subgraph group_vault["Vault and security"]
  node_database[("Vault database<br/>[PwDatabase.cs]")]
  node_groups["Groups and entries<br/>[PwGroup.cs]"]
  node_entry["Entry model<br/>[PwEntry.cs]"]
  node_protected["Protected values<br/>[ProtectedString.cs]"]
  node_keys["Composite keys<br/>[CompositeKey.cs]"]
  node_kdbx["KDBX serialization<br/>[KdbxFile.cs]"]
end

subgraph group_flows["Entry workflows"]
  node_search["Entry search<br/>[PwGroup.Search.cs]"]
  node_exchangeui["Import/export UI"]
  node_formats["Format handlers<br/>[FileFormatPool.cs]"]
  node_autotype["Auto-type<br/>[AutoType.cs]"]
  node_placeholders["Placeholder engine<br/>[SprEngine.cs]"]
end

subgraph group_extensibility["Automation and extensions"]
  node_triggers["Trigger automation"]
  node_plugins["Plugin manager<br/>[PluginManager.cs]"]
end

node_user(("User"))
node_external["Desktop environment"]

node_user -.->|"launches"| node_startup
node_startup -.->|"starts UI"| node_mainui
node_mainui -.->|"manages vault"| node_database
node_user -.->|"interacts"| node_mainui
node_mainui -.->|"registers windows"| node_windowmgr
node_mainui -.->|"opens editor"| node_entryui
node_entryui -.->|"edits"| node_entry
node_database -->|"holds groups"| node_groups
node_groups -->|"holds entries"| node_entry
node_entry -->|"stores protected fields"| node_protected
node_database -->|"uses composite key"| node_keys
node_database -->|"reads and writes"| node_kdbx
node_mainui -.->|"searches entries"| node_search
node_exchangeui -.->|"selects formats"| node_formats
node_mainui -.->|"opens exchange"| node_exchangeui
node_mainui -.->|"invokes auto-type"| node_autotype
node_autotype -.->|"types into windows"| node_external
node_autotype -->|"expands sequences"| node_placeholders
node_placeholders -->|"reads entry fields"| node_entry
node_startup -->|"initializes triggers"| node_triggers
node_startup -.->|"initializes plugins"| node_plugins
node_plugins -.->|"loads extensions"| node_external

click node_startup "https://github.com/kolod/keepass/blob/master/KeePass/Program.cs"
click node_mainui "https://github.com/kolod/keepass/blob/master/KeePass/Forms/MainForm.cs"
click node_windowmgr "https://github.com/kolod/keepass/blob/master/KeePass/UI/GlobalWindowManager.cs"
click node_entryui "https://github.com/kolod/keepass/blob/master/KeePass/Forms/PwEntryForm.cs"
click node_database "https://github.com/kolod/keepass/blob/master/KeePassLib/PwDatabase.cs"
click node_groups "https://github.com/kolod/keepass/blob/master/KeePassLib/PwGroup.cs"
click node_entry "https://github.com/kolod/keepass/blob/master/KeePassLib/PwEntry.cs"
click node_protected "https://github.com/kolod/keepass/blob/master/KeePassLib/Security/ProtectedString.cs"
click node_keys "https://github.com/kolod/keepass/blob/master/KeePassLib/Keys/CompositeKey.cs"
click node_kdbx "https://github.com/kolod/keepass/blob/master/KeePassLib/Serialization/KdbxFile.cs"
click node_search "https://github.com/kolod/keepass/blob/master/KeePassLib/PwGroup.Search.cs"
click node_exchangeui "https://github.com/kolod/keepass/blob/master/KeePass/Forms/ExchangeDataForm.cs"
click node_formats "https://github.com/kolod/keepass/blob/master/KeePass/DataExchange/FileFormatPool.cs"
click node_autotype "https://github.com/kolod/keepass/blob/master/KeePass/Util/AutoType.cs"
click node_placeholders "https://github.com/kolod/keepass/blob/master/KeePass/Util/Spr/SprEngine.cs"
click node_triggers "https://github.com/kolod/keepass/blob/master/KeePass/Ecas/EcasTriggerSystem.cs"
click node_plugins "https://github.com/kolod/keepass/blob/master/KeePass/Plugins/PluginManager.cs"

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_startup,node_mainui,node_windowmgr,node_entryui,node_user toneBlue
class node_database,node_groups,node_entry,node_protected,node_keys,node_kdbx toneAmber
class node_search,node_exchangeui,node_formats,node_autotype,node_placeholders toneMint
class node_triggers,node_plugins toneRose
class node_external toneIndigo
```

## Components

### Application UI

- [Application startup](https://github.com/kolod/keepass/blob/master/KeePass/Program.cs): `KeePass/Program.cs`
- [Main window](https://github.com/kolod/keepass/blob/master/KeePass/Forms/MainForm.cs): `KeePass/Forms/MainForm.cs`
- [Window manager](https://github.com/kolod/keepass/blob/master/KeePass/UI/GlobalWindowManager.cs): `KeePass/UI/GlobalWindowManager.cs`
- [Entry editing](https://github.com/kolod/keepass/blob/master/KeePass/Forms/PwEntryForm.cs): `KeePass/Forms/PwEntryForm.cs`

### Vault and security

- [Vault database](https://github.com/kolod/keepass/blob/master/KeePassLib/PwDatabase.cs): `KeePassLib/PwDatabase.cs`
- [Groups and entries](https://github.com/kolod/keepass/blob/master/KeePassLib/PwGroup.cs): `KeePassLib/PwGroup.cs`
- [Entry model](https://github.com/kolod/keepass/blob/master/KeePassLib/PwEntry.cs): `KeePassLib/PwEntry.cs`
- [Protected values](https://github.com/kolod/keepass/blob/master/KeePassLib/Security/ProtectedString.cs): `KeePassLib/Security/ProtectedString.cs`
- [Composite keys](https://github.com/kolod/keepass/blob/master/KeePassLib/Keys/CompositeKey.cs): `KeePassLib/Keys/CompositeKey.cs`
- [KDBX serialization](https://github.com/kolod/keepass/blob/master/KeePassLib/Serialization/KdbxFile.cs): `KeePassLib/Serialization/KdbxFile.cs`

### Entry workflows

- [Entry search](https://github.com/kolod/keepass/blob/master/KeePassLib/PwGroup.Search.cs): `KeePassLib/PwGroup.Search.cs`
- [Import/export UI](https://github.com/kolod/keepass/blob/master/KeePass/Forms/ExchangeDataForm.cs): `KeePass/Forms/ExchangeDataForm.cs`
- [Format handlers](https://github.com/kolod/keepass/blob/master/KeePass/DataExchange/FileFormatPool.cs): `KeePass/DataExchange/FileFormatPool.cs`
- [Auto-type](https://github.com/kolod/keepass/blob/master/KeePass/Util/AutoType.cs): `KeePass/Util/AutoType.cs`
- [Placeholder engine](https://github.com/kolod/keepass/blob/master/KeePass/Util/Spr/SprEngine.cs): `KeePass/Util/Spr/SprEngine.cs`

### Automation and extensions

- [Trigger automation](https://github.com/kolod/keepass/blob/master/KeePass/Ecas/EcasTriggerSystem.cs): `KeePass/Ecas/EcasTriggerSystem.cs`
- [Plugin manager](https://github.com/kolod/keepass/blob/master/KeePass/Plugins/PluginManager.cs): `KeePass/Plugins/PluginManager.cs`

### Other components

- **User**
- **Desktop environment**

## Connections

- User → Application startup: launches
- Application startup → Main window: starts UI
- Main window → Vault database: manages vault
- User → Main window: interacts
- Main window → Window manager: registers windows
- Main window → Entry editing: opens editor
- Entry editing → Entry model: edits
- Vault database → Groups and entries: holds groups (evidence: `KeePassLib/PwDatabase.cs`)
- Groups and entries → Entry model: holds entries (evidence: `KeePassLib/PwGroup.cs`)
- Entry model → Protected values: stores protected fields (evidence: `KeePassLib/PwEntry.cs`)
- Vault database → Composite keys: uses composite key (evidence: `KeePassLib/PwDatabase.cs`)
- Vault database → KDBX serialization: reads and writes (evidence: `KeePassLib/PwDatabase.cs`)
- Main window → Entry search: searches entries
- Import/export UI → Format handlers: selects formats
- Main window → Import/export UI: opens exchange
- Main window → Auto-type: invokes auto-type
- Auto-type → Desktop environment: types into windows
- Auto-type → Placeholder engine: expands sequences (evidence: `KeePass/Util/Spr/SprEngine.cs`)
- Placeholder engine → Entry model: reads entry fields (evidence: `KeePass/Util/Spr/SprEngine.cs`)
- Application startup → Trigger automation: initializes triggers (evidence: `KeePass/Program.cs`)
- Application startup → Plugin manager: initializes plugins
- Plugin manager → Desktop environment: loads extensions
