{"id":15779538,"url":"https://github.com/aldaviva/keepasstrayiconlockstate","last_synced_at":"2025-09-14T18:40:17.752Z","repository":{"id":54680033,"uuid":"270878154","full_name":"Aldaviva/KeePassTrayIconLockState","owner":"Aldaviva","description":"🔒 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.","archived":false,"fork":false,"pushed_at":"2024-05-28T12:58:19.000Z","size":1452,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-15T03:36:05.887Z","etag":null,"topics":["keepass-plugin","notification-area","tray-icon"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aldaviva.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"License.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://paypal.me/aldaviva"]}},"created_at":"2020-06-09T01:52:47.000Z","updated_at":"2024-11-25T07:56:00.000Z","dependencies_parsed_at":"2023-01-20T11:51:11.766Z","dependency_job_id":"99537c33-ac15-4044-a5b9-2a769e3b41f9","html_url":"https://github.com/Aldaviva/KeePassTrayIconLockState","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aldaviva%2FKeePassTrayIconLockState","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aldaviva%2FKeePassTrayIconLockState/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aldaviva%2FKeePassTrayIconLockState/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aldaviva%2FKeePassTrayIconLockState/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aldaviva","download_url":"https://codeload.github.com/Aldaviva/KeePassTrayIconLockState/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245168807,"owners_count":20571800,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["keepass-plugin","notification-area","tray-icon"],"created_at":"2024-10-04T18:20:24.828Z","updated_at":"2025-03-23T20:46:42.494Z","avatar_url":"https://github.com/Aldaviva.png","language":"C#","funding_links":["https://paypal.me/aldaviva"],"categories":[],"sub_categories":[],"readme":"KeePassTrayIconLockState\n===\n\n[![Build status](https://img.shields.io/github/actions/workflow/status/Aldaviva/KeePassTrayIconLockState/dotnetframework.yml?branch=master\u0026logo=github)](https://github.com/Aldaviva/KeePassTrayIconLockState/actions/workflows/dotnetframework.yml) [![Test status](https://img.shields.io/testspace/tests/Aldaviva/Aldaviva:KeePassTrayIconLockState/master?passed_label=passing\u0026failed_label=failing\u0026logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA4NTkgODYxIj48cGF0aCBkPSJtNTk4IDUxMy05NCA5NCAyOCAyNyA5NC05NC0yOC0yN3pNMzA2IDIyNmwtOTQgOTQgMjggMjggOTQtOTQtMjgtMjh6bS00NiAyODctMjcgMjcgOTQgOTQgMjctMjctOTQtOTR6bTI5My0yODctMjcgMjggOTQgOTQgMjctMjgtOTQtOTR6TTQzMiA4NjFjNDEuMzMgMCA3Ni44My0xNC42NyAxMDYuNS00NFM1ODMgNzUyIDU4MyA3MTBjMC00MS4zMy0xNC44My03Ni44My00NC41LTEwNi41UzQ3My4zMyA1NTkgNDMyIDU1OWMtNDIgMC03Ny42NyAxNC44My0xMDcgNDQuNXMtNDQgNjUuMTctNDQgMTA2LjVjMCA0MiAxNC42NyA3Ny42NyA0NCAxMDdzNjUgNDQgMTA3IDQ0em0wLTU1OWM0MS4zMyAwIDc2LjgzLTE0LjgzIDEwNi41LTQ0LjVTNTgzIDE5Mi4zMyA1ODMgMTUxYzAtNDItMTQuODMtNzcuNjctNDQuNS0xMDdTNDczLjMzIDAgNDMyIDBjLTQyIDAtNzcuNjcgMTQuNjctMTA3IDQ0cy00NCA2NS00NCAxMDdjMCA0MS4zMyAxNC42NyA3Ni44MyA0NCAxMDYuNVMzOTAgMzAyIDQzMiAzMDJ6bTI3NiAyODJjNDIgMCA3Ny42Ny0xNC44MyAxMDctNDQuNXM0NC02NS4xNyA0NC0xMDYuNWMwLTQyLTE0LjY3LTc3LjY3LTQ0LTEwN3MtNjUtNDQtMTA3LTQ0Yy00MS4zMyAwLTc2LjY3IDE0LjY3LTEwNiA0NHMtNDQgNjUtNDQgMTA3YzAgNDEuMzMgMTQuNjcgNzYuODMgNDQgMTA2LjVTNjY2LjY3IDU4NCA3MDggNTg0em0tNTU3IDBjNDIgMCA3Ny42Ny0xNC44MyAxMDctNDQuNXM0NC02NS4xNyA0NC0xMDYuNWMwLTQyLTE0LjY3LTc3LjY3LTQ0LTEwN3MtNjUtNDQtMTA3LTQ0Yy00MS4zMyAwLTc2LjgzIDE0LjY3LTEwNi41IDQ0UzAgMzkxIDAgNDMzYzAgNDEuMzMgMTQuODMgNzYuODMgNDQuNSAxMDYuNVMxMDkuNjcgNTg0IDE1MSA1ODR6IiBmaWxsPSIjZmZmIi8%2BPC9zdmc%2B)](https://aldaviva.testspace.com/spaces/234282) [![Coverage status](https://img.shields.io/coveralls/github/Aldaviva/KeePassTrayIconLockState?logo=coveralls)](https://coveralls.io/github/Aldaviva/KeePassTrayIconLockState?branch=master)\n\nReplace 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.\n\n- 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.\n- 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.\n- Supports normal and high-DPI screens (Settings → System → Display → Scale).\n- Supports dark and light mode taskbars (Settings → Personalization → Colors → Choose your mode).\n\n## Requirements\n- [KeePass 2](https://keepass.info/download.html) for Windows\n- [.NET Framework 4.8 runtime](https://dotnet.microsoft.com/download/dotnet-framework/net48) (included in Windows 10 version 1903 and later)\n\n## Installation\n1. Download [**`KeePassTrayIconLockState.dll`**](https://github.com/Aldaviva/KeePassTrayIconLockState/releases/latest/download/KeePassTrayIconLockState.dll) from the [latest release](https://github.com/Aldaviva/KeePassTrayIconLockState/releases/latest).\n1. Save `KeePassTrayIconLockState.dll` to the `Plugins` directory inside your KeePass installation directory, or a subfolder, such as\n    ```text\n    C:\\Program Files\\KeePass Password Safe 2\\Plugins\\KeePassTrayIconLockState.dll\n    ```\n1. Restart KeePass.\n\nThese same instructions also apply to upgrades of existing plugin installations.\n\n## Behavior\n\u003cdl\u003e\n\u003cdt\u003e\u003cimg src=\"https://raw.githubusercontent.com/Aldaviva/KeePassTrayIconLockState/master/KeePassTrayIconLockState/Resources/unlocked.ico\" height=\"16\" /\u003e Database is open\u003c/dt\u003e\n\u003cdd\u003eThe tray icon is a wireframe padlock icon.\u003c/dd\u003e\n\u003cdt\u003e\u003cimg src=\"https://raw.githubusercontent.com/Aldaviva/KeePassTrayIconLockState/master/KeePassTrayIconLockState/Resources/unlocking.ico\" height=\"16\" /\u003e Database is being loaded and decrypted\u003c/dt\u003e\n\u003cdd\u003eA small hourglass is added to the padlock tray icon until the database has finished opening.\u003c/dd\u003e\n\u003cdt\u003eDatabase is locked or closed\u003c/dt\u003e\n\u003cdd\u003eTray 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).\u003c/dd\u003e\n\u003c/dl\u003e\n\n## Configuration\nThere is no required configuration for this plugin. Optional settings are described below.\n\n### Custom icons\nTo 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.\n\nEach 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.\n\nYou 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.\n\nIcon files with the following filenames will be used by this plugin.\n\n|icon filename|database state|OS theme|default plugin icon to replace|\n|---|---|---|---|\n|`opening-lighttaskbar.ico`|opening|light|\u003cimg src=\"https://raw.githubusercontent.com/Aldaviva/KeePassTrayIconLockState/master/KeePassTrayIconLockState/Resources/unlocking-light.ico\" height=\"16\" /\u003e black padlock and hourglass|\n|`opening-darktaskbar.ico`|opening|dark|\u003cimg src=\"https://raw.githubusercontent.com/Aldaviva/KeePassTrayIconLockState/master/KeePassTrayIconLockState/Resources/unlocking.ico\" height=\"16\" /\u003e white padlock and hourglass|\n|`open-lighttaskbar.ico`|open|light|\u003cimg src=\"https://raw.githubusercontent.com/Aldaviva/KeePassTrayIconLockState/master/KeePassTrayIconLockState/Resources/unlocked-light.ico\" height=\"16\" /\u003e black padlock|\n|`open-darktaskbar.ico`|open|dark|\u003cimg src=\"https://raw.githubusercontent.com/Aldaviva/KeePassTrayIconLockState/master/KeePassTrayIconLockState/Resources/unlocked.ico\" height=\"16\" /\u003e white padlock|\n\nAny 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.\n\nChanges to these icon files take effect after restarting KeePass.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faldaviva%2Fkeepasstrayiconlockstate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faldaviva%2Fkeepasstrayiconlockstate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faldaviva%2Fkeepasstrayiconlockstate/lists"}