SoftLock Privacy mode - Rookiestyle/LockAssist GitHub Wiki

SoftLock hides sensitive information while still allowing Auto-Type as well as other integration.
You can configure SoftLock to kick in after a certain inactivity or when minimizing KeePass.

When active, the following is hidden:

  • group list
  • entry list
  • entry view
  • all forms containing sensitive data (entry form, ...)

General
SoftLock for forms
SoftLock for main menu & toolbar

General

SoftLock uses the Quick Unlock settings.
This means, you need to have a Quick Unlock key defined for your database. it is not required that Quick Unlock is actually active.

When SoftLock starts, the entire KeePass main window content except the main menu and toolbar is hidden.
You won't see and groups, entries or entry details.
In addition, the content of almost every currently active form is hidden as well.

To deactivate SoftLock, just click anywhere and a popup asking for the Quick Unlock key will pop up.
Enter this key and everything will be visible again, including all previously opened windows.
Unlike Quick Unlock, you have unlimited attempts - no need to be afraid of a typo.

SoftLock for forms

By default, SoftLock will hide the content of open forms.
E. g. when you 're editing an entry and leave your desk (you should avoid doing that...) KeePass can't lock the workspace after the defined inactivity because it's not clear how to handle the unsaved changes. You'll find more details here: https://keepass.info/%0D/help/base/faq_tech.html#noautolock

LockAssist will not close these forms either for the very same reasons.
Instead, LockAssist will keep the forms open but hide its content so that noone can see anything.
As a general rule, every form's content will be hidden.
Since there is no rule without exceptions, a few forms are whitelisted because they don't expose critical content.
Following forms are whitelisted and will not be softlocked by default:

  • AboutForm: About KeePass
  • AutoTypeCtxForm: Auto-Type entry selection
  • CharPickerForm: Form shown when you use {PICKCHARS}
  • ColumnsForm - Adjust which columns are shown (once SoftLock is deactivated)
  • HelpSourceForm -KeePass menu: Tools - Options - Integration - Help Source...
  • KeyPromptForm - Enter masterkey to open a database
  • LanguageForm - Select language
  • PluginsForm - Show installed plugins
  • PwGeneratorForm - Generate new passwords
  • UpdateCheckForm - Check for updates of KeePass and plugins

You can define which forms are whitelisted by changing KeePass' configuration file.
Search for an entry named LockAssist.SoftlockExcludeForms and replace the prefilled value with the full-specified name of the form. E. g. to exclude two forms named MySpecialForm and MyOtherSpecialForm, the entry needs to be configured as follows:

<Item>
  <Key>LockAssist.SoftlockExcludeForms</Key>
  <Value>MySpecialForm,MyOtherSpecialForm</Value>
</Item>

To remove one of the whitelisted forms, add the form name in the format -<form name>.
E. g. to remove the About KeePass from the whitelist, the entry needs to be configured as follows:

<Item>
  <Key>LockAssist.SoftlockExcludeForms</Key>
  <Value>-AboutForm,MySpecialForm,MyOtherSpecialForm</Value>
</Item>

SoftLock for main menu & toolbar

SoftLock also deactivates critical items in the main menu as well as in the toolbar, e. g.

  • Saving a database (Save, Save As)
  • Creating / Opening a databse - makes no sense when you won't see anything
  • Change the masterkey
  • Import / Export
  • Print
  • Group menu
  • Entry menu
  • Find menu
  • Database tools
  • Options (you could deactivate SoftLock here) - This applies to KeePass' tray icon as well
  • ...
⚠️ **GitHub.com Fallback** ⚠️