Awesome Open Source
Awesome Open Source

Quick unlock with Windows Hello for KeePass 2

Build Status Quality Gate Status GitHub All Releases Chocolatey

This plugin for KeePass 2 password manager is intended for fast authorization with pin or biometrics to a database after its first unlock using Windows Hello technology.


With this plugin you may:

  1. Unlock your database with your masterkey/keyfile/other provider;

  2. Lock the database (for example, applying autolock on minimize);

  3. When you try to unlock it again, if Windows Hello is available on your system and active for the database, a Windows Hello prompt will be shown over a classic KeePass unlock prompt;

  4. Profit!

Systems Requirements

This plugin relies on Windows Hello API and its requirements.

There are some known issues with Windows Hello reported by community. Please, check here before write issue.

Tested on Microsoft Surface Pro 2017 with KeePass 2.39.1 and 2.42.1.

How to Install

Place KeePassWinHelloPlugin.plgx into Plugins folder in your KeePass installation (by default is C:\Program Files (x86)\KeePass Password Safe 2).

Or you can use Chocolatey to install it in a more automated manner:

choco install keepass-plugin-winhello

Key storage

By default this plugin holds an encrypted master password in memory and removes it upon KeePass closing. In order to be able to unlock your database via Windows Hello authentication in between KeePass launches you may check "Store keys in the Windows Credential Manager" on in the Options dialog. This will prompts you for creating a persistent key signed with your biometry via Windows Hello. The key is used to encrypt master passwords for securely storing them in the Windows Credential Manager.


The plugin integrates itself into the KeePass settings dialog.

Available settings:

  • Valid time period (default: 24 hours): Choose how long a saved key will be available. Once this period has expired you need to provide your full password to unlock the database again.
  • Storage location: Choose where to hold encrypted master passwords - in the KeePass process memory (by default) or in the Windows Credential Manager.
  • Revoke all: Allows you to delete all stored keys.


No sensitive information including master passwords for databases are stored by the plugin in a plain text. A database key is encrypted and decrypted using Windows Hello API in order to unlock the database.


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
c-sharp (12,332
security (1,882
plugin (785
password-manager (100
keepass (34