Download Scripts

Script IconBy running the scripts listed in the "Scripts" menu of GEDitCOM II you can access new features of GEDitCOM II and even create your own features. These scripts can automate editing tasks, create web sites, compile reports, and much more.

The following sections have groups of scripts for GEDitCOM II divided by their functions. Click the arrows to expand any section. In the tables that appear, click "show/hide details" to expand or contract a description of any script. After downloading any script, see installation instructions for where to copy the file for best use in GEDitCOM II.

Besides scripts, see the modules section for Python modules that contain libraries of classes and functions you can use in Python scripts.


▸ Editing Tools

These scripts help you edit your genealogy data, sometimes doing many tasks in a single click.

Script Date
Add or Remove Keywords    (show/hide details)
Add or remove keywords to selected records or to various record types.
13 Nov 2010
Ancestors To Album    (show/hide details)
This script moves all ancestors or a single line of either paternal or material ancestors to a new album. Once in the album, you can use any GEDitCOM II features for working with albums (e.g., export to a new file, etc.). The single paternal or material lines might have uses for those involved in genetics research.
13 Nov 2010
Change Name Case    (show/hide details)
Change the names of all (or selected) individuals to have "UPPERCASE NAMES" (the entire name in uppercase), "Uppercase SURNAMES " (just the surname in uppercase) or "Title Case Names" (first letter of each name part capitalized).
13 Nov 2010
Change Name Case (Python)    (show/hide details)
Change the names of all (or selected) individuals to have "UPPERCASE NAMES" (the entire name in uppercase), "Uppercase SURNAMES " (just the surname in uppercase) or "Title Case Names" (first letter of each name part capitalized).
22 Jan 2012
Change Name Case (Ruby)    (show/hide details)
Change the names of all (or selected) individuals to have "UPPERCASE NAMES" (the entire name in uppercase), "Uppercase SURNAMES " (just the surname in uppercase) or "Title Case Names" (first letter of each name part capitalized).
13 Nov 2010
Check Has Died    (show/hide details)
To improve your data, it is useful to check the "Has Died" check box in all individuals who are known to be deceased, but for which no additional death information is known. This script will go through all (or selected) individuals and try to determine if those with no death information are likely to be deceased. When the script is done, it will show a report that lists all individuals for which it could not determine if they are living or deceased. To complete the "Check Has Died" procedure, go through the output report and check the "Has Died" check box for those known to be deceased.
13 Nov 2010
Delete Living Dates    (show/hide details)
This script will go through your file and remove birth, baptism, and christening dates from all individuals thought to be alive (because it deletes data, make sure to work with a copy of your data). This script assumes someone might be alive if they have no death information. Before using this script, you should go through your data to verify all individuals known to be deceased either have death details or have the "Has Died" box checked. The Check Has Died script can help complete this task.
22 Jan 2012
Find and Merge Duplicates    (show/hide details)
This script provides computer-assisted merging of duplicate records, such as those that might appear after merging of files. Please refer to merging information in the GEDitCOM II help for all the details.
14 Mar 2012
Find by Age    (show/hide details)
Finds individuals by their age at death, such as all individuals who died after then were 90 years old.
28 Jan 2013
Find by Marriage Age    (show/hide details)
Finds individuals by their age at marriage, such as all individuals who married before they were 20.
28 Jan 2013
Find Disconnected Records    (show/hide details)
Helps you clean up a file by locating records that are disconnected from other records and therefore might not be needed in the file. Any disconnected records found will be moved to a new album. If you no longer need those records, open the album, select some or all, and use the delete record menu command.
6 Feb 2012
Find Lineage Errors    (show/hide details)
This script helps locate locate lineage errors where an individual has themself as their own ancestor.
6 Feb 2012
Find Similar Surnames    (show/hide details)
This script will go through all records and find those whose surname is the same or sounds the same as the currently selected record. The sound matching is down by the SoundEx code of the surname. The found records will be moved to a new album.
13 Nov 2010
Find Special Events    (show/hide details)
This script will go through all or selected records and find those with one or more of a selected type of event. The found records will be moved to a new album. It is easy to customize the script to find additional types of events by opening the script in Apple's ScriptEditor and following the instructions in the comments at the beginning of the script.
13 Nov 2010
Merge Duplicate Notes    (show/hide details)
This script goes through all note records (starting at one you select when the script starts) and merges all pairs of note records that have exactly the same text (case insensitve comparison with leading and trailing spaces ignored). This script is much faster then merging notes using the "Find and Merge Duplicates" script, but only merges identical notes while the other script will look for similar notes to merge too.
14 Mar 2012
Miscellaneous Tasks    (show/hide details)
This script performs various editing tasks. You can select the task to perform from a list.
11 Mar 2013
Move Part of Place to Address    (show/hide details)
To gain the most benefit from the place record methods introduced in GEDitCOM II, version 1.7, it is a good idea to organize your places, which includes moving any address information you entered into place fields to the corresponding address field. The process is easy but tedious. This script makes it much easier. Simply select a place record and run the script. Any address text you delete will be moved to address fields for all records that refer to that place and the place name will be changed to town-level (or higher) name you indicate.
14 Mar 2012
Remove Duplicate Family Links    (show/hide details)
Occasionally, individual records have duplicate links to the same family. These duplicates show up as the same family appearing two or more times in the individual's display. This problem should not occur when using GEDitCOM II, but it might occur after merging GEDCOM files from other sources. They either mean there are two different family records or the individual is linked twice to the same record. If the first reason, you should merge records in the file. If the second reaason, this script should fix all duplicate links.
6 Feb 2012

