keelog-bof

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 50 Open GitHub ↗

Async BOF to capture KeePass master passwords by detecting and keylogging locked database windows.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# KeeLog

Async BOF that captures the KeePass master password by monitoring for the unlock prompt window. When a locked KeePass database is detected, a low-level keyboard hook is installed and keystrokes are captured until the prompt window disappears by being submitted, cancelled or closeed. The captured buffer is then returned to the operator and automatically reconstructed into the master password.

>[!Important]
> This BOF requires asynchronous object file loading capabilities to work without blocking the agent. Such functionality is provided by the [Conquest](https://github.com/jakobfriedl/conquest/) framework.

## How it works

This BOF monitors the foreground window title to determine when the KeePass master password prompt is active. The title of the locked database window follows the format `Open Database - <database-name>.kdbx`, which distinguishes it from the unlocked state where the title is just `<database-name>.kdbx`. Keystrokes are logged when the locked database window is focused until it disappears.

![Workflow](https://raw.githubusercontent.com/jakobfriedl/keelog-bof/main/assets/image-1.png)

## Usage

The KeeLog BOF does not require any arguments. This repository contains a [Conquest Module](./dist/keelog.py) which features an output handler that directly converts the raw keystrokes into the captured master password.

![Keelog](https://raw.githubusercontent.com/jakobfriedl/keelog-bof/main/assets/image.png)

## Installation

```
git clone https://github.com/jakobfriedl/keelog-bof
cd keelog-bof
make
```

From there, use Conquest's Script Manager to load the `dist/keelog.py` module and start capturing master passwords using the `keelog` command.

keelog-bof

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README