{"id":17978706,"url":"https://github.com/kkapsner/keepassxc-mail","last_synced_at":"2025-12-29T12:38:58.807Z","repository":{"id":37775129,"uuid":"233149963","full_name":"kkapsner/keepassxc-mail","owner":"kkapsner","description":"MailExtension to talk to keepassxc","archived":false,"fork":false,"pushed_at":"2025-04-08T17:23:18.000Z","size":456,"stargazers_count":66,"open_issues_count":9,"forks_count":6,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-09T21:17:35.745Z","etag":null,"topics":["keepassxc","mailextension","thunderbird-extension"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kkapsner.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2020-01-10T23:57:21.000Z","updated_at":"2025-04-08T16:27:48.000Z","dependencies_parsed_at":"2024-05-22T14:33:17.424Z","dependency_job_id":"faa48ee8-32a8-4db8-869d-0318a5d9dd85","html_url":"https://github.com/kkapsner/keepassxc-mail","commit_stats":{"total_commits":290,"total_committers":4,"mean_commits":72.5,"dds":"0.010344827586206917","last_synced_commit":"e2c143b1d04d135e390dd7ed57dcea6655aa8eba"},"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkapsner%2Fkeepassxc-mail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkapsner%2Fkeepassxc-mail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkapsner%2Fkeepassxc-mail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kkapsner%2Fkeepassxc-mail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kkapsner","download_url":"https://codeload.github.com/kkapsner/keepassxc-mail/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248111973,"owners_count":21049578,"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":["keepassxc","mailextension","thunderbird-extension"],"created_at":"2024-10-29T17:34:50.394Z","updated_at":"2025-12-29T12:38:58.788Z","avatar_url":"https://github.com/kkapsner.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# KeePassXC-Mail [![codebeat badge](https://codebeat.co/badges/0365004b-6336-4f7c-8611-bbd217f29aa0)](https://codebeat.co/projects/github-com-kkapsner-keepassxc-mail-master)\n\nMozilla Thunderbird extension for [KeePassXC](https://keepassxc.org/) with Native Messaging.\n\nBased on [KeePassXC-Browser](https://github.com/keepassxreboot/keepassxc-browser) and [keebird](https://github.com/kee-org/keebird).\n\n## Installation for KeePassXC\n\n*Hopefully we can get this as simple as for KeePassXC-Browser in the future.*\n\n 1. Configure KeePassXC-Browser as described in [this document](https://keepassxc.org/docs/KeePassXC_GettingStarted.html#_configure_keepassxc_browser). Make sure to enable the integration for Firefox.\n 2. Create the configuration file for Native Messaging as described below in [Native Messaging configuration](#native-messaging-configuration).\n 3. Install the add-on in Thunderbird. Either install it from [addons.thunderbird.net](https://addons.thunderbird.net/thunderbird/addon/keepassxc-mail/) or download the [latest prebuilt xpi](https://github.com/kkapsner/keepassxc-mail/releases/latest) or build it yourself (`npm install`, `npm run build`, the xpi will be in the `mail-ext-artifacts` directory).\n\n## Installation for KeePass 2\n\n1. Install KeepassNatMsg and configure it described in [this document](https://github.com/smorks/keepassnatmsg#installation)\n2. Install the add-on in Thunderbird. Either install it from [addons.thunderbird.net](https://addons.thunderbird.net/thunderbird/addon/keepassxc-mail/) or download the [latest prebuilt xpi](https://github.com/kkapsner/keepassxc-mail/releases/latest) or build it yourself (`npm install`, `npm run build`, the xpi will be in the `mail-ext-artifacts` directory).\n\n## Native Messaging configuration\n\n### Windows\n\nRun the following commands in the PowerShell:\n```PowerShell\n$browserJSONPath=Get-ItemPropertyValue -path 'HKCU:\\Software\\Mozilla\\NativeMessagingHosts\\org.keepassxc.keepassxc_browser' -name '(default)'\n$mailJSONPath=Join-Path -path (Split-Path -path $browserJSONPath) -childPath de.kkapsner.keepassxc_mail.json\n\ncat $browserJSONPath |\n %{$_ -replace \"keepassxc-browser@keepassxc.org\",\"keepassxc-mail@kkapsner.de\"} |\n %{$_ -replace \"org.keepassxc.keepassxc_browser\",\"de.kkapsner.keepassxc_mail\"} |\n Out-File -filePath $mailJSONPath -Encoding ASCII\n\nNew-Item -path 'HKCU:\\Software\\Mozilla\\NativeMessagingHosts\\de.kkapsner.keepassxc_mail' -type Directory -force\nSet-ItemProperty -path 'HKCU:\\Software\\Mozilla\\NativeMessagingHosts\\de.kkapsner.keepassxc_mail' -name '(default)' -value $mailJSONPath\n```\n\n### Linux\n\nRun the following command in a terminal:\n```Shell\ncat ~/.mozilla/native-messaging-hosts/org.keepassxc.keepassxc_browser.json \\\n | sed s/keepassxc-browser@keepassxc.org/keepassxc-mail@kkapsner.de/ \\\n | sed s/org.keepassxc.keepassxc_browser/de.kkapsner.keepassxc_mail/ \\\n \u003e ~/.mozilla/native-messaging-hosts/de.kkapsner.keepassxc_mail.json\n```\n\nIf Thunderbird is installed via Snap or flatpak you might need to enable the native messaging via the `widget.use-xdg-desktop-portal.native-messaging` setting (set it to 1 or 2) or do some deeper workarounds. See https://github.com/kkapsner/keepassxc-mail/issues/95 for further details.\n\n### Mac OS X\n\nRun the following command in a terminal:\n```Shell\ncat ~/Library/Application\\ Support/Mozilla/NativeMessagingHosts/org.keepassxc.keepassxc_browser.json \\\n | sed s/keepassxc-browser@keepassxc.org/keepassxc-mail@kkapsner.de/ \\\n | sed s/org.keepassxc.keepassxc_browser/de.kkapsner.keepassxc_mail/ \\\n \u003e ~/Library/Application\\ Support/Mozilla/NativeMessagingHosts/de.kkapsner.keepassxc_mail.json\nln -s ~/Library/Application\\ Support/Mozilla/NativeMessagingHosts/ ~/Library/Mozilla/\n```\n\n## Finding entries in the password database\n\nKeePassXC-Mail uses the following schema to find matching entries for a given server:\n\n * `imap://{server name}`\n * `smtp://{server name}`\n * `pop3://{server name}`\n * `http://{server name}`\n * `https://{server name}`\n * `nntp-1://{server name}`\n * `nntp-2://{server name}`\n * `oauth://{account}`\n * `masterPassword://Thunderbird`\n * `openpgp://{fingerprint of the private key}`\n\n### Tipp\n\nIf 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.\n\n## Translations\n\nYou can contribute to keepassxc-mail by translating it and/or improving the translations. For further instructions go to https://github.com/kkapsner/keepassxc-mail/issues/30.\n\n## Icon\n\nIcon is based on the icon of [KeePassXC-Browser](https://github.com/keepassxreboot/keepassxc-browser/blob/develop/keepassxc-browser/icons/keepassxc.svg) - just the colors are changed to some colors of the Thunderbird.\n\n## Privacy note\n\nKeePassXC-Mail itself does not contact any server and does not store any private data. For the automatic update process (before version 0.9) a server hosted by [PixelX](https://www.pixelx.de) is contacted. Apart of the usual server logging (IP address, access time and accessed location) nothing is stored.\nAfter version 0.9 this extension is hosted on [addons.thunderbird.net](https://addons.thunderbird.net/thunderbird/addon/keepassxc-mail/).\n\n## Used third party scripts\n\n * https://github.com/dchest/tweetnacl-js/blob/1.0.3/nacl.min.js\n * https://github.com/dchest/tweetnacl-util-js/blob/v0.15.0/nacl-util.min.js\n * https://github.com/keepassxreboot/keepassxc-browser/blob/1.9.11/keepassxc-browser/background/client.js\n * https://github.com/keepassxreboot/keepassxc-browser/blob/1.9.11/keepassxc-browser/background/keepass.js\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkkapsner%2Fkeepassxc-mail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkkapsner%2Fkeepassxc-mail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkkapsner%2Fkeepassxc-mail/lists"}