https://github.com/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.
https://github.com/aldaviva/keepasstrayiconlockstate
keepass-plugin notification-area tray-icon
Last synced: 8 months ago
JSON representation
🔒 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.
- Host: GitHub
- URL: https://github.com/aldaviva/keepasstrayiconlockstate
- Owner: Aldaviva
- License: apache-2.0
- Created: 2020-06-09T01:52:47.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-05-28T12:58:19.000Z (almost 2 years ago)
- Last Synced: 2025-03-15T03:36:05.887Z (about 1 year ago)
- Topics: keepass-plugin, notification-area, tray-icon
- Language: C#
- Homepage:
- Size: 1.38 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: License.txt
Awesome Lists containing this project
README
KeePassTrayIconLockState
===
[](https://github.com/Aldaviva/KeePassTrayIconLockState/actions/workflows/dotnetframework.yml) [](https://aldaviva.testspace.com/spaces/234282) [](https://coveralls.io/github/Aldaviva/KeePassTrayIconLockState?branch=master)
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](https://keepass.info/download.html) for Windows
- [.NET Framework 4.8 runtime](https://dotnet.microsoft.com/download/dotnet-framework/net48) (included in Windows 10 version 1903 and later)
## Installation
1. Download [**`KeePassTrayIconLockState.dll`**](https://github.com/Aldaviva/KeePassTrayIconLockState/releases/latest/download/KeePassTrayIconLockState.dll) from the [latest release](https://github.com/Aldaviva/KeePassTrayIconLockState/releases/latest).
1. Save `KeePassTrayIconLockState.dll` to the `Plugins` directory inside your KeePass installation directory, or a subfolder, such as
```text
C:\Program Files\KeePass Password Safe 2\Plugins\KeePassTrayIconLockState.dll
```
1. 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](#behavior) 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](https://sourceforge.net/projects/iconaton/files/iconaton/Iconaton%200.1%20Beta%201/). 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.