The purpose of this project is to create a Java library for loading (parsing) and saving GEDCOM 5.5 files to/from a Java object hierarchy, which can be manipulated by your code as you see fit.

Please note that gedcom4j is not an application. It is a library for parsing, manipulating, and writing GEDCOM data in your own programs.

Minimum Requirement: JDK 5 or later

Requirements/recommendations for building source:

• ANT 1.7 or later
• Eclipse (recommended, not required)

Documentation (such as it is) is available here. Javadoc for the library is also available here.

Quick Start

1. Put gedcom4j.jar in your project's classpath.
2. Add some code like this to load a GEDCOM file:

    GedcomParser gp = new GedcomParser();
    gp.load("sample/TGC551.ged");

3. Access the data by working with the properties of the gp.gedcom structure:

    Submitter submitter = gp.gedcom.submitters.values().iterator().next();
    for (Family f : gp.gedcom.families.values()) {
        if (f.husband != null && f.wife != null) {
            System.out.println(f.husband.names.get(0).basic
                + " married " + f.wife.names.get(0).basic);
        }
    }

Like it? Please consider +1'ing it and/or marking that you use it!