Skip to content

bkloppenborg/revelation-to-keepassxc

Repository files navigation

Revelation XML to KeePassXC Converter

This tool converts a Revelation XML export file to a CSV format comptable with KeePassXC. It preserves the organizational structure and all fields in the Revelation XML output.

Revelation Input Database

KeePassXC Import

Prerequisites

If your password database uses only ASCII characters, no further steps are required.

If your password database uses unicode characters, like letters with accents, please install the unicodecsv package using either your system's package manager or pip.

For example, on Ubuntu 20.04 you would run

sudo apt install python3-unicodecsv

and substitude python3 for python in the command listed below.

Instructions

  1. Open the Revelation password database.
  2. Choose File -> Export. Save the file as a XML file
  3. Accept the "Save to Insecure File" dialog.
  4. Run the python script in this repository to convert the Revelation Output XML file to a KeePassXC-compatable CSV file using a command similar to the following: python revelation-xml-to-keepassxc.py REVELATION_XML_FILE DESIRED_OUTPUT_FILE for example: python revelation-xml-to-keepassxc.py passwords.xml passwords.csv
  5. Import the resulting file into KeePassXC using the "Import CSV" function. Be sure to click the "First Record Has Field Names" button and map the column layout as shown below.
  6. Spot check that the import worked correctly. If there are problems, please report them using the issue tracker above.

KeePassXC Field Mapping

Demo

Want to see how this works on your own system before exporting your Revelation database? Try out the functionality on the included demo database.

Open the demo-database/revelation-test-db file in Revelation and try out the instructions above. The database password is "demo".

License

License: GPL v3

Donations

If you found this script helpful, please consider donating.

All donations go to Brian Kloppenborg, the original project author and current maintainer.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages