Frequently Asked Questions
Installation
In case there was a bug in older versions ...
Please download and run the latest version of the installer to update.
Strictly speaking KeeForm is not a plugin. KeeForm it is just an extension which is integrated via the KeePass URL override feature.
MENU -> tools->options-> TAB integration -> BUTTON Url Overrides
Please make sure the that the browser extension is installed and shows a "green light"
After enabling the browser extension, the badge color on the KeeForm icon should turn green. If it turns red, then the extension could not start. This can happen, for example, if you forgot to run the KeeForm installer in Windows. Or if the process keeform_host.exe is not able to start, but that should be very rare.
KeeForm will not fill forms which have more than two fields. Only the classic username and password combo is supported.
KeeForm uses just a simple, but effective heuristic method to automate logins, and it works 99% of the time ("not a scientific estimate"). For the remaining 1% you can still use auto-typing in KeePass.
Having said that, should you ever encounter a one-page login where KeeForm does not work, please send us the URL. We will try to improve KeeForm.
reg.exe ADD HKCU\Software\Mozilla\NativeMessagingHosts\org.keeform.host /d "C:\Users\USERNAME\AppData\Local\KeeForm\org.keeform.host.firefox.json" /f /t REG_SZ reg.exe ADD HKCU\Software\Google\Chrome\NativeMessagingHosts\org.keeform.host /d "C:\Users\USERNAME\AppData\Local\KeeForm\org.keeform.host.chrome.json" /f /t REG_SZKeeform also adds an override in the Keepass settings
MENU -> tools->options -> TAB integration -> BUTTON Url Overrides -> FIELD Override all entry URLS
Value
cmd://"%LOCALAPPDATA%\KeeForm\AutoIt3.exe" "%LOCALAPPDATA%\KeeForm\KeeForm.au3" {FIREFOX} "{URL}" "{USERNAME}" "{PASSWORD}"
(If you want to start Chrome, you will have to replace FIREFOX with GOOGLECHROME)
Only experienced users should attempt this. And backup your system first! Use this only to remove "early test versions" or in case the standard Windows uninstall method did not remove everything.
---Please run the un-installer first. This will take care of any registry entries and remove the KeeForm folder from your KeePass installation.
The un-installer will also try to remove the "URL override" configuration by restoring the previous value.
Should the uninstaller fail, please try the following steps.
Remove any KeeForm Folders in the %LOCALAPPDATA% folder and in your KeePass folder.
Remove the Url Override configuration.
MENU -> tools->options-> TAB integration -> BUTTON Url Overrides
If you see something like cmd://"...\KeeForm\" ... just remove it.
Remove all registry keys with the following commands.
reg.exe DELETE HKCU\Software\Mozilla\NativeMessagingHosts\org.keeform.host /f reg.exe DELETE HKCU\Software\Google\Chrome\NativeMessagingHosts\org.keeform.host /f reg.exe DELETE HKLM\Software\Mozilla\NativeMessagingHosts\org.keeform.host /f reg.exe DELETE HKLM\Software\Google\Chrome\NativeMessagingHosts\org.keeform.host /f
This should work in most cases by clicking on the KeeForm icon in your browser's toolbar.
When you see a username or password field, simply click the KeeForm icon to fill the fields.
Correct. KeeForm will not run on other platforms.
- Windows 10 is fully supported.
- Windows XP is not supported
- Windows 7 should work, but is not well-tested.
- Windows 8 probably works too, but has never been test.
The latest version does not use TCP anymore, and the password is not required anymore.
This optional. This field can be left empty. But it is recommended to use a password, of course.
If you want, you can enter a password during the installation to secure the communication between the KeeForm and Firefox (e.g. to prevent other apps "from accidentally" eavesdropping that communication). Don't forget to set the same password on the options page of the KeeForm Firefox extension as well. DO NOT RE-USE YOUR KEEPASS PASSWORD FOR THIS (or any other password).
Yes, it will still work, however the KeeForm installer won't be able to guess the location of your Keepass 2 configuration file. So you will have to add the override configuration manually.
Unfortunately KeePass does not throw any config error messages, so when a config error happens, KeeForm won't be able to alert you.
To add the KeeForm override, please run this command in a command prompt:
"%PROGRAMFILES(X86)%\KeePass Password Safe 2\KeePass.exe" -cfg-local:"\path\to\KeePass.config.xml" --add-urloverride --scheme:https --value:"cmd://\""%"LOCALAPPDATA"%"\KeeForm\AutoIt3.exe\" \""%"LOCALAPPDATA"%"\KeeForm\KeeForm.au3\" {GOOGLECHROME} \"{BASE}\" \"{USERNAME}\" \"{PASSWORD}\"" --activate
Instead of Chrome, you can also use {FIREFOX}
, {EDGE}
, or "path\to\browser.exe"
. Quotes are required if the path contains a space character.
To remove the KeeForm override, please run this command
"%PROGRAMFILES(X86)%\KeePass Password Safe 2\KeePass.exe" -cfg-local:"\path\to\KeePass.config.xml" --remove-urloverride --scheme:https --value:"cmd://\""%"LOCALAPPDATA"%"\KeeForm\AutoIt3.exe\" \""%"LOCALAPPDATA"%"\KeeForm\KeeForm.au3\" {GOOGLECHROME} \"{BASE}\" \"{USERNAME}\" \"{PASSWORD}\""
Please note, that the value has to be exactly the one you used in the add command, or else KeePass will fail to remove it.
Obviously, you could also remove the override with KeePass in
MENU -> tools->options-> TAB integration -> BUTTON Url Overrides
General
KeeForm was born in 2005. Since then KeeForm has never had any malware/adware/coinware/protestware.
However it is not uncommon that AV software report false positives. Even digitally signed KeePass has this issue from time to time.
You can check the current malware scan status using the link below:
KeeForm website
https://transparencyreport.google.com/safe-browsing/search?url=keeform.orgInstaller version 4.5.0
https://www.virustotal.com/gui/file/25b50dc7d013d8af3dc95a52f976b3978105e503213679a45797a40f70b5fc76Installer version 4.4.0
https://www.virustotal.com/gui/file/4fa5269897f2a047cd3a891476441f59eff5b6901cd4d5a1d1752c7dc1b105d5Installer version 4.3.0
https://www.virustotal.com/gui/file/bfbef42fb7f8b9eb65f4c2c0f84bee66d2460546a03c513a6574d3db4b4daaafInstaller version 4.2.0
https://www.virustotal.com/gui/file/335d9302efb12aa2a0015ac17ae45e3d70db19e21671f0d577d849a58ea76a9a/detectionInstaller version 4.1.0
https://www.virustotal.com/gui/file/8d2383a2a0e896d61388ba14c97a622dadcd62cf6400f5c924256fbffdfd95da/detectionInstaller version 3.5.1
https://www.virustotal.com/gui/file/a98782c9bd1490d56c9656bdf27821612a8af32edd97599611b2c2c5feffec57/detectionInstaller version 3.0.0
https://www.virustotal.com/gui/file/f7056b47c56d294e56c3c6058b42dbe214d18b82420aa0a31cbc5d0ef3668a1e/detectionIf you encounter any false positives, please report them to your AV vendor. We appreciate it!
Sourceforge link to release notes
https://sourceforge.net/p/keepass/discussion/329220/thread/3a0d58fa/?limit=100/The first version of KeeForm was released in 2005 in the AutoIt forums.
KeeForm bundles the following software in the installer package:
- AutoIt3.exe
- Include/*
- AES2.au3
That software is governed by the AutoIt license
https://www.autoitscript.com/autoit3/docs/license.htmWe try to help as much as possible, when/if we have time. You can contact us via Telegram or email directly. Or post in the KeePass forums.
This is on the todo-list, but other tasks have higher priority at the moment :(
But the installer includes the source code of the KeeForm FireFox and Chrome (and New Edge) browser extensions, the KeeForm native messaging component, and the KeePass add-on.
KeeForm uses a mix of programming languages.
- AutoIt (KeePass add-on)
- Golang (Native messaging)
- Javascript (browser extensions)