Discover how the keepassxc-tools repo helps you automate and secure your KeePassXC vault syncing over SFTP—complete with one-click GTK dialogs and merge-safe logic.

If you manage your passwords/SSH/GPG keys in KeePassXC, you know how important it is to keep your vault backed up and in sync. That’s where the keepassxc-tools repository comes in.

Why You Need `keepassxc-custom`

  • One Passphrase, One Prompt: Enter your SSH key & vault password just once via a GTK dialog.
  • Safe Sync: Pull your remote `.kdbx`, open locally, then push—only overwriting when no one else has modified the file.
  • Automatic Merge: If the remote changed while you edited, the script uses KeePassXC’s CLI merge to combine updates without data loss.

Getting Started

  1. Clone the repo into ~/.config/keepassxc and set your SSH key, remote path, and local path variables.
  2. Make the script executable: chmod +x bin/keepassxc-custom.
  3. Run keepassxc-custom to see GTK notifications guide you through pull, edit, merge, and push.

Built-In Safety Nets

The script checks if your vault is already open (using lsof or pgrep), waits for the SSH agent socket, and uses file modification times to decide whether to merge or overwrite—so you’ll never accidentally clobber a teammate’s changes.

Ready for seamless, conflict-free vault syncing? Head over to the keepassxc-tools repo and simplify your password management today!

This project builds on the KeePassXC open-source password manager