▸ Export Data

These scripts help you export data or prepare data for export.

Script Date
Customizable GEDCOM Exporting    (show/hide details)
This script exports a GEDCOM file but has certain key decision points where you can edit the script to create any kind of customizable GEDCOM exporting process. See the comments in the script for all the details.
6 Feb 2012
Export Privacy GEDCOM File    (show/hide details)
Export a GEDCOM file for your data, except that those individuals marked as "privacy" records will only include their names and and family links; all other information will be omitted. Furthermore, the names in the "privacy" records can be the actual names or can be hidden.
4 Dec 2010
Export vCards    (show/hide details)
This script will export all or selected individual records to a standard vCard file (extension .vcf). Such files can be imported into application's like Apple's Address Book application. This script works well along with the "Address Book" format for editing residences.
6 Feb 2012
GEDCOM with Embedded Notes    (show/hide details)
This script exports your data to a GEDCOM file in which all note records are embedded in the records that link to those notes. You should always use the built-in GEDCOM export features if you can. This script is provided in case you need to work with outdated or simplistic GEDCOM software that cannot handle separate note records. Using this script instead, might make it possible to get data into such software.
14 Mar 2012
Move Memos to Notes    (show/hide details)
GEDitCOM II lets you attach short memos to any editing field, but these memos are often lost if the data is exported to a GEDCOM file and read by other software. If you want a better chance the other software will read the memos, run this script before exporting to a GEDCOM file. This script will move all memos to standard GEDCOM notes. It is no guarantee the ofter software will read those notes, but they will be more likely to be found.
6 Feb 2012
Share Family Tree    (show/hide details)
A GEDitCOM II tutorial explains how you can export any subset of records to a GEDCOM file to share your tree with a friend. If the export includes multimedia records, that same tutorial explains some extra steps needed to package multimedia objects along with the GEDCOM file. If the subset records you want to share are the ancestors or descendants of an individual or all individuals in the currently visible family tree, this script will do all the steps in that tutorial in a single click. If you plan to email to a friend or transfer to another computer, this script will even compress the results into a .zip archive ready for transfer.
6 Feb 2012
Share GEDCOM File with Multimedia    (show/hide details)
GEDitCOM II has a menu command to export your file to a GEDCOM file to share with a friend using another computer and other software. If your file has multimedia objects, the export requires some extra work. This script will do all that extra work in a single click. If you plan to email to a friend or transfer to another computer, this script will even compress the results into a .zip archive ready for transfer.
6 Feb 2012

