DEV Community

Cover image for KeePassDiff: A diff/merge tool for KeePassXC databases
Billy
Billy

Posted on

KeePassDiff: A diff/merge tool for KeePassXC databases

I started using KeePass back in 2021 and I have been using it since then to store my passwords. But I didn't set up a proper way to sync the database between my devices. So I ended up with multiple databases with different passwords and entries. I wanted to sort of diff the databases and merge them into one, like git diff -- resolving conflicts, reverting, etc. Well, KeePass doesn't provide a way to diff two databases. Hence this project.

Usage

  1. Open two KeePass databases in diff.
  2. See the differences and conflicting entries between the two databases.
  3. Then using merge left, merge right options decide which entries or groups to keep and which to discard.
  4. Finally, export the merged database.

Installation

pip install keepassdiff
Enter fullscreen mode Exit fullscreen mode

Run kpd or kpdiff to run the tool.

image

Features

Following is a tracker for all the features I'm aiming for the project.
If you are interested in giving me a hand, check the github repo

✅ Support for KeePassXC databases
✅ Uploading and unlocking two KeePass databases
✅ Supports both password and keyfile authentication
✅ Visual diff of entries and groups
✅ Support for entry groups
✅ Hierarchical view of database contents
✅ Merging individual entries and groups between databases
✅ Exporting the final merged database
⏺️ Resolving conflicting entries with preferred ones
⏺️ Command-line interface for batch processing
⏺️ Copying passwords to clipboard, clearing clipboard after timeout

Security

All database handling is done locally and no data is stored or transmitted. Temporary files are securely deleted after use, passwords are not stored.

Development

git clone https://github.com/tomlin7/KeePassDiff.git
cd KeePassDiff
pip install -e .
kpd
Enter fullscreen mode Exit fullscreen mode

Top comments (0)