Troubleshooting Common GenealogyJ Issues: Tips and Fixes

How to Import, Edit, and Export GEDCOM Files in GenealogyJ

GenealogyJ is a free, Java-based genealogy program that reads and writes GEDCOM files, making it a useful tool for building, editing, and sharing family trees. This guide walks through importing GEDCOM data, making common edits, and exporting updated GEDCOM files so you can preserve and share your research.

Before you begin

• Prerequisite: Java installed (Java 8 or later recommended).
• Download: Get GenealogyJ from its official site and install or run the portable version.
• Backup: Always keep a copy of your original GEDCOM file before editing.

Importing a GEDCOM file

1. Open GenealogyJ.
2. From the menu, choose File → Open.
3. Navigate to your GEDCOM (.ged) file and select it.
4. Click Open. GenealogyJ will load the file; larger GEDCOMs may take a moment.
5. Confirm that individuals, families, sources, and notes appear in the program’s views (Person, Family, Source lists).

Tip: If the GEDCOM uses a different character encoding (e.g., UTF-8 vs ANSI), GenealogyJ usually detects it, but if you see garbled characters, close the file and reopen using the correct encoding in the file-open dialog (if shown) or convert the GEDCOM encoding in a text editor before importing.

Navigating the interface for editing

• Person view: Shows names, vital events, notes, and references for a selected individual.
• Family view: Displays family relationships and children.
• Source view: Lists citations and source details.
• Event/date editors: Let you change dates, places, and event types.
• Notes and multimedia: Attach notes or media files to people or events.

Common edits (step-by-step)

1. Edit a name:

   • Select the person.
   • Click the name field (or choose Edit → Edit Person).
   • Modify given/surname and name type (birth, married, alias).
   • Save changes.

2. Correct or standardize dates:

   • Select an event (birth, death, marriage).
   • Click the date field and enter a new date. Use GEDCOM-friendly formats (e.g., 12 APR 1870, ABT 1870).
   • For uncertain dates, use qualifiers like ABT, BORN BEFORE (BEF), or FROM/TO.

3. Fix places:

   • Edit the place field and follow a consistent format (locality, county, state, country).
   • Use the same spelling and hierarchy to improve searching and matching.

4. Add or remove relationships:

   • In Family view, add a spouse or child via Add → Spouse/Child.
   • To remove a relationship, select the family link or the person entry in the family and choose Delete (review prompts carefully).

5. Edit sources and citations:

   • Open Source view.
   • Select a source and update title, author, repository, or citation text.
   • Link sources to events or individuals using the citation dialog.

6. Attach media:

   • Use Add → Multimedia or drag-and-drop (if supported).
   • Store media externally and reference their file paths, or embed according to preferences.

7. Use notes:

   • Add research notes or transcriptions to individuals or events for context.
   • Keep notes concise and date-stamped if useful.

Validation and consistency checks

• Run built-in consistency checks (if available) to find duplicate individuals, invalid dates, or missing relationships.
• Manually review warnings and resolve conflicts (e.g., overlapping lifespans, impossible dates).

Exporting GEDCOM files

1. After edits, choose File → Export → GEDCOM (or File → Save As → GEDCOM).
2. Enter a new filename to keep the original file unchanged.
3. Choose export settings:
   • Character encoding: select UTF-8 for best compatibility.
   • Privacy options: remove living person details if sharing publicly.
   • Media handling: decide whether to include multimedia file links or exclude them.
4. Click Save and confirm any prompts.

Tip: Validate the exported GEDCOM by reopening it in GenealogyJ or another genealogy program to ensure data integrity.

Troubleshooting common issues

• Garbled characters: Re-save the GEDCOM with UTF-8 encoding using a text editor or ensure correct encoding on export.
• Missing data after import: Check for unsupported custom tags; view the GEDCOM file in a text editor to confirm raw contents.
• Duplicates: Use merge or duplicate detection features; back up before merging.
• Large files slow to open: Increase Java memory allocation (edit the launch script or use a wrapper that sets JVM options).

Best practices

• Keep frequent backups and use versioned filenames (e.g., family_v1.ged, family_v2.ged).
• Standardize date and place formats across your file.
• Attach clear source citations for every fact you add.
• Strip or anonymize living-person details before sharing publicly.

Quick checklist before sharing

• Exported file opens without errors.
• Living persons’ private data removed or redacted.
• Sources linked and described.
• Media links valid or excluded as needed.
• File encoding set to UTF-8.

Following these steps will help you reliably import, edit, and export GEDCOM files using GenealogyJ while keeping your data consistent and shareable.