Welcome

gedcom4j is a Java library for loading (parsing) and saving 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 for parsing, manipulating, and writing GEDCOM data in your own programs.

The goal of the project is to provide an easy to use library for dealing with the hassle of parsing and writing files to and from the GEDCOM format.

News

11 May 2013 - v2.1.3 available

v2.1.3 of gedcom4j is available in the downloads section of the site. The new version includes support for embedded multimedia links (OBJE tags) under sources-with-citations (SOUR tags). Thanks to Fredrik Kjellberg for the patch.

1 Feb 2013 - v2.1.2 available

v2.1.2 of gedcom4j is available in the downloads section of the site. The new version includes a validation framework that examines your data structure for conformance to the GEDCOM spec to ensure that other programs will be more likely to successfully read GEDCOM files you produce. Includes an optional auto-repair feature to automatically fix simple mistakes. (See issue 11)

1 Jan 2013 - v2.1.1 available

v2.1.1 of gedcom4j is available in the downloads section of the site. The new version improves the performance of the relationship calculation feature, both in terms of speed, and in terms of the simplification rules, which now include great-aunts, great-uncles, great-nephews, great-nieces, and first cousins. (See Issues 43, 44, and 45).

17 Dec 2012 - Now on Maven Central

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

Building from Source

Minimum Requirement: JDK 5 or later

Requirements/recommendations for building source:

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

Demonstration

Like to see a demo?