gramps-gedcom7

A GEDCOM 7 import library for Gramps.

Project Status

The library provides comprehensive GEDCOM 7 import functionality. The implementation covers the vast majority of features and has been successfully tested with real-world files. While suitable for production use, users should verify results as with any conversion tool.

Installation

To install the library, simply run:

python -m pip install gramps-gedcom7

Note that this will also install Gramps with pip, if it is not installed in your environment yet.

Usage as command-line tool

The tool can be used to convert a GEDCOM 7 file to a Gramps XML file on the command line. The command is:

python -m gramps_gedcom7.gedcom2xml path/to/input.ged path/to/output.gramps

Instead of an output file name, you can also specify - to write the output to standard output.

Usage as Gramps plugin

The tool cannot be used as a Gramps plugin yet, since its interaction with the Gedcom 5 core plugin is not clarified. See this thread for the discussion.

Web interface

A Streamlit web interface is available for interactive use at gramps-gedcom7.streamlit.app.

You can also run it locally:

python -m gramps_gedcom7.web

This opens a web browser where you can upload GEDCOM 7 files and download the converted Gramps XML files.