🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί GEDCOM Explorer
πŸ¦€ ClawHub

GEDCOM Explorer

by @justinhartbiz

Generate an interactive family tree dashboard from any GEDCOM (.ged) file. Creates a single-file HTML app with 5 tabs (Dashboard, Family Tree, People, Timeline, Daily Alerts), search, person modals, charts, and "On This Day" events. Use when asked to visualize genealogy data, explore family history, build a family tree viewer, or work with GEDCOM files. Triggers on "family tree", "genealogy", "GEDCOM", "ancestors", "family explorer", "family history dashboard".

Versionv1.0.0
Downloads2,248
Installs1
#data#writing#legal#education#gaming
TERMINAL
clawhub install gedcom-explorer

πŸ“– About This Skill

name: gedcom-explorer description: Generate an interactive family tree dashboard from any GEDCOM (.ged) file. Creates a single-file HTML app with 5 tabs (Dashboard, Family Tree, People, Timeline, Daily Alerts), search, person modals, charts, and "On This Day" events. Use when asked to visualize genealogy data, explore family history, build a family tree viewer, or work with GEDCOM files. Triggers on "family tree", "genealogy", "GEDCOM", "ancestors", "family explorer", "family history dashboard".

GEDCOM Explorer

Parse any GEDCOM file and generate a self-contained interactive HTML dashboard.

Quick Start

python3 scripts/build_explorer.py  [output.html] [--title "Title"] [--subtitle "Subtitle"]

Examples

# Basic β€” outputs family-explorer.html in current directory
python3 scripts/build_explorer.py ~/my-family.ged
Custom output path and title

python3 scripts/build_explorer.py ~/my-family.ged ~/Desktop/hart-family.html \
  --title "Hart Family Tree" --subtitle "Six generations of history"
Demo with bundled US Presidents data

python3 scripts/build_explorer.py assets/demo-presidents.ged presidents.html \
  --title "Presidential Family Explorer" --subtitle "US Presidents & Their Ancestors"

Features

  • Dashboard β€” Stats grid (people, families, places, generations), On This Day events, top surnames, geographic origins, people by century, party breakdown (for presidential data)
  • Family Tree β€” Interactive tree visualization with zoom/pan, select any person as root, color-coded by gender/president status
  • People β€” Searchable/filterable directory with gender and president filters, pagination, click for full detail modal
  • Timeline β€” Chronological events (births, deaths, marriages) with filters and search
  • Daily Alerts β€” Today's anniversaries, random ancestor spotlight, fun facts
  • Person Modal β€” Full detail view with parents, spouses, children (all clickable links)
  • Global Search β€” Search across all tabs by name, place, or year

    • How It Works

    build_explorer.py parses the GEDCOM, extracts all individuals + families, computes stats, and embeds everything as inline JSON in a single HTML file. No server needed β€” just open the HTML.

    Auto-detects US Presidents from OCCU (occupation) fields. Works with any GEDCOM; presidential features simply won't appear if no president data exists.

    GEDCOM Sources

    Users can export .ged files from:

  • Ancestry.com β†’ Tree Settings β†’ Export Tree
  • FamilySearch.org β†’ Download GEDCOM
  • MyHeritage β†’ Family Tree β†’ Export β†’ GEDCOM
  • Any genealogy software (Gramps, RootsMagic, Legacy, etc.)

    • Demo Data

    assets/demo-presidents.ged β€” Public domain US Presidents GEDCOM (2,322 people, 1,115 families, 44 presidents). Source: webtreeprint.com.

    Serving Locally

    cd /path/to/output/dir
python3 -m http.server 8899

    Open http://localhost:8899/family-explorer.html

    Extending

    The generated HTML is fully self-contained. To customize:

  • Edit CSS variables in :root for theming
  • The dashboard adapts to whatever data is in the GEDCOM β€” no presidential data required
  • For OpenClaw cron integration: parse GEDCOM daily events and send "On This Day" notifications via Telegram

    • πŸ’‘ Examples

    # Basic β€” outputs family-explorer.html in current directory
python3 scripts/build_explorer.py ~/my-family.ged
    Custom output path and title
    
python3 scripts/build_explorer.py ~/my-family.ged ~/Desktop/hart-family.html \
  --title "Hart Family Tree" --subtitle "Six generations of history"
    Demo with bundled US Presidents data
    
python3 scripts/build_explorer.py assets/demo-presidents.ged presidents.html \
  --title "Presidential Family Explorer" --subtitle "US Presidents & Their Ancestors"