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

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.

7 Oct 2013 - v2.1.5 available

v2.1.5 of gedcom4j is available in the downloads section. This release fixes an issue in parsing files that have leading whitespace on lines. The spec says to ignore leading whitespaces on lines when reading, even though the spec also says not to put leading whitespace on lines when writing.

The upshot of this is that gedcom4j is now more compliant to the spec and is more forgiving when working with files from tools that don't strictly adhere to the spec.

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?