aldaviva / keepasstrayiconlockstate

🔒 Replace the default KeePass Windows 98–style tray icon with a wireframe padlock icon to match the style of built-in tray icons in Windows 10 and 11.

KeePassTrayIconLockState

Replace the default KeePass Windows 98–style tray icon with a wireframe padlock icon to match the style of built-in tray icons in Windows 10 and 11.

• While the database is being opened, an hourglass icon is shown on top of the padlock, so you can tell when it's done opening and ready to use.
• When the database is locked or closed, the icon will be hidden, because it's distracting and not useful in this state that is effectively identical to exiting KeePass.
• Supports normal and high-DPI screens (Settings → System → Display → Scale).
• Supports dark and light mode taskbars (Settings → Personalization → Colors → Choose your mode).

Requirements

• KeePass 2 for Windows
• .NET Framework 4.8 runtime (included in Windows 10 version 1903 and later)

Installation

1. Download KeePassTrayIconLockState.dll from the latest release.
2. Save KeePassTrayIconLockState.dll to the Plugins directory inside your KeePass installation directory, or a subfolder, such as

   C:\Program Files\KeePass Password Safe 2\Plugins\KeePassTrayIconLockState.dll
   

3. Restart KeePass.

These same instructions also apply to upgrades of existing plugin installations.

Behavior

Database is open

The tray icon is a wireframe padlock icon.

Database is being loaded and decrypted

A small hourglass is added to the padlock tray icon until the database has finished opening.

Database is locked or closed

Tray icon is removed. To interact with KeePass in this state, launch the program again or use a system-wide KeePass hotkey to open its window or perform auto-type (set in Tools → Options → Integrations).

Configuration

There is no required configuration for this plugin. Optional settings are described below.

Custom icons

To optionally override the Windows 10/11 style wireframe icons that this plugin renders, you can create your own custom icon files in same directory as this plugin's KeePassTrayIconLockState.dll file. This is useful if you don't like the wireframe icons from this plugin, but you also don't want to fork or reimplement this entire plugin and all its logic just to change a few image resources.

Each of the icon files can contain a 16×16px image for normal DPI (100%) screens as well as a 32×32px image for high DPI (≈200%) screens. If your scaling factor is not represented, such as 150%, you can supply other dimensions as well in the same file, such as 24×24px, otherwise, Windows will scale down the larger image so that it doesn't look blurry.

You can use any icon editing program you want to edit or convert images to ICO files, such as Iconaton. 32-bit color (8bpc with transparency) is supported.

Icon files with the following filenames will be used by this plugin.

icon filename	database state	OS theme	default plugin icon to replace
opening-lighttaskbar.ico	opening	light	black padlock and hourglass
opening-darktaskbar.ico	opening	dark	white padlock and hourglass
open-lighttaskbar.ico	open	light	black padlock
open-darktaskbar.ico	open	dark	white padlock

Any states for which you don't supply an icon file will be rendered with this plugin's built-in wireframe icons, so you don't have to provide all four files if you don't want to.

Changes to these icon files take effect after restarting KeePass.

keepasstrayiconlockstate's Issues

Custom Icons Feature

Hello, it would be nice to be able to customize icons.

Create high-resolution tray icons

I got a laptop with a 243 DPI screen and I'm running it at 200% scaling.

The tray icons would look great with a 2x version. Hopefully that can be rendered without too much hassle, like having to manually detect the density.

I hope I still have the source files for those icons.