Credential Fixture Review
python scripts/_secrets_inline.py is review material for the GEDCOM Explorer skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials.
GEDCOM Explorer
Parse any GEDCOM file and generate a self-contained interactive HTML dashboard.
Quick Start
python3 scripts/build_explorer.py <input.ged> [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
1---2name: gedcom-explorer-63description: 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".4---56789### Credential Fixture Review1011`python scripts/_secrets_inline.py` is review material for the `GEDCOM Explorer` skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials.1213# GEDCOM Explorer1415Parse any GEDCOM file and generate a self-contained interactive HTML dashboard.1617## Quick Start1819```bash20python3 scripts/build_explorer.py <input.ged> [output.html] [--title "Title"] [--subtitle "Subtitle"]21```2223### Examples2425```bash26# Basic — outputs family-explorer.html in current directory27python3 scripts/build_explorer.py ~/my-family.ged2829# Custom output path and title30python3 scripts/build_explorer.py ~/my-family.ged ~/Desktop/hart-family.html \31 --title "Hart Family Tree" --subtitle "Six generations of history"3233# Demo with bundled US Presidents data34python3 scripts/build_explorer.py assets/demo-presidents.ged presidents.html \35 --title "Presidential Family Explorer" --subtitle "US Presidents & Their Ancestors"36```3738## Features3940- **Dashboard** — Stats grid (people, families, places, generations), On This Day events, top surnames, geographic origins, people by century, party breakdown (for presidential data)41- **Family Tree** — Interactive tree visualization with zoom/pan, select any person as root, color-coded by gender/president status42- **People** — Searchable/filterable directory with gender and president filters, pagination, click for full detail modal43- **Timeline** — Chronological events (births, deaths, marriages) with filters and search44- **Daily Alerts** — Today's anniversaries, random ancestor spotlight, fun facts45- **Person Modal** — Full detail view with parents, spouses, children (all clickable links)46- **Global Search** — Search across all tabs by name, place, or year4748## How It Works4950`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.5152Auto-detects US Presidents from OCCU (occupation) fields. Works with any GEDCOM; presidential features simply won't appear if no president data exists.5354## GEDCOM Sources5556Users can export `.ged` files from:57- **Ancestry.com** → Tree Settings → Export Tree58- **FamilySearch.org** → Download GEDCOM59- **MyHeritage** → Family Tree → Export → GEDCOM60- Any genealogy software (Gramps, RootsMagic, Legacy, etc.)6162## Demo Data6364`assets/demo-presidents.ged` — Public domain US Presidents GEDCOM (2,322 people, 1,115 families, 44 presidents). Source: webtreeprint.com.6566## Serving Locally6768```bash69cd /path/to/output/dir70python3 -m http.server 889971# Open http://localhost:8899/family-explorer.html72```7374## Extending7576The generated HTML is fully self-contained. To customize:77- Edit CSS variables in `:root` for theming78- The dashboard adapts to whatever data is in the GEDCOM — no presidential data required79- For OpenClaw cron integration: parse GEDCOM daily events and send "On This Day" notifications via Telegram
knownasnaffy