▸ Import Data

These scripts help you import data into genealogy files.

Script Date
Import Individuals in Tab-Delimited File    (show/hide details)
This script can input genealogy data you receive in a tab-delimited spreadsheet file and convert them to records in your file. It can solve the problem of getting lots of new data into your file without doing it by hand. See the comments in the script for steps need to prepare the file for import (you only need to label the columns with the GEDCOM tag name).
6 Feb 2012

▸ Maps

These scripts will draw maps from your genealogy data.

Script Date
Event Places for Window Records    (show/hide details)
Draws a map with pins at locations for events and attributes in individuals and families in the current front window.
30 Sep 2012
Places in this File    (show/hide details)
Draws a map with pins for all or selected places in your file. A pop-up window for each pin will have a link to the place record and to a web site abot the place (if available).
14 Mar 2012

▸ Repair GEDCOM Files

These scripts try to repair issues in GEDCOM files created by various other applications.

Script Date
Fix Family Roots    (show/hide details)
An old program called "Family Roots" writes poor GEDCOM files or an outdated GEDCOM format. They have FATH and MOTH and SPOU links in individuals and may have no family records at all. If you get such a file (check the header to see if it came from Family Roots), you can download this script and see if it helps. You should run a "Validate GEDCOM Data..." after this script to check for remaining issues.
    The script was based on some sample Family Roots files and may not fix all issues. You can email a sample GEDCOM file to geditcom.com if you find some new issues.
13 Nov 2010
Fix Family Search Download    (show/hide details)
Some GEDCOM files downloaded from familysearch.org have minor issues with their GEDCOM data. This script cleans up some known problems thereby making those files work better with GEDitCOM II.
13 Nov 2010
Fix Reunion GEDCOM File    (show/hide details)
Exported GEDCOM files from the Macintosh program Reunion have several GEDCOM errors and makes use of many custom tags that are not useful in GEDitCOM II. This script will try to fix these issues to get an improved file. You should run a "Validate GEDCOM Data..." after this script to check for remaining issues.
    This script was based on some sample Reunion files and may not fix all issues. You can email a sample GEDCOM file to geditcom.com if you find some new issues.
13 Nov 2010

▸ Reports

These scripts produce many kinds of reports on your genealogy data. By editing these scripts yourself, you can create any kind of report you want.

