Skip to content

Latest commit

 

History

History
58 lines (43 loc) · 6.51 KB

Readme.md

File metadata and controls

58 lines (43 loc) · 6.51 KB
Raw

KeePassTrayIconLockState

Build status Test status Coverage status

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

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.