Skip to main content

Find the nearest DNA-flagged relatives in a GEDCOM family tree

Project description

GEDCOM Navigator

Who is this for?

This application is for genealogists who manage large GEDCOM files, particularly with tags for DNA matches.

What does it do?

This application provides useful ways to rapidly explore a GEDCOM file exported from genealogy services like Ancestry, MyHeritage, Geni, and Family Tree Maker:

  • Find the closest tagged people (e.g. DNA match) to any other person in a family tree
  • Show multiple relationship paths between any two people in your tree
  • Search your tree for variations on names (maiden/married name, alternate names, fuzzy matching, and Hebrew/Cyrillic transliterations) and filter on other information like geographical locations or occupation
  • Rapidly explore names and connections, even in a very large tree with very distant connections
  • Generate custom images of parts of your tree, expanding or collapsing the connections you want to see and saving them to your clipboard or an image file
  • Visualize relationships between any two people graphically

The tool does not modify your GEDCOM file. It is used for exploring connections.

In addition to the GUI, this application also includes a command-line tool for fast queries or incorporating into other programmatic workflows.

Downloads

This is a beta release. If you are interested in experimenting with a "dummy" GEDCOM file rather than your own, here are a couple of options:

  • Use the Fictional Genealogy sample file I built for testing this application. It contains 1,000 fictional people and illustrates various complicated family connections. If you want to download it from github for use with this tool, be sure to retrieve the raw version. This file is released under the Unlicense, which means you can do anything you want with it.
  • The FindMyPast Github Repository has several real and fictional family trees. I used the Game of Thrones family tree for the sample screenshots to avoid any privacy issues and also to show why it gets complicated when siblings marry one another.

The problems this solves

Main window

Many genealogists working with autosomal DNA add unfamiliar people to their family tree based on DNA matches and then build out those people's lines, hoping to find the most recent common ancestor between the match and themselves. After accumulating thousands of these speculative additions, you often end up looking at a person in your tree and thinking: why is this person here? which DNA match did this branch come from?

Ancestry, Family Tree Maker, and other standard GEDCOM viewers show you a flat list of everyone you've tagged as a DNA match, but none of them will, given an arbitrary person in the tree, walk outward through the relationship graph and tell you the nearest tagged relative. That is the main purpose of this tool.

You can also use this tool to find multiple paths between any two people in your tree and also view individual records from your tree. For example, if your grandfather's maternal cousin married your grandfather's paternal cousin, you will have multiple paths to their descendants. Most applications only show one path; this tool can find as many paths as you like. If you set the application to cast a wide net by setting the "max depth" to a high value, you can discover unexpected links between your relatives. This will take longer to process in a large tree but can yield interesting information.

Any relationship description can be clicked to see a graphical representation of that relationship, which you can then copy and use as you like.

If you set a person as the "Home Person" using the "Set Home" button, the Display Pane will include the path from the selected person to the Home Person in Profile, Matches, and Paths mode.

Finally, if you have a large tree, you may find it difficult to search for specific individuals in other tools. Ancestry, for example, only searches on the person's "preferred name" and not any of the alternate names, and neither Ancestry nor Family Tree Maker allow fuzzy matching searches. Ancestry also does not allow you to easily search on multiple fields simultaneously, like name, location, and occupation. With this tool, you can search for a name with fuzzy matching (e.g. "John Smith" in the "Find:" box) and then further limit the results by a term that appears anywhere in the person's record (e.g. "Chicago" and "tailor" in the "Filter" box). If you have multiple names in a person's record (e.g. maiden name, married name, nicknames), this tool will match any of them. When fuzzy matching is enabled, Hebrew and Cyrillic names also get approximate English-letter aliases generated locally when the GEDCOM is parsed and cached, so they can be found from an English-language keyboard (e.g., searching for "shlomo" should return someone named שְׁלֹמֹה even if their GEDCOM entry lacks any English version of their name; likewise with "Vladimir" for Владимир). This search method avoids the clumsy workarounds people use to label people in their tree, for example, by packing all the person's different surnames into the surname field. You can create a separate "name" record for each name the person has, and then find them easily using this tool's search functionality.

I've also sought to make all actions accessible from the keyboard. See the keyboard shortcuts list for guidance. This makes it very fast to search for and compare people, even in a very large tree.

For more details including the command-line tool, see technical details

License

This application is released under the BSD 2-Clause License.

Recent changes

CHANGELOG

Contributing

Bug reports, feature suggestions, and pull requests are welcome. If you encounter a GEDCOM file whose tag format is not recognized, please open an issue and include the relevant excerpt (with personal names redacted) so the parser can be extended.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gedcom_navigator-1.9.4.tar.gz (15.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gedcom_navigator-1.9.4-py3-none-any.whl (15.2 MB view details)

Uploaded Python 3

File details

Details for the file gedcom_navigator-1.9.4.tar.gz.

File metadata

  • Download URL: gedcom_navigator-1.9.4.tar.gz
  • Upload date:
  • Size: 15.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for gedcom_navigator-1.9.4.tar.gz
Algorithm Hash digest
SHA256 326aa23d27b9fba42e0299e261fa751cf09d158fe47889707609e0d5b8ae7449
MD5 3308875f552d1e5776bf470d0bf9deeb
BLAKE2b-256 a0f9b202165381b5ef1c2262617ee08e6c98372b4bdbfd521809d4373f0cca97

See more details on using hashes here.

File details

Details for the file gedcom_navigator-1.9.4-py3-none-any.whl.

File metadata

File hashes

Hashes for gedcom_navigator-1.9.4-py3-none-any.whl
Algorithm Hash digest
SHA256 42fc53c22d614ca6af8136e14e58f5b42cfd973103e8e5b35e0d9198b0ef31b9
MD5 e59301b9a51f6261586add9fd38e8807
BLAKE2b-256 0e88511a4ffdf596e7677c49b2f69d99e83f72034226a4a3edb529c39f126518

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page