Script Date
Address Book    (show/hide details)
This script produces a report in the form of the address book highlighting residence information for individuals. It is best used on selected records that have known residence events. This script works well along with the "Address Book" format for editing residences.
13 Nov 2010
Age Analysis Report    (show/hide details)
Prepare report of known ages at death in your file including a bar chart with the distribution of ages.
13 Nov 2010
Ahnentafel Report    (show/hide details)
This report duplicates the built-in Ahnentafel report of GEDitCOM II. By having a script version, however, you can edit the script and customize with options not available in the built-in report. For example, you can change the details or the format of the output for each individual or you can translate the report into any language.
6 Feb 2012
Ancestors Outline Report    (show/hide details)
Prepare a concise report for a user-entered number of ancestor generations of the currently selected individual. It is similar to a "Family Tree as List..." report in GEDitCOM II except you don't need to open an Ancestor Family Tree first and by editing the script you can customize the output. Furthermore, you can download versions of this script that output the report to an MS Word or to a Pages document.
8 Dec 2010
Check Sources Quality    (show/hide details)
It is essential to have good quality sources for your information. This script prepares a report for all birth, marriage and death events (and related: baptism, burial, etc., events) whose source is absent, of poor quality, or has undefined quality. It works best if the SOURCE QUALITY (QUAY) field has been set for each source by the family historian. This script was contributed by Lindsay Crawford.
13 Nov 2010
Descendants Generations Report    (show/hide details)
Prepares a report of a user-entered number of descendant generations for the currently selected individual. The descendants are grouped by generation number (i.e., all children in "Generation #1", grandchildren in "Generation #2", etc.). By editing the script, you can easily customomize the events that are included in the output (see comments at the beginning to learn how). In addition, you can download versions of this script that output the report to an MS Word or to a Pages document.
19 Nov 2012
Descendants Outline Report    (show/hide details)
Prepare a concise report for a user-entered number of descendant generations of the currently selected individual. It is similar to a "Family Tree as List..." report in GEDitCOM II except you don't need to open an Descendant Family Tree first and by editing the script you can customize the output. Furthermore, you can download versions of this script that output the report to an MS Word or to a Pages document.
13 Nov 2010
EGT Report
EGT LaTeX Report    (show/hide details)
These two descendants reports are based on the clever system of cross-reference numbers invented by an experienced genealogist, very famous in Canada especially in Quebec, marist brother Éloi-Gérard Talbot (1899-1976). The report output has an introduction with more details about its content. The "EGT Report" version produces a report in a GEDitCOM II window. The "EGT LaTeX Report" version uses LaTeX to typeset the report and even does the typesetting for you (assuming you have standard installation of LaTeX on your computer).
    These reports were written by Stéphane LELAURE. For further information on brother Talbot, you can read this book by Laurent Potvin: "Eloi-Gérard Talbot. Un généalogiste chevronné", published in 2008 and available for free in French on this website.
12 Jun 2012
Four Gen Chart    (show/hide details)
Creates a simple, four-generation pedigree chart that can be printed on a single page. It shows names and lifespans of individuals.
20 Apr 2012
Generational Age Analysis    (show/hide details)
Looks at all families (or just selected families) and calculates the average age at which males and females married and the average age at which they had children. It is similar to a tuturial report except that it also prints extrema (e.g., oldest and youngest spouse and parent).
13 Nov 2010
Generations LaTeX Book    (show/hide details)
This script creates a fancy book from your genealogy data. The process involves typesetting the ouput files using LaTeX. All the details are given in an on-line tutorial. This script requires extra files with LaTeX style sheets for the book and they must be in the same folder as the script. You can download those files here (BookLaTeXDefs.tex and BookLaTeXDefs2.tex). It also requores the BookPreparation module, which must be in the Modules folder.
12 Jun 2012
Perpetual Calendar    (show/hide details)
This report prepares a perpetual calendar that lists birth dates, death dates, and/or marriage dates for all (or selected individuals) for each day in the year.
6 Feb 2012
Timeline Report    (show/hide details)
This report looks through all or selected individuals and prepares a chronological list of common events that have dates into a timeline report.
    This report was designed by Lindsay Crawford and translated by John Nairn to python to handle and size timeline and for speed.
6 Feb 2012
Two Per Page    (show/hide details)
Creates plain-text report with two individual per page showing birth, marriage, and death details, parents, and children. Any missing data leaves a blank space. If printed it prints with good page breaks on US printers, but may need editing to work with A4 paper.
28 Jan 2013
US-UK-Canadian Census Report    (show/hide details)
If your research involves census records, this script will go through your file and make a list of all those with census information and all those that you might be able to find in a census. The cells for each possible individual under each available census will be color coded according to the likelihood of them being it that census. You can use the report to optimize your census research time.
    This report was written by Simon Robbins. The report is based on US, UK, or Canadian Census dates. If you edit the script and insert other census dates, the report could easily be converted into a census report for other countries.
20 Apr 2012

▸ Reports to Pages

These scripts produce reports and outputs the results to a Pages doucment. You must have the application Pages to use these scripts.

Script Date
Ancestors Outline    (show/hide details)
This script produces a report identical to the Ancestors Outline Report except the final result is output to a new Pages document.
8 Dec 2010
Descendants Generations    (show/hide details)
This script produces a report identical to the Descendants Generations Report except the final result is output to a new Pages document.
19 Nov 2012
Descendants Outline    (show/hide details)
This script produces a report identical to the Descendants Outline Report except the final result is output to a new Pages document.
13 Nov 2010

