kerberizer/keepassxc-mail

MailExtension to talk to keepassxc

KeePassXC-Mail

Mozilla Thunderbird extension for KeePassXC with Native Messaging.

Based on KeePassXC-Browser and keebird.

Usage

Hopefully we can get this as simple as for KeePassXC-Browser in the future.

1. First the KeePassXC-Browser configuration (described in this document) has to be done.
2. Afterwards the configuration file for the Native Messaging has to be created.
3. At the end the addon can be installed in Thunderbird (download the latest xpi here).

Native Messaging configuration

Windows

Run the following commands in the PowerShell:

$browserJSONPath=Get-ItemPropertyValue -path 'HKCU:\Software\Mozilla\NativeMessagingHosts\org.keepassxc.keepassxc_browser' -name '(default)'
$mailJSONPath=Join-Path -path (Split-Path -path $browserJSONPath) -childPath de.kkapsner.keepassxc_mail.json

cat $browserJSONPath |
 %{$_ -replace "[email protected]","[email protected]"} |
 %{$_ -replace "org.keepassxc.keepassxc_browser","de.kkapsner.keepassxc_mail"} |
 Out-File -filePath $mailJSONPath -Encoding ASCII

New-Item -path 'HKCU:\Software\Mozilla\NativeMessagingHosts\de.kkapsner.keepassxc_mail' -type Directory -force
Set-ItemProperty -path 'HKCU:\Software\Mozilla\NativeMessagingHosts\de.kkapsner.keepassxc_mail' -name '(default)' -value $mailJSONPath

Linux

Run the following command in a terminal:

cat ~/.mozilla/native-messaging-hosts/org.keepassxc.keepassxc_browser.json \
 | sed s/[email protected]/[email protected]/ \
 | sed s/org.keepassxc.keepassxc_browser/de.kkapsner.keepassxc_mail/ \
 > ~/.mozilla/native-messaging-hosts/de.kkapsner.keepassxc_mail.json

Mac OS X

Run the following command in a terminal:

cat ~/Library/Application\ Support/Mozilla/NativeMessagingHosts/org.keepassxc.keepassxc_browser.json \
 | sed s/[email protected]/[email protected]/ \
 | sed s/org.keepassxc.keepassxc_browser/de.kkapsner.keepassxc_mail/ \
 > ~/Library/Application\ Support/Mozilla/NativeMessagingHosts/de.kkapsner.keepassxc_mail.json
ln -s ~/Library/Application\ Support/Mozilla/NativeMessagingHosts/ ~/Library/Mozilla/

Finding entries in the password database

KeePassXC-Mail uses the following schema to find matching entries for a given server:

• imap://{server name}
• smtp://{server name}
• pop3://{server name}
• http://{server name}
• https://{server name}
• nntp-1://{server name}
• nntp-2://{server name}
• oauth://{account}

Tipp

If you have the same user and password for receiving (imap/pop3) and sending (smtp) and do not want to duplicate your entries you can go to the "Browser Integration" section of the entry definition in KeePassXC and add the second URL there.

Icon

Icon is based on the icon of KeePassXC-Browser - just the colors are changed to some colors of the Thunderbird.