GEDCOM Explorer
Parse any GEDCOM file and generate a self-contained interactive HTML dashboard.
Quick Start
CODEBLOCK0
Examples
CODEBLOCK1
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
INLINECODE0 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
INLINECODE2 — Public domain US Presidents GEDCOM (2,322 people, 1,115 families, 44 presidents). Source: webtreeprint.com.
Serving Locally
CODEBLOCK2
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
GEDCOM 资源管理器
解析任意 GEDCOM 文件并生成自包含的交互式 HTML 仪表盘。
快速开始
bash
python3 scripts/build_explorer.py <输入文件.ged> [输出文件.html] [--title 标题] [--subtitle 副标题]
示例
bash
基础用法 — 在当前目录输出 family-explorer.html
python3 scripts/build_explorer.py ~/my-family.ged
自定义输出路径和标题
python3 scripts/build_explorer.py ~/my-family.ged ~/Desktop/hart-family.html \
--title 哈特家族树 --subtitle 六代家族史
使用内置美国总统数据演示
python3 scripts/build_explorer.py assets/demo-presidents.ged presidents.html \
--title 总统家族探索器 --subtitle 美国总统及其祖先
功能特性
- - 仪表盘 — 统计网格(人口、家庭、地点、世代)、今日事件、热门姓氏、地理起源、世纪人口分布、政党构成(针对总统数据)
- 家族树 — 支持缩放/平移的交互式树状图,可选择任意成员为根节点,按性别/总统身份颜色编码
- 人物 — 可搜索/筛选的人物名录,支持性别和总统筛选器,分页显示,点击查看完整详情弹窗
- 时间线 — 按时间顺序排列的事件(出生、死亡、婚姻),支持筛选和搜索
- 每日提醒 — 今日纪念日、随机祖先亮点、趣味知识
- 人物弹窗 — 完整详情视图,包含父母、配偶、子女(均为可点击链接)
- 全局搜索 — 跨所有标签页按姓名、地点或年份搜索
工作原理
build_explorer.py 解析 GEDCOM 文件,提取所有个人和家庭信息,计算统计数据,并将所有内容以内联 JSON 形式嵌入到单个 HTML 文件中。无需服务器 — 直接打开 HTML 即可使用。
自动从 OCCU(职业)字段检测美国总统。适用于任意 GEDCOM 文件;若无总统数据,总统相关功能不会显示。
GEDCOM 来源
用户可从以下平台导出 .ged 文件:
- - Ancestry.com → 树设置 → 导出树
- FamilySearch.org → 下载 GEDCOM
- MyHeritage → 家族树 → 导出 → GEDCOM
- 任意家谱软件(Gramps、RootsMagic、Legacy 等)
演示数据
assets/demo-presidents.ged — 公共领域美国总统 GEDCOM 文件(2,322 人、1,115 个家庭、44 位总统)。来源:webtreeprint.com。
本地运行
bash
cd /path/to/output/dir
python3 -m http.server 8899
打开 http://localhost:8899/family-explorer.html
扩展定制
生成的 HTML 完全自包含。如需自定义:
- - 编辑 :root 中的 CSS 变量以调整主题
- 仪表盘会根据 GEDCOM 中的数据自动适配 — 无需总统数据
- 用于 OpenClaw 定时任务集成:解析 GEDCOM 每日事件并通过 Telegram 发送今日事件通知