▸ Reports to Word

These scripts produce reports and outputs the results to an MS Word document. You must have the application MS Word to use these scripts.

Script Date
Ancestors Outline    (show/hide details)
This script produces a report identical to the Ancestors Outline Report except the final result is output to a new MS Word document.
8 Dec 2010
Descendants Generations    (show/hide details)
This script produces a report identical to the Descendants Generations Report except the final result is output to a new MS Word document.
19 Nov 2012
Descendants Outline    (show/hide details)
This script produces a report identical to the Descendants Outline Report except the final result is output to a new MS Word document.
13 Nov 2010

▸ Utilities

These scripts perform various utility functions that add new features to using GEDitCOM II.

Script Date
Copy Custom    (show/hide details)
Copy basic information on each currently selected record to the clipboard. Once the script is done, you can "Paste" the text any place that accepts pasted text, such as into an email message. GEDitCOM II has a built-in "Copy Special" command. You only need this script if you want to customize the data that gets copied. Edit the script to copy the data you want for each type of record. See script comments for details.
13 Nov 2010
Download Interface Format    (show/hide details)
Let's you select any interface format currently posted on geditcom.com and then download, expand, and install it either the system area or the user area. It simplifies the steps of installing updated or new interface formats.
6 Feb 2012
Download Script    (show/hide details)
Let's you select any script currently posted on on this page of geditcom.com, and then download, expand, and install it either the system area or the user area. It simplifies the steps of installing updated or new scripts.
6 Feb 2012
Print Selected in Book Format    (show/hide details)
Automatically switch to the "Book Format" and print all currently selected records. When done, it switches back to your previous format. It switches formats because the "Book Format" is a good format for printing.
13 Nov 2010
Print Selected in Wiki Genealogy    (show/hide details)
Automatically switch to the "Wiki Genealogy" format and print all currently selected records. When done, it switches back to your previous format. It switch formats because the "Wiki Genealogy" format is a good format for printing.
13 Nov 2010
Read Selected Text    (show/hide details)
Select any text in a record and use this script to have GEDitCOM II read it to you.
13 Nov 2010

▸ Web Sites

These scripts create web sites from your genealogy data

Script Date
Create Web Site    (show/hide details)
This script will create a complete, self-contained web site for the entire file including multimedia objects. There are tutorials on using this script and on customizing the resulting web site. Here is a sample web site created with this script. Many of the nice features (e.g., tables and pop-up images) were written by Simon Robbins.
30 Sep 2012
Maak Website    (show/hide details)
This script translates the Create Web Site script to create a Dutch language web site. This script was written by Ronald Hellenbrand.
13 Nov 2010
Skapa Web Sidan    (show/hide details)
This script translates the Create Web Site script to create a Swedish language web site. This script was written by Risto Virtanen.
13 Nov 2010

▸ User Contributed

These section has various scripts submitted by GEDitCOM II users. They would like to share them with other users.

Script Date
Descendants Report    (show/hide details)
Prepare narrative report of the descendants of the currently selected individual. The report can be displayed in GEDitCOM II or exported to a Pages document.
    This script was contributed by David Walton. It used to be part of the GEDitCOM II installation, but is now replaced by the new Descendants Generations Report (and separate versions for exporting to MS Word or Pages) when new AppleScripting features made in possible to write a faster script. The new reports are similar this original report.
13 Nov 2010
Open Scripts Folder    (show/hide details)
Shows the folder containing this script in the Finder. This script is mostly replaced by menu options in GEDitCOM II to open scripts and/or open scripts folders. It is included for potential use in other folders and as an example of using Finder commands in GEDitCOM II scripts.
    This script was contributed by Stéphane LeLaure.
13 Nov 2010

Python Modules for GEDitCOM II

