Welcome

gedcom4j is an open-source, free-to-use Java library for loading (parsing) and saving genealogy data in GEDCOM 5.5 or 5.5.1 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 (jar file) that can parse, manipulate, and write genealogy data using the GEDCOM format in your own Java programs.

News

29 Oct 2014 - v2.1.9 available

v2.1.9 of gedcom4j is available in the downloads section of this site, and on Maven Central.

This release fixes an issue where the parser was being too strict and rejecting GEDCOM files that contained completely blank lines. Thanks to Baptiste Fontaine for reporting the bug.

26 Jun 2014 - v2.1.8 available

v2.1.8 of gedcom4j is available in the downloads section of this site, and on Maven Central.

This release fixes an issue where an individual would not be loaded properly if a refererence to that individual's ID appeared earlier in the file (such as in a family record) than the actual individual. Thanks to PeWu for reporting the defect.

14 Jun 2014 - v2.1.7 available

v2.1.7 of gedcom4j is available in the downloads section of this site, and on Maven Central.

This release improves compatibility with GEDCOM files that have description text following event tags. These descriptions are strictly non-standard, but many common software packages (including Family Tree Maker) write these descriptions in files, and prior to this change, these values were being ignored on input. Event descriptions are now parsed and loaded into the object model, but must be moved (perhaps to a Note) or removed in order to pass validation as part of writing ... or validation can be suppressed.

13 Mar 2014 - v2.1.6 available

v2.1.6 of gedcom4j is available in the downloads section of this site, and on Maven Central.

This release fixes an issue where you could run into infinite recursion when using hashCode() on a StringTree, which would result in a StackOverflowError.

This release also adds a feature where unknown tags in a GEDCOM file that do not begin with underscores can optionally be loaded as non-standard custom tags rather than being discarded as errors.

Thanks to BertKoor for reporting and effectively solving the infinite recursion bug, and for suggesting more lenient parsing for non-standard tags.

We're on Maven Central

For you Apache Maven fans out there, gedcom4j is in the Maven Central Repository.

Building from Source

Minimum Requirement: Java Development Kit 5 (any edition) or later

Requirements/recommendations for building the software from source code:

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

Demonstration

Like to see a demo?