Family Statistics – Release Notes

Version 1.0 – August 27, 2026

Initial public release of Family Statistics for Gramps.

Included

• Statistics page with four sections:
  • On this day
  • Counts
  • Age
  • Names
• Python script that reads four Gramps HTML reports and creates statistics.json.
• Support for a selected Gramps filter together with a person tag containing the same set of persons.
• Dynamic display of the selected tag/filter name.
• English date display on the statistics page.
• Name statistics with percentages and counts.
• Standalone example page with embedded fictional data that can be opened directly without localhost or a web server.
• README with complete instructions for creating the required Gramps reports and viewing the statistics locally.

Required Gramps reports

The project reads these four HTML reports:

• Complete Individual Report → complete.html
• Tag Report → tag.html
• Records report → records.html
• Birthday and Anniversary Report → birthdays.html

Important requirements

• Gramps must be running in English when the reports are created.
• Use YYYY-MM-DD (ISO) as the date format for reports that contain date fields.
• Python 3.x is required.
• The Python package beautifulsoup4 is required.
• The normal statistics page must be opened through localhost or a web server because it loads statistics.json with JavaScript.

Tested on

• Gramps 6.0.8 on Windows 11
• Gramps 6.0.8 on Zorin OS 18.1 Core

macOS has not been tested.