These Python modules can be installed in the "Modules" folder of the GEDitCOM II application support folder and can then be used by any other GEDitCOM II script written in Python.

Module Date
GEDitCOMII.py    (show/hide details)
This GEDitCOMII module comes with the basic GEDitCOM II installation. Since it is evolving, this download my have a more recent module than in the current install package. You can check your version by opening the script in the GEDitCOM Editor and looking in the comments at the beginning of the module. See an on-line tutorial for documentation.
28 Jan 2013
BookPreparation.py    (show/hide details)
This module comes with the basic GEDitCOM II installation. It is used (and required) by the "Generations LaTeX Book" script. Other methods may be able to make use of some methods, such as utilities for working with LaTeX output.
12 Jun 2012
Lifelines Emulation (version 1.0)    (show/hide details)
This module turns Python scripting of GEDitCOM II into a platform for emulation of programs written for the genealogy program called Lifelines. After downloading, expand the file to get a folder called "Lifelines" and refer to the "ReadMe.txt" file in the folder for how to install and for where to find documentation. There is also an on-line tutorial on Lifelines emulation to help you get started.
18 Feb 2011

Submit a New Script

Any user who knows how to write AppleScript, Python, or Ruby scripts can write their own scripts to add new features to GEDitCOM II. You can write AppleScripts using Apple's Script Editor or edit Python an Ruby scripts right in the GEDitCOM Editor. To get started, you should refer to the "Scripting" section of the GEDitCOM II help window and also to the Tutorials on scripting GEDitCOM II on this web site.

If you do take the time to write a new script and would then like to share it with other users, you can submit it to geditcom.com for inclusion on this web page in the user-contributed scripts section or other section. The submittal process is:

  1. Control-click on your script file in the Finder and select the command to compress the file (e.g., "Compress 'MyScript.scpt' ")
  2. Attach that file to an email to geditcom.com and describe the script in the body of the email.

Installation

The simplest way to install scripts is to run the "Download Script" script while running GEDitCOM II. This script will give you a list of all available scripts. Select the one you want and then choose "To System Scripts" or "To User Scripts" for where to install it. You should choose "To System Scripts" when updating a standard script. You should choose "To User Scripts" if you plan to later edit the script for customizations.

If for some reason the download script does not work, here is manual method for downloading and installing scripts:

  1. After downloading, the script should automatically expand itself into script file (extension .scpt). If it appears instead as an archive file (extension .zip), simply double click on the file and it will expand to a script file.
  2. Script IconTo install in GEDitCOM II's "Scripts" menu, the file needs to be placed in one of two places:
    • ~/Library/Application Support/GEDitCOM II/Scripts: The "~" means to start in your Home folder, open the Library folder, open the Application Support folder, open the GEDitCOM II folder, and finally open the Scripts folder. If you put the script in that final folder, it will appear in the "Scripts" menu in the "--User Scripts--" section and will be visible only when running in your user account.
    • ~/Library/Application Support/GEDitCOM II/System/Scripts: To find this folder, start in your home folder, open the Library folder, open the Application Support folder, open the GEDitCOM II folder, open the System folder and finally open the Scripts folder. If you put the script file in that final folder, it will appear in the "Scripts" menu in the "--System Scripts--" section and will be visible to all user accounts.
    • Python modules should be placed instead in one of two Modules folders in the same folders as the above Scripts folders (next to the Scripts folder, not inside it). If no Modules folder is there, you should create it.
  3. If GEDitCOM II is already running, choose the "Refresh Scripts" menu command in the "Scripts" menu and the new script will appear in the list of available scripts. If GEDitCOM II is not running, the new script will appear when you start it.
  4. To use the new script, select its name in the "Scripts" menu. If it is not clear how to use it (e.g., an undocumented script written by a user), you can open the script in Apple's "Script Editor" (Hint: use the menu commands in the Scripts menu to reveal user or system scripts folder in the Finder and then double click the script file to open it). Hopefully whoever wrote the script explained how to use it in comments at the beginning of the script text.
Download Categories