Tree Walk Format (twf): a Flat File Format to Describe Your Family Tree
Posted3 months ago
github.comTechstory
calmneutral
Debate
0/100
Data StorageGenealogyFile Formats
Key topics
Data Storage
Genealogy
File Formats
The Tree Walk Format (TWF) is a proposed flat file format for describing family trees, sparking interest in its potential utility and comparison to existing formats.
Snapshot generated from the HN discussion
Discussion Activity
Light discussionFirst comment
N/A
Peak period
1
Start
Avg / period
1
Key moments
- 01Story posted
Oct 14, 2025 at 1:02 PM EDT
3 months ago
Step 01 - 02First comment
Oct 14, 2025 at 1:02 PM EDT
0s after posting
Step 02 - 03Peak activity
1 comments in Start
Hottest window of the conversation
Step 03 - 04Latest activity
Oct 14, 2025 at 1:02 PM EDT
3 months ago
Step 04
Generating AI Summary...
Analyzing up to 500 comments to identify key contributors and discussion patterns
ID: 45582374Type: storyLast synced: 11/17/2025, 10:06:40 AM
Want the full context?
Jump to the original sources
Read the primary article or dive into the live Hacker News thread when you're ready.
Tree Walk Format (TWF) is a flat file format to describe your family tree. It allows you to describe your family tree in one (or more) files which are editable using your favorite text editor.
I see it as a viable alternative to GUIs such as Gramps or TUIs such as llines(Lifelines).
Currently it is Unix/Linux only since it uses groff/dot to generate the graph depicting the family tree. The git repo has a script that turns the flat file you created into a pdf depicting your family tree. I assume Windows users may be able to use it too using WSL.
It should be possible to generate an equivalent GEDCOM from the TWF input, but that is not implemented yet.
Some additional usage info including examples of family trees from the Bible which are denoted using the TWF format are available at: https://ces.mataroa.blog/blog/twf_ftwmd