Gramps - User contributions [en]

Gramps 6.0 Wiki Manual - Settings

2026-07-21T23:15:19Z

Sam888: /* Setting up the language environment */

{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{#vardefine:chapter|15}}
{{#vardefine:figure|0}}
This section deals with settings you can manage within Gramps either in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog or [[Gramps_6.0_Wiki_Manual_-_Settings#Other_settings|other various settings]]. As well as various ways of [[Gramps_6.0_Wiki_Manual_-_Settings#Customizing|customizing]] Gramps.

== Preferences ==
[[File:EditPreferencesTabsOnly-overview-60.png|center|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all default Preferences tabs]]

Most of the settings affecting the entire Gramps program are configured in the {{man label|Preferences}} dialog. To invoke it, select the menu {{man menu|Edit ➡ Preferences...}} or select the {{man button|[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_Preferences|Open Preferences]]}} icon on the toolbar.

There are overrides that can be set ''before'' running Gramps (such setting the Language shown in the interfaces or for reports) that can be set temporarily or permanently from the [[Gramps_6.0_Wiki_Manual_-_Command_Line|command line interface]].

For configuration options that are limited to the current view or Gramplet set, choose via the menu {{man menu|View ➡ Configure View...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The tabs on the top display the available option categories as follows:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#General|General]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Import|Import]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Text|Text]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Warnings|Warnings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher]]}}

Also ''other'' additional tabs maybe shown from any [[6.0_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== Data ===
[[File:EditPreferences-Data-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab defaults]]
The {{man label|Data}} tab contains preferences relevant to the following two sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Input_Options|Input Options]]}}
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Display Options" section defaults]]
The {{man label|Display Options}} section contains the following options:

*{{checkbox|1}}{{man label|Automate Place format:}} This option controls the display of places. {{man tooltip|Enables automatic place title generation using specified format.}} This feature was labeled as "Enable automatic place title generation" in the 5.0 revision and as "Place format(auto place title)" in the 5.1 revision. The [[Gramps_4.1_Wiki_Manual_-_What%27s_new%3F#Place_hierarchies|hierarchy of Places]] was new in the [[Template:Releases/4.1.0|4.1.0]] revision and the [[Gramps_4.2_Wiki_Manual_-_Settings#Places|Places tab]] of Preferences only existed in the 4.2 version. Major revisions are expected for Place hierarchies so this interfaces is likely to relocated and renamed again.
** '''Full''' (default)
*** Selecting the {{man button|Edit...}} button will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]}}
*{{man label|Coordinates format:}} This option controls the display of Coordinates. (See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]])
** '''DEG Degree,minutes,seconds notation''' (default)
** DEG-: degree, minutes, seconds notation with :
** D.D4 degree notation, 4 decimals
** D.D8 degree notation, 8 decimals (precision like ISO-DMS)
** RT90 Output format for the [https://en.wikipedia.org/wiki/Swedish_grid Swedish coordinate system RT90]
*{{man label|Name format:}} This option controls the display of names in the current database (the setting is saved in the database and is not system wide). In Gramps there are two type of name display formats: the predefined formats, and the user defined custom formats{{man label|Custom name display options are unique to each family tree.}}. Several different predefined name formats are available: '''"Surname, Given Suffix"''' (default), ''"Given Surname Suffix"'', ''"Given"'', ''"Primary[sur] Primary[con] NotPatronymic, Given Patronymic[sur] Suffix Primary[pre]"''
** Clicking on the right hand side {{man button|Edit...}} button will bring up a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}} window where the available list of options is shown. The format is given as well as an example. When predefined formats are not suitable one can define one's own format. You can use the {{man button|Add}} button to add a Name format to the list. Clicking once will give you a '''SURNAME,Given Suffix(call)''' format and as example : '''SMITH, Edwin Jose Sr (Ed)'''. If you added new name formats to the list the {{man button|Remove}} and {{man button|Edit}} buttons become available to change the name format list.
***{{checkbox|0}}{{man label|Consider single pa/matronymic as surname}}: Checkbox unselected by default. If selected enables Gramps to consider patronymic and matronymic names as surnames.

{{man note|1=Besides this database-wide setting|2=Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]]}} dialog}}

*{{man label|Date format *:}} This option controls the display of dates. It is a global setting, requiring a restart of Gramps to take effect, and applies to the display of dates in all databases loaded within Gramps until such time as the date display format is changed again. Several different formats are available, which may be dependent on your locale. {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new date display format}}
** '''YYYY-MM-DD (ISO)''' (default) - Example 2020-09-30 - Displays the date using the international standard [https://wikipedia.org/wiki/ISO_8601 ISO 8601 Data elements and interchange formats – Information interchange] particularly useful when sharing data between countries with different conventions for writing numeric dates and times.
** Numerical
** Month Day, Year
** MON DAY, YEAR
** Day Month Year
** DAY MON YEAR

*{{man label|Age display precision *:}} {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new Age precision format}}
** '''Years''' (default)
** Years, Months
** Years, Months, Days
*{{checkbox|1}}{{man label|Round the year}}
*{{checkbox|1}}{{man label|Display ages for events after death *}} {{man menu|Please note that once changed, it is necessary to restart Gramps to see the change.}}

*{{man label|Calendar on reports:}} '''Gregorian''' (default). This option controls the display of calendar on reports, tools, gramplets, views. Several different calendars are available (see [[Gramps_6.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_1#Editing_dates|Date Edition]]). Two dates with two different calendars will not properly display timeline or period, (e.g. Using the Gregorian calendar as the default displayed calendar, users will have a better coherency for displaying dates on period).
*{{man label|Calendar on input:}} '''Gregorian''' (default).
*{{man label|Show leap day anniversaries:}} '''On the previous day''' (default). {{man tooltip|For non leap years, anniversaries are displayed on either February 28, March 1 or not at all in Gregorian calendars}}

*{{man label|Status bar:}} This option controls the information displayed in the status bar. This can be either the '''[[Gramps_Glossary#active_person|Active Person]]'s name and ID''' (default) or '''Relationship to [[Gramps_Glossary#home_person|home person]]'''.

*{{man label|Citation formatter:}} '''Legacy''' (default). Select from the available plugins for composing and display of Citation data. The built-in "Legacy" [[Addon_list_legend#cite|CITE plugin]] is compatible with versions 5.1.6 and earlier.

===== Place Format Editor =====
[[File:EditPreferences-Data-tab-DisplayOptions-section-PlaceFormatEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place Format Editor - dialog (default) from Menu: "Edit > Preferences..." - "Data" tab "Display Options" section]]

The {{man label|Place Format Editor}} dialog contains preferences relevant to how Places should be shown.

The {{man label|Place Format Editor}} dialog can be accessed from the {{man menu|Edit > Preferences...}} - "Data" tab in the [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]] section via the {{man button|Edit}} button on the {{man label|[] Automate Place Format}} option.

The {{man label|Place Format Editor}} dialog allows you to create custom Place formats by using the {{man button|Add}} button in the left column and choosing how each part of the Place shown should be displayed based on the following settings:

*{{man label|Name:}} <code>New</code> (by default) - A name for the place format strongly suggest you change this to be unique.
*{{man label|Levels:}} <code>:</code> (default colon ":" meaning display all of the place name ) - Select the hierarchy levels of the place names to be displayed.
** Each level in the hierarchy is represented by a positive integer, starting with 0 for the selected place and increasing by 1 for each level up the hierarchy. The levels can also be represented by negative integers, starting with -1 for the top level (usually a country) and decreasing by 1 for each level lower in the hierarchy. In addition, the populated place (city, town, village or hamlet) is represented by the letter p; this can be used with an offset (e.g. p+1 or p-2).
** The names to be displayed are defined as a comma-separated list of ranges. A range can either be a single level, or a start level and an end level separated by a colon. The start level must be less than the end level in a range. The start and end levels default to 0 and -1 if missing.
*{{man label|Street format:}} - Optionally concatenate the number and street in order to suppress the comma.
** '''None''' (default) - Display as is.
** ''Number Street'' - For these options to work, the street must have the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''']] ''Street'' and house number must have the '''Type''' ''Number''.
** ''Street Number'' - as per ''Number Street''
*{{man label|Language:}} (Empty by Default) A [https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes two-digit language code].
*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)

You can remove a custom place format using the {{man button|Remove}} button.

The {{man label|Place Format Editor}} has one pre-defined format named '''Full''' by default.

{{man note|Creates a <code>place_formats.xml</code> file in your Gramps User directory|Not backed up see: [[Template:Backup_Omissions]]}}

See also:
* [https://github.com/gramps-project/gramps/pull/368 Implement place formats #368]
* [[Hierarchical Place Structure]]
* https://gramps-project.org/wiki/index.php/GEPS_045:_Place_Model_Enhancements_-_Place_Changes_Screenshots#Enhanced_Place_Format_Editor
* [https://sourceforge.net/p/gramps/mailman/message/36637553/ (Gramps-users) Proposed place formatting dialogs] From: Nick Hall. - 2019-04-11
* https://sourceforge.net/p/gramps/mailman/message/36422019/
* https://sourceforge.net/p/gramps/mailman/message/36363239/
* https://sourceforge.net/p/gramps/mailman/message/35694337/
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name Editor dialog]]
{{-}}
====== Example Place Formats ======
{{stub}}
The editor has a new field called "levels". It allows users to select hierarchy levels in the place loosely based on the python string slicing syntax. A number of colon ranges can be specified in a comma-separated list. "0" represents the lowest level - typically a building or street. "-1" represents the highest level - typically a country. The populated place is represented as "p".

For example:
"p:" = Populated place upwards.
"p,-1" = Populated place and country.

Valid options:
* <tt>0 - 9</tt> - Hierarchy Level
* <tt>-</tt> - Negative
* <tt>:</tt> - ??
* <tt>p</tt> - Populated Place
* <tt>,</tt> - comma

Place Format examples
* ["p:" = Populated place upwards]
* ["p,-1" = Populated place and country.]
* [1,p House and city],[p,1 City and house]

It lets you restrict long place descriptions in reports and views. [https://github.com/gramps-project/gramps/pull/368#issuecomment-290886087]

{{-}}

=====Display Name Editor=====

{{man note|1=Custom name display formats are stored in the Family Trees|2=Thus before loading any Family Tree the {{man label|Custom format details}} expander is disabled.}}

[[File:EditPreferences-Data-tab-DisplayOptions-section-DisplayNameEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Display Name Editor" - dialog (default) from Menu: "Edit>Preferences..." - "Data" tab > "Display Options" section]]
The {{man label|Display Name Editor}} allows you to define custom name formats, that can be shown on reports and charts at a global level or a per person level.

The {{man label|Display Name Editor}} has two section:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference|Help Reference]]}} section shown at the top
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_list|Display Name list]]}} table section

The {{man label|Display Name Editor}} can be accessed from the menu: {{man menu|Edit>Preferences...}} - {{man label|Data}} tab > {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}} sections {{man label|Name format:}} {{man button|Edit...}} button.
{{-}}
======Help Reference======


Display Name Help Reference:
<hr>
The following keywords are replaced with the appropriate name parts:
* '''Given''' - given name (first name)
* '''Title''' - title (Dr., Mrs.)
* '''Call''' - call name
* '''Initials''' - first letters of Given
* '''Prefix''' - all prefixes (von, de)
* '''Surname''' - surnames (with prefix and connectors)
* '''Suffix''' - suffix (Jr., Sr.)
* '''Nickname''' - nick name
* '''Common''' - nick name as first option if it exists, Call as second option, otherwise first of Given
<hr>
:Surname:
* '''Rest''' - non primary surnames
* '''Familynick''' - family nick name
* '''Primary, Primary[pre] or [sur] or [con]'''- full primary surname, prefix, surname only, connector
* '''Patronymic, or [pre] or [sur] or [con]''' - full pa/matronymic surname, prefix, surname only, connector
* '''Notpatronymic'''- all surnames, except pa/matronymic & primary
* '''Rawsurnames'''- surnames (no prefixes and connectors)
<hr>
{{man menu|UPPERCASE versions of these keywords forces uppercase to be displayed.}} Extra parentheses, commas are removed. Other text appears literally.
<hr>
:'''Example:''' Dr. Edwin Jose von der Smith and Weston Wilson Sr (“Ed”) - Underhills 
:''Edwin Jose'': '''Given''', ''von der'': '''Prefix''', ''Smith'' and ''Weston'': '''Primary''', ''and'': <abbr title="a connector">'''[con]'''</abbr>, ''Wilson'': '''Patronymic''', 
:''Dr.'': '''Title''', ''Sr'': '''Suffix''', ''Ed'': '''Nickname''', ''Underhills'' <abbr title="family nick name">'''Familynick'''</abbr>, Jose <abbr title="called (preferred given name)">'''Call'''</abbr>.
<hr>
{{-}}

======Help Reference Example person======
[[File:NameEditor-format_reference_example-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor's - reference person  shown in the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]] dialog]]

All the fields for the Help Reference '''Example''' person except the Family Nickname can be added in the standard Person Editor dialog. Double-click the Preferred name in Names tab of the Person Editor to access additional fields including: the Family Nick Name, Grouping controls, exception Sorting and Display controls, Date range controls for using a particular name.
{{-}}

======Display Name list======


In this section you can add, remove or edit existing name formats as well as see an example of the formatted name.

Table shows two headings {{man label|Format}} and {{man label|Example}}
* {{man label|Format}} - Based on the name parts shown
* {{man label|Example}} - Displays the name format applied to a ? [[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|builtin reference person]] ?

The List shows four default display name formats they are: 
* ''Surname, Given Suffix'' - displays the name as:
* ''Given Surname Suffix'' - displays the name as:
* ''Given'' - displays the name as: ''Edwin Jose''
* ''xxx''' - displays the name as:

* {{man button|Add}} - a new name format, type the required keywords as needed and press the {{man button|Enter}} key to see the resulting {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|Example]]}}
* {{man button|Remove}} - an existing name format (except for the four default name formats )
* {{man button|Edit}} - an existing name format (except for the four default name formats )
{{stub}}
{{-}}

==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Input Options" section defaults]]

*{{man label|Surname guessing:}} This option affects the initial family name of a child when they are added to the family tree.
** '''Father's surname''' (default) - will use the family name of the father.
** ''None'' - means that no surname guessing will be attempted.
** ''Combination of mother's and father's surname'' - will use the father's name followed by the mother's name.
** ''[https://wikipedia.org/wiki/Icelandic_name Icelandic style]'' - will use the father's given name followed by the "sson" suffix (e.g. the son of Edwin will be guessed as Edwin''sson'').

{{man tip|1=Tip |2=The {{man label|Surname guessing:}} option only affects the initial family name guessed by Gramps when the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog is launched from a {{man label|Family Editor}} window.
You can modify that name any way you see fit. Set this Preferences [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display tab]] option to the value that you will most frequently use, as it will save you a lot of typing.

See:
* [https://gramps-project.org/bugs/view.php?id=1715 feature request to support other local variations for surname guessing]
* [https://wikipedia.org/wiki/Category:Names_by_country Category:Names by country], From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Category:Names_by_language Category:Names by language], From Wikipedia, the free encyclopedia}}

*{{man label|Default family relationship:}} - used by the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Family Editor]]}} dialog.
** '''Unknown''' (default)
** ''Married''
** ''Unmarried''
** ''Civil Union''

*{{checkbox|0}}{{man label|Hide LDS tab in [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS|person]] and [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS_2|family]] editors}}: Latter Days Saints
{{-}}

=== General ===
[[File:EditPreferences-General-tab-EnviromentSettings-section-default-60.png|Right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "General" tab "Environment Settings" section defaults]]

This tab contains one section containing preferences relevant to the general operation of the program.

==== Environment Settings ====
*{{checkbox|0}}{{man label|Display Tip of the Day}}: This checkbox option controls the enabling and disabling of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tip_of_the_Day_dialog|Tip of the Day]]}} dialog at startup. {{man tooltip|Show useful information about using Gramps on startup.}}
*{{checkbox|0}}{{man label|Remember last Family Tree}}: Selecting this checkbox option causes the last used database to load upon start. It bypasses the '''Manage Family Trees''' dialog.
*{{checkbox|0}}{{man label|Remember last view displayed}}: This checkbox option controls the enabling and disabling of the display of the last [[Gramps_Glossary#view|View]]. Enabling will bring you to the view where you stopped the program the last time. {{man tooltip|Remember last view displayed and open it next time.}}
*{{checkbox|0}}{{man label|Enable spell checker}}: This checkbox option controls the enabling and disabling of the global spelling checker for notes. The '''[https://gitlab.gnome.org/GNOME/gspell gspell]''' package must be loaded for this to have an effect.[https://github.com/gramps-project/gramps/pull/1450] ( See: [[Troubleshoot Spellcheck]] ) {{man tooltip|Enable the spelling checker for notes.}} (Note the Edit>preferences option enables global English or the language your Gramps is run in and the note context menu is per note in the selected Language of your choice)

*{{checkbox|1}}{{man label|Show text label beside Navigator buttons *}} ''checked'' (default) This checkbox controls whether or not a text description is displayed next to the icon in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Navigator|Navigator]] in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Main_Window|Main Window]]. This option takes effect after the program has been restarted. {{man tooltip|Show or hide text beside Navigator buttons (People, Families, Events...). Requires Gramps restart to apply.}}

*{{checkbox|1}}{{man label|Show Clipboard icon on toolbar}}
*{{checkbox|1}}{{man label|Show Reports icon on toolbar}}
*{{checkbox|1}}{{man label|Show Tools icon on toolbar}}
*{{checkbox|1}}{{man label|Show Addons icon on toolbar}}
*{{checkbox|1}}{{man label|Show Preferences icon on toolbar}}
*{{man label|Toolbar Style:}} {{man tooltip|Display text, icons or both on the toolbar buttons.}}
** '''Both text and icons''' (default)
** ''Text only''
** ''Icons only''
*{{checkbox|1}}{{man label|Show close button in gramplet bar tabs}} ''checked''(default) {{man tooltip|Show close button to simplify removing gramplets from bars.}}

*{{man label|Markup for invalid date format:}} Default: <code>%s</code>
** Convenience markups are:
*** Bold (Default)
*** <big><big>Makes font relatively larger</big></big>
*** Italic
*** <s><s>Strikethrough</s></s>
*** Subscript
*** Superscript
*** Makes font relatively smaller
*** <tt><tt>Monospace font</tt></tt>
*** Underline
**** For example: %s will display Underlined bold date.

*{{man label|Multiple surname box height:}} Default: <code>150</code> Pixels {{man tooltip|Enter height in pixels. When multiple surnames are entered, these names display in a box. This setting sets the size of this box.}}

====Tip of the Day dialog====

[[File:TipOfTheDay-dialog--example-PrivacyInGramps-60.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog - example]]

When enabled in {{man menu|Edit > Preferences}} {{man label|General}} tab the {{man label|Tip of the Day}} dialog shows helpful hints.

The following options are available:
*{{checkbox|1}} {{man label|Display on startup}} (check box checked by default - once enabled) - uncheck to stop further tips appearing.
*{{man button|Forward}} - Advance to the next tip.
*{{man button|Close}} - exit for this session until the Gramps program is restarted.
[[Category:Tips]]

{{-}}

=== Family Tree ===
[[File:EditPreferences-FamilyTree-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - defaults]]
The {{man label|Family Tree}} tab contains the following four sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Location|Database Location]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a family tree]] - more information on backups
* [[Template:Backup_Omissions|Backup omissions]] - what is not included during a backup
{{-}}
====Database Settings====
[[File:EditPreferences-FamilyTree-tab-DatabaseSetting-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Settings" section defaults]]

*{{man label|Database backend:}} -
** '''[[Gramps_Glossary#sqlite|SQLite]]''' (''default'') - the [[DB-API Database Backend]]
** When multiple database backends are installed, they will be included in this list. <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr> backends: [[Addon:PostgreSQL|PostgreSQL]], SharedPostgreSQL, MongoDB. This menu can be trimmed by 'hiding' the unwanted database backends in the Plugin Manager.

{{man tip|Converting Trees from the retired BSDDB backend|The BSDDB backend developed incompatibilities as Python libraries evolved. That backend choice (as ''default'') was supseded with SQLite in Gramps 5.2 and has been retired (to read-only status) as of the Gramps 6.0 release. Although BSDDB '''''was''''' the default backend default in Gramps 2.0 through Gramp 5.1, all Gramps Trees should be converted another database backend at the earliest opportunity. '''[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Make a backup]] before any critical change.''' To convert a Tree, first select the target database backend in Preferences, then use the '''Convert''' button for the selected tree in the '''Family Tree ‐> Manage Family Trees''' dialog.}}

See also:
* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds experimental support for PostgreSQL databases. Recommended for Experts only!

{{-}}

====Database Location====
[[File:EditPreferences-FamilyTree-tab-DatabaseLocation-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Location" section defaults]]
*{{man label|Host:}} - Server address or other computer IP address for the location of the database.
*{{man label|Port:}} - Port number to access the Host database
*{{man label|Database path:}} Unless you have a definite reason to change this, stay with the default path. The default path where databases are stored is <code>grampsdb</code> within the [[Gramps_6.0_Wiki_Manual_-_User_Directory|User Directory]].
{{-}}

====Backup Management====
[[File:EditPreferences-FamilyTree-tab-BackupManagement-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Backup Management" section defaults]]
*{{man label|Backup path:}} - Location in which to save your Gramps backup archive files.
*{{checkbox|1}}{{man label|Backup on exit}} - Selecting this option will Backup Your family tree upon choosing to exit Gramps. The file be saved to the Backup path specified above. The filename of the backup will match the Family Tree appended with a date and time.
*{{man label|Autobackup:}} timer interval for triggering full backups during Gramps editing sessions.
** '''Never''' (''default'')
** Every 15 minutes
** Every 30 minutes
** Every hour
** Every 12 hours
** Every day
{{-}}

====Family Tree's Media path====
[[File:EditPreferences-FamilyTree-tab-FamilyTreesMediaPath-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Family Tree's Media path" section defaults]]
*{{man label|Base media path:}} Here you can fill in a base path for the media objects.
** Selecting the {{man button|Directory}} button gives you a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Select_media_directory_dialog|Select media directory]]}} dialog where you can fill in the required path.

{{man tip|The base relative media path is specific to the active family tree.|It is not a global setting in Gramps. Each family tree is able to have a unique media base path that is stored with the database.}}

{{man tip|To make media paths relative|You also need to select the {{man label|[ ] Convert to a relative path}} checkbox, at the bottom of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_a_media_object_selector|Select a media object selector]]}} dialog. Once checked for the first time it will be remembered for each subsequent media selection.}}

See also:
*[[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|{{man label|Gramps Media Manager}}]] a group of four separate tools two of which allow you to:
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}

{{-}}
=====Select media directory dialog=====

{{stub}}

See [[Gramps_6.0_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}

=====Missing Media Objects 'broken link' icon of a box with a red 'x'=====
[[File:BrokenMediaPath-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media object with a broken filepath]]

If the Preview thumbnails displays 'broken link' icon of a box with a red 'x' you will need to correct {{man label|Base media path:}} for your family tree in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section.

See also:
* Example.gramps - [[Example.gramps#Connecting_to_the_example_Media_Objects|Connecting to the example Media Objects]]
* [[Addon:Media_Verify_Tool|Media Verify Tool]] addon tool for revalidating media paths
{{-}}
{{stub}}

=== Import ===
[[File:EditPreferences-Import-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Import" - tab - defaults]]
The {{man label|Import}} tab has two sections as follows:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tag_Records|Tag Records]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Source_GEDCOM_import|Source GEDCOM import]]}}

==== Tag Records ====

*{{checkbox|0}}{{man label|Add tag on import}}: Checkbox (Default: <code>Imported %Y/%m/%d %H:%M:%S</code> ) ''' {{man tooltip|Specified tag will be added on import. Clear to set default value.}} Note - Adding a timestamped [[Gramps_Glossary#tag|Tag]] on import can significantly slow down the importing of your data, but are helpful for the ensuing data cleanup.'''

==== Source GEDCOM import ====

*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_import|GEDCOM data]]. If this is set, each item that is imported will contain a [[Gramps_Glossary#source|Source]] reference to the imported file. '''Note - Adding a default source can significantly slow down the importing of your GEDCOM data, but are helpful for the ensuing data cleanup.'''

{{-}}

=== Limits ===
[[File:EditPreferences-Limits-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Limits" - tab - defaults]]

Settings used for calculation operations of dates, ages and generations.

See also:
* [[Gramps 6.0 Wiki Manual - Probably Alive]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_dates|Editing dates]]
* Setting the [[Match_dates#Changing_after.2Fbefore.2Fabout_range|date approximation .ini]] manually

==== Calculation limits ====

*{{man label|Date 'about' year range: (date ± #):}} Default: <code>50</code>
** Defines the number of years +/- of the event date "<code>about <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'after' year range: (date + #):}} Default: <code>50</code>
** Defines the number of years after the event date "<code>after <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'before' year range: (date - #):}} Default: <code>50</code>
** Defines the number of years before the event date "<code>before <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Maximum age probably alive:}} Default: <code>110</code>
** Absent a Death event, the age by which Gramps will consider the person is no longer alive.
*{{man label|Maximum sibling age difference:}} Default: <code>20</code>
*{{man label|Minimum years between generations:}} Default: <code>13</code>
*{{man label|Average years between generations:}} Default: <code>20</code>
*{{man label|Max generations for relationships:}} You can enter the number of generations used to determine relationships. The default value is '''<code>15</code>'''. Limits the scope of features based on the [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
{{-}}

=== Colors ===
[[File:EditPreferences-Colors-tab-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - defaults]]

This tab has seven section related to allowing you to set the '''colors used for boxes in the graphical views'''.

Each of the colors can be customized using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]}}.

==== Colors used for boxes in the graphical views ====

You can select the
* {{man label|Color scheme:}}
** '''Light colors''' (default)
** ''Dark colors''
*** {{man button|Restore to defaults}} - restores themes default colors.

====Colors for Male persons====
* {{man label|Background for Alive:}} [ ] #b8cee6
* {{man label|Border for Alive:}} [ ] #1f4986
* {{man label|Background for Dead:}} [ ] #b8cee6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Female persons====
* {{man label|Background for Alive:}} [ ] #feccf0
* {{man label|Border for Alive:}} [ ] #861f69
* {{man label|Background for Dead:}} [ ] #feccf0
* {{man label|Border for Dead:}} [ ] #000000

====Colors for people who are neither male nor female====
* {{man label|Background for Alive:}} [ ] #94ef9e
* {{man label|Border for Alive:}} [ ] #2a5d16
* {{man label|Background for Dead:}} [ ] #94ef9e
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Unknown persons====
* {{man label|Background for Alive:}} [ ] #f3dbb6
* {{man label|Border for Alive:}} [ ] #8e5801
* {{man label|Background for Dead:}} [ ] #f3dbb6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Family nodes====
* {{man label|Default background:}} [ ] #eeeeee
* {{man label|Default border:}} [ ] #cccccc
* {{man label|Background for Married:}} [ ] #eeeeee
* {{man label|Background for Unmarried:}} [ ] #eeeeee
* {{man label|Background for Civil Union:}} [ ] #eeeeee
* {{man label|Background for Unknown:}} [ ] #eeeeee
* {{man label|Background for Divorced:}} [ ] #eeeeee
* {{man label|Border for Divorced:}} [ ] #ff7373

====Other colors====
* {{man label|Background for Home Person:}} [ ] #bbe68a
{{-}}

=== Genealogical Symbols ===
{{stub}}
{{man warn|Prerequisites exist for this feature|The Genealogical Symbols tab can only be used if the [[#Prerequisite_to_use_Genealogical_Symbols|prerequisite]] program <code>[[#Prerequisite_to_use_Genealogical_Symbols|python-fontconfig]]</code> is present that Gramps can use.}}

[[File:EditPreferences-GenealogicalSymbols-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Genealogical Symbols" - tab - defaults]]

Allows you to use Genealogical symbols instead of text abbreviations in reports, charts and the Gramps interface.

This tab gives you the possibility to use one font which is able to show all genealogical symbols. (Once configured see: [[#Prerequisite_to_use_Genealogical_Symbols|Prerequisite to use Genealogical Symbols]])

If you select the "{{man label|Use symbols}}" checkbox, Gramps will use the selected font if it exists.

This can be useful if you want to add phonetic in a note to show how to pronounce a name or if you mix multiple languages like Greek and Russian.

You can only configure the death symbol from this tab.

:List of Genealogical Symbols shown (listed in order shown at bottom of screenshot):

* Female
* Male
* Asexuality, sexless, genderless
* Lesbianism
* Male homosexuality
* Heterosexuality
* Transgender, hermaphrodite (in entomology)
* Transgender
* Neuter

* Illegitimate
* Birth
* Baptism/Christening
* Engaged
* Marriage
* Divorce
* Unmarried partnership
* Buried
* Cremated/Funeral urn
* Killed in action
* Extinct

* Death

{{-}}

{| class="wikitable"
|-
! meaning
! symbol
! Unicode code point(s)
! name
|-
! male
| ♂
| U+2642
| Male Sign
|-
! female
| ♀
| U+2640
| Female Sign
|-
! unknown
| ⚪︎
| U+26AA
| Medium White Circle
|-
! hermaphrodite
| ⚥
| U+26A5
| Interlocked Male and Female Sign
|-
! neuter
| ⚲
| U+26B2
| Neuter

|-
! birth
| *
| U+002A
| Asterisk
|-
! baptisation, christening
| ~
| U+007E
| Tilde
|-
! death
| ✝︎
| U+271D
| Latin Cross
|-
! burial
| ⚰︎
| U+26B0
| Coffin
|-
! cremation
| ⚱︎
| U+26B1
| Funeral Urn
|-
! stillborn
| ✝︎*
| U+0086 U+002A
| Latin Cross, Asterisk
|-
! born illegitimately
| *⃝
| U+002A U+20DD
| Circled Asterisk
|-
! born illegitimately
| ⊛
| U+229B
| Circled Asterisk Operator
|-
! killed in action
| ⚔︎
| U+2694
| Crossed Swords
|-
! this line extinct
| ‡
| U+2021
| Double Dagger
|-
! approximate(ly)
| ±
| U+00B1
| Plus-Minus
|-
! before
| <
| U+003C
| Less-Than Symbol
|-
! after
| >
| U+003E
| Greater-Than Symbol

|-
! engaged
| ⚬
| U+26AC
| Medium Small White Circle
|-
! married
| ⚭
| U+26AD
| Marriage Symbol
|-
! divorced
| ⚮
| U+26AE
| Divorce Symbol
|-
! unmarried
| ⚯
| U+26AF
| Unmarried Partnership Symbol
|}
{{-}}
====Prerequisite to use Genealogical Symbols====
{{stub}}
[[File:EditPreferences-GenealogicalSymbols-tab-default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences tab - defaults]]

=====Initial setup=====

If the fontconfig [[Gramps_6.0_Wiki_Manual_-_Settings#Prerequisite|prerequisite has been installed]], then on the {{man label|Genealogical Symbols}} tab select the {{man button|Try to find}} button, Gramps will attempt to detect any suitable unicode text fonts that can be used.

[[File:EditPreferences-GenealogicalSymbols-FindFont-51.png|center|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Finding fonts]]

When the search has completed select one of the fonts from the {{man button|Choose font}} list and then select the checkbox:

{{checkbox|1|Use symbols}}

=====Prerequisite=====
Prerequisite : '''python-fontconfig''' : Python bindings of fontconfig and its dependencies are required for displaying genealogical symbols
{{man note|Use the [[Addon:Prerequisites_Checker_Gramplet|Prerequisites Checker]]|Do you have <code>python-fontconfig</code> installed? Run the Prerequisites Checker Addon and look for something similar to the following line:<pre>* python-fontconfig 0.5.0 (Success version 0.5.x is installed.)</pre>}}

See also:
* Tamura Jones expounds on [https://www.tamurajones.net/GenealogySymbols.xhtml Genealogical Symbols] ''(the 'Unicode' section is particularly relevant)''
* [[GEPS 039: Genealogical symbols in gramps]]
* Feature request: {{bug|9098}} Gramps should be able to use genealogy symbols everywhere.
* [[Customize the Genealogical Symbols lookup table]] located in the [[Gramps_6.0_Wiki_Manual_-_User_Directory#MS_Windows|Gramps user directory]] at: [https://github.com/gramps-project/gramps/blob/maintenance/gramps51/gramps/gen/utils/symbols.py gramps\gen\utils\symbols.py]
{{-}}

=== ID Formats ===
{{man tip|ID Prefixes |The ID prefixes use formatting conventions common for C, Python, and other programming languages. For example, the <code>%04d</code> expands to an integer, prepended with zeros to have the total width of four digits. If you would like IDs to be 1, 2, 3, etc., simply set the formatting parameter to <code>%d</code>, the 'd' specifies Decimal Integer, outputting the number in base 10. See: Python [https://docs.python.org/3/library/string.html#format-specification-mini-language (String) Format Specification Mini-Language]}}

[[File:EditPreferences-IDFormats-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "ID Formats" - tab - defaults]]

This tab contains preferences relevant to the automatic generation of Gramps IDs.

*{{man label|Person:}} Provides the template for generating IDs for a Person. Default value: <code>I%04d</code>
*{{man label|Family:}} Provides the template for generating IDs for a Family. Default value: <code>F%04d</code>
*{{man label|Place:}} Provides the template for generating IDs for a Place. Default value: <code>P%04d</code>
*{{man label|Source:}} Provides the template for generating IDs for a Source. Default value: <code>S%04d</code>
*{{man label|Citation:}} Provides the template for generating IDs for a Citation. Default value: <code>C%04d</code>
*{{man label|Media Object:}} Provides the template for generating IDs for a Media Object. Default value: <code>O%04d</code>
*{{man label|Event:}} Provides the template for generating IDs for an Event. Default value: <code>E%04d</code>
*{{man label|Repository:}} Provides the template for generating IDs for a Repository. Default value: <code>R%04d</code>
*{{man label|Note:}} Provides the template for generating IDs for a Note. Default value: <code>N%04d</code>

You can use the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}

=== Text ===

[[File:EditPreferences-Text-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Text" - tab - defaults]]

This tab contains one section {{man label|Conditional Text Replacements}} with preferences relevant to how missing and private names and records should be shown.

==== Conditional Text Replacements ====

*{{man label|Missing surname:}} in the input field you can determine how a missing surname should be displayed. Default value is '''<code>[Missing Surname]</code>'''. You can change this to [--] or whatever is most convenient for you.
*{{man label|Missing given name}} in the input field you can determine how a missing given name should be displayed. Default value is '''<code>[Missing Given Name]</code>'''. You can change this to whatever you want.
*{{man label|Missing record:}} Default: <code>[Missing Record]</code>
*{{man label|Private surname:}} Default: <code>[Living]</code>
*{{man label|Private given name:}} Default: <code>[Living]</code>
*{{man label|Private record:}} Default: <code>[Private Record]</code>
{{-}}

=== Warnings ===
[[File:EditPreferences-Warnings-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]

This tab has one section {{man label|Warnings and Error dialogs}} that controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.

See the [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
==== Warnings and Error dialogs ====
*{{checkbox|0}}{{man label|Suppress warning when adding parents to a child.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_adding_parents_to_a_child|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning when cancelling with changed data.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_cancelling_with_changed_data|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning about missing researcher when exporting to GEDCOM.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_about_missing_researcher_when_exporting_to_GEDCOM|Dialog]])
*{{checkbox|0}}{{man label|Suppress tooltip warnings about data being saved immediately.}} Checkbox unchecked by Default
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])
{{-}}

=== Researcher ===
{{man tip|Researcher Information|This contact information is independent of the family trees you create. Most exports and reports will be filtered to protect the privacy of living people of the Tree... including yourself. This information feeds into the authoring and citation features of any publication (or archival) options.}}
[[File:EditPreferences-Researcher-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Researcher" - tab - defaults]]

Allows you to {{man label|Enter your information so people can contact you when you distribute your Family Tree}} in the corresponding text entry fields. Although Gramps requests information about you, this information is used only so that Gramps can create valid GEDCOM output files. A valid GEDCOM file requires information about the file's creator. If you choose, you may leave the information empty, however none of your exported GEDCOM files will be valid.

The available text entry fields are (all blank by default):
*{{man label|Name:}}
*{{man label|Address:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

The information entered under this preference acts as default value for family tree specific values that can be adjusted with the {{man menu|Tools->Family Tree Processing->[[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information...]]}}.
{{-}}

== Other settings ==

Besides {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog, there are other settings available in Gramps. For various reasons they have been made more readily accessible, as listed below.
{{-}}
===Columns editor===

{{man tip|The {{man label|Columns}} editor is available and works in the same way for all list views.|Specifically, it is available for People View, Family View (children list). Sources View, Citations View, Places View, Media View, Repositories View and the Notes View.}}

[[File:ColumnsEditorTab-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Columns''' editor tab - dialog - People Tree View default columns]]

The columns of the list views may be added, removed, or reordered in a {{man label|Columns}} editor dialog.

To use the {{man label|Columns}} editor dialog for the current view, choose via the menu {{man menu|View ➡ Configure...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

Only columns with a selected checkbox will be shown in the view. You can also change the position of a column in the View by clicking and dragging it to a new position in the Editor ([https://wikipedia.org/wiki/Drag-and-drop ''drag and drop'']). Once you have made the changes you want click {{man button|Apply}}, then click {{man button|OK}} to exit the Editor and see your changes in the View.

By default, the View List, displays several columns of information about the respective category. You can add or remove columns to and from the display

The default sort key for the view [always ascending] is the left-most field [i.e. at the top in the Columns Editor], so changing which field is in that position affects default sorting. For some views the first field cannot be changed and the reason will be mentioned at the top of the Columns editor.

The {{man label|Columns Editor}} dialog will have a different selection of columns for each category of View that displays a simple table.

Changes will only be enacted when the {{man button|Apply}} button is clicked.

Once the View columns changes have been applied, clicking once on the column header sorts in ascending order, clicking again sorts in descending order.

The subset of columns and the current [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] will also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|Export View...]]}} operation. Hidden columns and records will not be exported.
{{-}}

=== Sorting columns ===

[[File:PersonView-PeopleListView-example-with-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Before''' - default sort by "Name" column "People" Category - "Person" (List) View]]

[[File:PeopleCategory-PeopleListView-SortedByBirthDateColumn-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''After''' - Sorted by "Birth Date" column in the list mode of the People Category View - example]]

By default, each Category View presenting data in a columnated table layout will sort the rows in ascending order based on the data in the first (left-most) column. If the table has grouped rows, the grouped data will be sub-sorted. ''(Tables in tabbed subsets of data, Editors and Selectors will work similarly.)''

Click once on a different column header to sort on the data of that column in ascending order. Click the header again to sort in reverse order.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]]}} dialog can be used to add, remove and rearrange the displayed columns. Choosing a different first column will make that the new default sorting column of the view [though always ascending].
{{-}}

===Setting Home person===
[[File:MenuEdit-SetHomePerson-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu showing ''Set Home Person'']]

To set (designate) the [[Gramps_Glossary#home_person|Home person]], select the People Category and select the desired person to make them into the [[Gramps_Glossary#active_person|Active Person]] and then choose {{man menu|Edit ->Set Home Person}} via the menus.

Alternately, when editing any Person, right-clicking on inactive areas (areas without a text-entry box) of the top section displays a pop-up menu which includes an option to {{man menu|Make Home Person}} of that profile.

The Home person is the persistently designated person who becomes the [[Gramps_Glossary#active_person|Active Person]] when one of the following occurs:
*By default, when the Family tree database is opened ''(The [[Gramps_6.0_Wiki_Manual_-_Settings#General_Gramps_settings|General]] setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]] can modify this default behavior. The "Remember last view displayed" will return to the last [[Gramps_Glossary#active_person|Active Person]] of the previous session.)''
*As the toolbar {{man button|Home}} button is clicked
*When the Home menu item is selected from either the {{man button|Go}} menu or the right-click context menu in selected views
*As the [[Gramps_6.0_Wiki_Manual_-_Keybindings#15|keybinding]] {{Man key press|ALT|Home}} is pressed to return to the '''Home Person'''.

The toolbar {{man button|Home}} button is available in the People Category, Relationships Category, and Charts Category. [[File:Gramps Go-Home48x48 win.png|text-bottom]]
====See also====
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Home_Person|Setting the Home Person]]
{{-}}

===Adjusting viewing controls===

Whether the toolbar, the sidebar, or the filter (not available on Charts and Relationships Views) are displayed in the main window is adjusted through the View menu.

In the different views clicking the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Navigation#View|View]]}} menu will shows for boxes you can click:
*Navigator
*Toolbar
*Sidebar
*Bottombar
*Full Screen {{man key press|F11}}

Additionally, depending on the view you are in, other options will be available on {{man label|Configure}}.

*Gramplets:
**Set Columns to 1
**Set Columns to 2
**Set Columns to 3
*Relationships:
**Show Siblings
**Show Details
*Geography:
**Time period
**Layout

All other Views: the [[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]].

===Export View===

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - "Family Trees" - overview example showing "Export View" menu entry]]

On most [[Gramps_6.0_Wiki_Manual_-_Categories#Categories_of_the_Navigator|Category List Views]], displayed data maybe be exported, choose via the {{man menu|Family Trees ->Export View...}} [[Gramps_6.0_Wiki_Manual_-_Navigation#Main_Menus|menu]] command.

This Menu command only appears if the displayed data can be exported. Gramps will export data on screen according your choice: '''CSV''' or '''Open Document''' spreadsheet format.

Note that the current configuration of the View's columns will control what data will be exported. The export will contain only the displayed column data (in the same order) and be limited to records matching any [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] you have applied.

Use the Views [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect]] tab control the type of CSV to be created.
{{-}}
====Export View as Spreadsheet dialog====

[[File:ExportViewAsSpreadsheet-CSV-file-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Export View as Spreadsheet" CSV(default) filetype - dialog - example]]

Gramps will then display the {{man label|Export View as Spreadsheet}} dialog where after choosing a file location to save to and a name for your file; export data on from the Category List View in one of two spreadsheet formats:
*{{man label|Formats:}}
** '''CSV''' (default)
** '''OpenDocument Spreadsheet''' - ODS format.

{{-}}
[[File:ExportViewAsSpreadsheet-ODS-Displayed-in-LibreOfficeCalc-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Example ODS Spreadsheet - Displayed in LibreOffice Calc]]

The example screenshot shows an export to the '''OpenDocument Spreadsheet''' (ODS format) displayed as a Spreadsheet in LibreOffice Calc.

{{-}}

====CSV Dialect====
[[File:CSV-Dialect-Tab-dialog-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "CSV Dialect" tab - dialog - example]]

All list table views have a {{man label|CSV Dialect}} tab in the dialog for the {{man menu|View -> Configure...}} menu. You can choose the CSV format's delimiter to be used when exporting and importing data in Gramps.

''Choose your dialect'' from:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_Dialect|excel]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_tab_Dialect|excel-tab]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Unix_Dialect|unix]]}}
*{{man label|Custom}}
**{{man label|Delimiter:}}
*** ',' ''comma'' (default)
*** ';' ''semicolon''
*** ':' ''colon''
*** '|' ''bar''
*** 'tab'

CSV stands for '''[https://wikipedia.org/wiki/Comma-separated_values comma-separated values]'''. It is a plain text file format that separate data into columns and rows for simple way to exchange data. Originally, data was limited by being separated into columns by fixed positions in <code>.txt</code> text files. When more flexibility was needed, the comma was chosen as a delimiter to mark the boundaries of the columns and the <code>.csv</code> format of a text file was established. To complicate matters, different Operating System marked their end-of-line and end-of-file with different terminating codes.

When comma was needed too frequently in the data itself, a <code>.tsv</code> (tab-separated-values) file format became popular. When other delimiters began being adopted, rather than use up more file extensions, CSV became synonymous with any text format with delimiter marked columns. They were just different 'dialects' of "CSV".

[https://docs.python.org/3/library/csv.html Python's <code>csv</code> module] provides several pre-defined dialects to simplify reading and writing CSV files. These dialects specify rules for parsing and formatting data. The standard dialects include {{man label|excel}}, {{man label|excel-tab}}, and {{man label|unix}}. The following sections outline each dialect's characteristics, including its separator, line terminator, and quoting behavior.

===== Excel Dialect =====

The {{man label|excel}} dialect is designed to be compatible with CSV files generated by Microsoft Excel. It is suitable for data that has been saved from Excel as comma-separated values.
*Separator:** Comma (<code>,</code>`)
*Line Terminator: Carriage return and line feed (<code>\r\n</code>)
*Quoting:
** Double quotes (<code>"</code>`) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Excel-tab Dialect =====

The {{man label|excel-tab}} dialect is similar to the `excel` dialect but uses tabs instead of commas as the separator. This format is often encountered when copying cell data from Excel to the OS clipboard. Pasting tab separated data into the [[Addon:Import_Text_Gramplet|Import Text]] addon gramplet is one of the quickest way to populate parts of your tree.

* Separator: Tab (<code>\t</code>)
* Line Terminator: Carriage return and line feed (<code>\r\n</code>)
* Quoting:
** Double quotes (<code>"</code>) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Unix Dialect =====

The {{man label|unix}} dialect is designed for use in Unix-like environments. It uses a line feed character as the line terminator and always quotes all fields.

* Separator: Comma (<code>,</code>)
* Line Terminator: Line feed (<code>\n</code>)
* Quoting:
** All fields are enclosed in double quotes (<code>"</code>).
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== See also: =====
* [https://github.com/gramps-project/gramps/pull/1314 CSV: possibility to select the dialect. #1314 ]
{{-}}

===Modularity and plugins===


Gramps has been designed for expansion. The Plugin (a.k.a. Plug-in, addon, extension) framework provides a path for third party development outside the normal Gramps release distributions.

The documentation for each addon is maintained outside the flow of these main wiki chapters. The interface and functionality of the software and documentation may not conform with the styles seen throughout the rest of Gramps... although we encourage Developers to try to make their additions as seamless as possible.

A brief description and screenshot of each addon can be found in the [[6.0_Addons#Addon_List|Addon List]] section of the wiki manual. The separately maintained documentation page for the addon is linked from the 1st column of that list.

See [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[6.0 Addons|Third-Party Addons]].
{{-}}

===Customize report output formats===
[[File:TextReports-DocumentOptions-section-PlainText-output-settings-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Options - tab defaults for Text Reports (Plain Text - output selected) example]]

What kind of output customization is available? This dialog allows you to change the fonts, font sizes, font color, background color of the text and alignment of paragraphs on the report.

For most report dialogs, in the top part are option tabs specifically related that particular report. The lower part will have more broadly reusable features and is called the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Document_Options|Document Options]]}} section.

From the {{man label|Style:}} drop down list you can choose an existing custom style. Or to make your own {{man label|Style:}} select the {{man button|Style Editor...}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Document_Styles_dialog|Document Styles]]}} dialog and then select the {{man button|Add a new style}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.

{{stub}}
{{-}}
====Document Styles dialog====

[[File:DocumentStyles-dialog-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Styles - dialog - default]]

The {{man label|Document Styles}} dialog, list the ''default'' style and any custom styles for that report and allows you to edit or delete any custom styles you have created. Select the {{man button|+ (Add a new style)}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}

====Style editor dialog====
[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

The {{man label|Style editor}} dialog allow you to customize the document style specific to each report.

Change the {{man label|Style sheet name:}} <code>New Style</code> (default) field to a unique name as it will appear in {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Document_Options|Document Options]]}} {{man label|Style:}} drop down list.

Once changes for your custom style have been finalized select the {{man button|OK}} button to save the changes or {{man button|Cancel}} to exit.

=====Style editor dialog tabs=====
On the left hand side you will see the {{man label|Style}} column that list the paragraph options specific to that report that you may modify. For example the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report]]}} shows the style options for <code>AHN-Entry</code>, <code>AHN-Generation</code> and <code>AHN-Title</code>.

On the right hand side are three tabs associated with each style listed in the left hand column:
* [[#Description|Description]]
* [[#Font_options|Font options]]
* [[#Paragraph_options|Paragraph options]]

{{-}}
======Description======

[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

*{{man label|Description}} tab describes what each paragraph is all about. For example shown here is the style used for the Ahnentafel Report ( <code>AHN-Entry</code> ) with the description: ''The basic style used for the text display.''
{{-}}

======Font options======

[[File:StyleEditor-dialog-FontOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Font options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Font options}} tab allows you to set the {{man label|Type face}} ''Roman'' or ''Swiss'', the {{man label|Size}} of the font in pt.(point), the {{man label|Color}} of the font and some {{man label|Options}} like ''Bold'', ''Italic'' or ''Underline''.
{{-}}

======Paragraph options======

[[File:StyleEditor-dialog-ParagraphOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Paragraph options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Paragraph options}} tab allows you to set the {{man label|Alignment}}, the {{man label|Background color}}, {{man label|Indentation}}, {{man label|Spacing}} and {{man label|Borders}} of your style.
{{-}}

===Context menu===
[[File:Clipboard-dialog-example-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clipboard - with example contextual pop-up menu from right-clicking a Family]]
[[Gramps_6.0_Wiki_Manual_-_Main_Window#Pop-up_menus|Pop-up menus]] are used in various places in Gramps; how you access the context menu is dependent on your operating systems:
* On Microsoft windows, you generally use the right button of your mouse to show the context menu or use the keyboard shortcut {{man button|Shift}}+{{man button|F10}}. see [https://docs.microsoft.com/en-us/previous-versions/windows/desktop/mpc/using-context-menus Using Context Menus - Microsoft Docs]
* On Apple macOS, you generally press {{man button|Ctrl}} while clicking the button of your mouse to show the context menu. see: [https://developer.apple.com/design/human-interface-guidelines/macos/menus/contextual-menus/ Contextual Menus - Menus - macOS - Human Interface Guidelines - Apple Developer]

List of known Context menus in Gramps:
* Pedigree View Context menus
* Clipboard context menu
* File Chooser - Context Menu options
* <Category view> context menus
* Manage Books dialog 
* ... and many more
{{stub}}

See also:
* [[Gramps 6.0 Wiki Manual - Keybindings|Keybindings]]

=== Selector dialogs ===
[[File:SelectFamily-SelectorDialog-example-60.png|450px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]] - showing Search Bar]]


Selector dialogs are a combo interface box and you generally use then to select an object (Person/Family/Events etc). Also various {{man label|Selectors}} also have search bars:
* [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Event_selector|Select Event selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Note_selector|Select Note selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Person_selector|Select Person selector]]
*[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Select_a_person_for_the_report_selector|Select a person for the report selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Father_selector|Select Father selector]] (filtered to Father)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Mother_selector|Select Mother selector]] (filtered to Mother)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Child_selector|Select Child selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Media_Object_selector|Select Media Object selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Place_selector|Select Place selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Repository_selector|Select Repository selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_or_Citation_selector|Select Source or Citation selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_selector|Select Source selector]]

{{-}}
See also
* [https://gramps-project.org/wiki/index.php/GEPS_041:_New_Selector GEPS_041:_New_Selector]
* [[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]

{{stub}}

== Customizing ==
Here are some ways that you can customize Gramps.
=== Preferences ===

In the "Display Options" section of the Edit>Preferences {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}} tab you can select the Name format used by default throughout Gramps. The Edit button for the {{man label|Name format:}} opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}}, allowing the creation of user-defined (custom) stylings beyond the pre-defined (built-in) name format choices.

See [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]

The Edit button for a person's preferred and alternative names opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Name Editor]]}}, allowing the selection of a name format exceptions that will override the format chosen in the Display tab of Preferences for the entire Tree.

The name format, grouping and sorting can be overridden for selected individuals and surnames. The Edit Person dialogs have two Edit buttons to access this feature. The button for Preferred name is to the right of the Suffix field. However, for any selected Name (Preferred or Alternative) in the Names tab which opens the Name Editor. The built-in and custom Display Name formats can be selected exceptions to "Group as:" and "Sort as:" options that default to the Name format selected in Preferences.

=== Pick a Color selector ===
The [[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]] tab of the Preferences allows customizing of the color of various elements of diagrams in the Charts category's graphical views.

==== Color Palette ====
[[File:PickAColor-selector-dialog-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - palette selector dialog]]
Select a color from the 45 [[Gramps_Glossary#swatch|swatches]] in predefined color palette area. Or select from the recently used {{man label|Custom}} color swatches. Or click the {{man button|+}} button to create your own custom color. Right-click on any swatch to add another custom color and open the gradient selector.

You can drag any color swatch to any swatch in the preference (or configure) dialog.

{{-}}
==== Color Gradient ====
[[File:PickAColor-gradient-dialog-52.png|right|thumb|436px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - gradient selector dialog]]
The gradient selector dialog is for adjust the [[Gramps_Glossary#swatch|color swatch]] at the top of the dialog. Once changed, either click the {{man button|Select}} button to apply the color. Drag the single gradient dialog swatch to any swatch in the preference (or configure) dialog.

Specific colors of the swatch can be changed in several ways:
* via direct entry 'color Hex color code'
* the hue slider (with a numeric fine control
* mouse left-click in the 1-dimensional (hue) rainbow gradient or the 2-dimensional (brightness and saturation) hue gradient.
* mouse right-click in either gradient to show the numeric control for the dimension(s) of the gradient
* mouse left-click on the eyedropper color picker to choose from any pixel shown on the monitor(s)
{{-}}

=== File Chooser ===
[[File:FileChooser_Bookmarks_Breadcrumbs.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Linux GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs mac.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} macOS GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs win.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Windows GTK File Chooser: highlighting breadcrumbs and bookmarking]]
The Open and Save dialogs (File Chooser) for Gramps are based on the [https://docs.gtk.org/gtk3/iface.FileChooser.html GTK File Chooser]. Each operating system has expected behaviors for clicks, double-clicks, sorting, [[Gramps_6.0_Wiki_Manual_-_Keybindings#Handy_Shortcuts|keybindings]], environmental variables, and standard file locations that are characteristic of File Chooser dialogs native to the operating system. A few of these can be customized via the user interface to feel more similar to the OS native File Choosers. However, the idiosyncrasies of various OSes mean shared network folders and URI support may not be as readily browsed as when using the OS native File Choosers.

The [https://developer-old.gnome.org/gtk4/stable/GtkFileChooser.html GtkFileChooser] allows for adding quick navigation hotlinks to commonly used places of the filesystem. In the default implementation, these are displayed in the left sidebar navigation pane. It may be a bit unclear at first that these shortcuts come from various sources and in various flavors, so let's explain the terminology here:
* '''[[#Bookmarking_file_folders|Bookmarks]]''': are created by the user, by dragging folders from the right pane to the left pane, or by using the “Add”. Bookmarks can be renamed and deleted by the user.
* '''Shortcuts''': can be provided by the Gramps application. For example, program may want to add a shortcut for a Downloads or Documents folder. Shortcuts ''cannot'' be added or removed by the user. The 'Rename...' context menu option allows them to be relabeled.
* '''Volumes''': are provided by the underlying filesystem abstraction. They are the “roots” of the filesystem. The Home and Downloads hotlinks are common "roots". Volumes cannot be modified by the user.

====File Chooser context menus====
Right-click on any file or folder in the current directory to open context pop-up menu with the following options:
<hr>
*{{man menu|Open With File Manager}}
<hr>
*{{man menu|Copy Location}}
*{{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Bookmarking_file_folders|Add to Bookmarks]]}}
<hr>
*{{man menu|❏ Show Hidden Files}}
*{{man menu|☑ Show Size Column}}
*{{man menu|☑ Show Type Column}}
*{{man menu|❏ Show Time}}
*{{man menu|❏ Sort Folders before Files}}
<hr>

Right-click in the navigation sidebar to open context pop-up menu with the following options:
<hr>
*{{man menu|Open}}
*{{man menu|Remove}}
*{{man menu|Rename...}}
<hr>

====Breadcrumbs and text-entry address bar====
By default, the file folder navigation in the File Chooser is by browsing. There are also some shortcuts on the left and breadcrumbs (highlighted in green in the dialog illustration) for quick navigation up and down the path.

Optionally, a text-entry address bar can be used to directly key-in or paste a path. Toggle between displaying breadcrumbs and the text-entry address bar with the {{Man key press|CTRL|L}} [[Gramps_6.0_Wiki_Manual_-_Keybindings|keybinding]].

====Bookmarking file folders====
File folder bookmarks can be user defined to make finding standard locations easier. These bookmarks are remembered between sessions and regardless of which Family Tree has been loaded.

With any Open or Save dialog open, navigate to the file location containing the folder to be bookmarked. Create the bookmark by either: dragging the folder icon to the navigation column on the left; or, right-clicking that folder to use the {{Man menu|Add to Bookmarks}} context menu option.

Right-clicking an existing Bookmark allows renaming that bookmark or removing it.

====File Formats====
Support for several file formats are built into the standard distribution of Gramps. Import plugin and Export Plugin Addons can be installed via the Plugin Manager or Preferences to expand the options.

See the [[Output_formats|Output Format]] article for list of file formats.

====See also====
* [https://ubuntugenius.wordpress.com/2010/05/14/how-to-show-text-entry-address-bar-or-breadcrumbs-navigation-buttons-in-nautilus-after-ubuntu-10-04-upgrade/ How to Show Text-Entry Address Bar or “Breadcrumbs” (Navigation Buttons)] in Nautilus After Ubuntu 10.04 Upgrade

*Discourse discussions about the GTK File Chooser:
** [https://gramps.discourse.group/t/need-suggestions-for-documenting-the-gtk-file-chooser/1820/8 Documenting the File Chooser in the wiki]
** [https://gramps.discourse.group/t/macos-and-windows-gtk-file-chooser-dialog-capture-request/3364 Illustrating the File Chooser in the Wiki]
** [https://gramps.discourse.group/t/can-i-cause-folders-to-sort-to-the-top-of-the-list-when-presented-with-the-folder-contents/1708/14 File Chooser: Sorting files and folders]
* [https://discourse.gnome.org/t/where-is-the-filechooser-feature-list/9101/1 Where is the FileChooser feature list?]

=== Language ===

Gramps has been translated into a number of [[Portal:Translators|languages]]. Usually Gramps automatically starts in your local language, as chosen for other applications, but sometimes this may not be right for you. And in other cases, a module or addon will not yet have been translated and a warning dialog will appear saying something like “Warning: plugin XYZ has no translation for any of your configured languages, using US English instead”. (Note that the US dialect of English is the default rather than British.) This can become annoying or intrusive.

The most idealistic situation is that you are as fluent in US English as the language selected for the operating system GUI on your computer. And that you would take the opportunity to translate that Gramps feature for users who are non-English speakers.

If your system is configured to show a language other then English, you can override this for Gramps.

As an example, assume that a computer in the Netherlands is configured to default to Unicode 8 Dutch: "LANG: nl_NL.UTF-8". You could either reset the OS language

In Windows, use the SET command to change the LANG environment variable to "en_GB.UTF-8" for British English. You can do this from the command line interface or [https://gramps-project.org/bugs/view.php?id=11009 create a startup shortcut with the following Target]:
<code>C:\Windows\System32\cmd.exe /c "SET LANG=en_GB.UTF-8 && START /D ^"C:\Program Files\GrampsAIO64-6.0.5^" gramps.exe"</code>

{{stub}} '''{{man warn|tbd|Describe for each main platform how the normal language is determined and how the user can [[Howto:Change_the_language_of_reports#Run_Gramps_in_a_different_language|choose a different language]].'''}}

==== Linux ====
{{stub}}

If you want to choose a locale 'variant' for sorting that is not the default variant, then you can start Gramps from the terminal (or console) with a different LC_COLLATE environment. For example, the default sorting (collation) variant for Swedish is "reformed", but you can instead choose "standard" by typing:
export LC_COLLATE="sv_SE.UTF-8@collation=standard"
python Gramps.py

==== macOS ====

For macOS see [[Mac_OS_X:Application_package#Advanced_setup|Advanced setup]] for details on how the language is normally chosen, and how to choose a special, non-default setting for the language, the sorting order or the format of such things as day and month names and number separators.

==== MS Windows ====
[[File:MicrosoftWindowGrampsAIO-Installer-ChooseComponents-Selection-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps 6.0.3 AIO 64 bit for Microsoft Windows installer - "Choose Components" page showing selection of the "de"( German) Translation]]
If you want to run Gramps in another language other than English using the Gramps AIO installer, then you must select it during installation process.

Otherwise it will not be available.

More information can be found at [[Installing_Gramps_for_Windows_computers#Missing_other_languages]] page.

{{-}}

===Add Windows OS Menu Item===
[[File:Edit-Target-GrampsAIO64-Properties-Danish-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for Danish shortcut example.]]

To make Gramps work in your selected language (See table below for your [[Gramps_6.0_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:
* Using your mouse right button click on the "{{man label|GrampsAIO64 6.x.x}}" icon on Desktop and from menu choose: {{man label|Copy}}.
* Right click anywhere on Desktop and from menu choose: {{man label|Paste shortcut}}
* New icon will be created with name: "{{man label|GrampsAIO64 6.x.x (2)}}"
* Right click on that and from menu choose: {{man label|Properties}}
* A new window will open, click on first tab called {{man label|General}} and change text from "{{man label|GrampsAIO64 6.x.x (2)}}" to something more descriptive like: "{{man label|GrampsAIO Danish}}"
** Click on second tab called {{man label|Shortcut}}, change text in first entry called {{man label|Target}} from (note path will vary depending on Gramps version used):
***<code>"C:\Program Files\GrampsAIO64-6.x.x\grampsw.exe"</code> to:
***<code>%comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"</code>
* Click {{man label|OK}}

Now when you click on that icon Gramps will start in Danish.

{{-}}
{{man tip|You can download a zip file attached to feature request:{{bug|13204}} Gramps AIO64 X.x.x Language icons Shortcuts Pack ( for the languages shown in the [[#Language_codes|Language codes]] table below)}}
{{-}}

===Change the windows LANG variables===
Another option if you want Gramps to always load in say: French Canadian language, you can go to Windows > System Properties, and add the LANG variable in the user section of the environment variables dialog with the appropriate Value.

The value to add is:
<pre>
Name: LANG
Value: fr_CA.UTF-8
</pre>

* [https://www.redswitches.com/blog/environment-variables/#method-1-set-environment-variables-through-the-gui How to Set Environment Variables in Windows 10]

===Language codes===
Select from the following table of [[Portal:Translators|languages Gramps]] has been translated into:

{| {{prettytable}}
!Language
!ISO code
!Example
!Notes
|-
| English-USA (Default)
| en_US.UTF-8
| %comspec% /c set LANG=en_US.UTF-8 && start grampsw.exe"
|
|-
| English (British)
| en_GB.UTF-8
| %comspec% /c set LANG=en_GB.UTF-8 && start grampsw.exe"
|
|-
| Finnish
| fi.UTF-8
| %comspec% /c set LANG=fi.UTF-8 && start grampsw.exe"
|
|-
| Russian
| ru_RU.UTF-8
| %comspec% /c set LANG=ru_RU.UTF-8 && start grampsw.exe"
|
|-
| Albanian
| sq_AL.UTF-8
| %comspec% /c set LANG=sq_AL.UTF-8 && start grampsw.exe"
|
|-
| German
| de_DE.UTF-8
| %comspec% /c set LANG=de_DE.UTF-8 && start grampsw.exe"
|
|-
| French
| fr_FR.UTF-8
| %comspec% /c set LANG=fr_FR.UTF-8 && start grampsw.exe"
|
|-
| French Canadian
| fr_CA.UTF-8
| %comspec% /c set LANG=fr_CA.UTF-8 && start grampsw.exe"
|
|-
| Macedonian
| mk_MK.UTF-8 ???
|
|
|-
| Nederlands (Dutch)
| nl_NL.UTF-8
| %comspec% /c set LANG=nl_NL.UTF-8 && start grampsw.exe"
|
|-
| Dutch
| nl_BE.UTF-8
| %comspec% /c set LANG=nl_BE.UTF-8 && start grampsw.exe"
|
|-
| Slovak
| sk_SK.UTF-8
| %comspec% /c set LANG=sk_SK.UTF-8 && start grampsw.exe"
|
|-
| Hebrew
| he_IL.UTF-8
| %comspec% /c set LANG=he_IL.UTF-8 && start grampsw.exe"
|
|-
| Danish
| da_DK.UTF-8
| %comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"
|
|-
| Greek
| el_GR.UTF-8
| %comspec% /c set LANG=el_GR.UTF-8 && start grampsw.exe"
|
|-
| Italian
| it_IT.UTF-8
| %comspec% /c set LANG=it_IT.UTF-8 && start grampsw.exe"
|
|-
| Esperanto
| eo.UTF-8 ???
|
|
|-
| Chinese (Simplified)
| zh_CN.UTF-8
| %comspec% /c set LANG=zh_CN.UTF-8 && start grampsw.exe"
|
|-
| Chinese (Hong Kong)
| zh_HK.UTF-8 ???
|
|
|-
| Chinese (Traditional)
| zh_TW.UTF-8
| %comspec% /c set LANG=zh_TW.UTF-8 && start grampsw.exe"
|
|-
| Ukrainian
| uk_UA.UTF-8
|
|
|-
| Portuguese
| pt_PT.UTF-8
| %comspec% /c set LANG=pt_PT.UTF-8 && start grampsw.exe"
|
|-
| Portuguese (Brazil)
| pt_BR.UTF-8
| %comspec% /c set LANG=pt_BR.UTF-8 && start grampsw.exe"
|
|-
| Afrikaans
| af_ZA.UTF-8
|
|
|-
| Norwegian Bokmål
| nb_NO.UTF-8
| %comspec% /c set LANG=nb_NO.UTF-8 && start grampsw.exe"
|
|-
| Norwegian Nynorsk
| nn_NO.UTF-8
| %comspec% /c set LANG=nn_NO.UTF-8 && start grampsw.exe"
|
|-
| Turkish
| tr_TR.UTF-8
| %comspec% /c set LANG=tr_TR.UTF-8 && start grampsw.exe"
|
|-
| Spanish
| es_ES.UTF-8
| %comspec% /c set LANG=es_ES.UTF-8 && start grampsw.exe"
|
|-
| Polish
| pl_PL.UTF-8
| %comspec% /c set LANG=pl_PL.UTF-8 && start grampsw.exe"
|
|-
| Slovenian
| sl_SI.UTF-8
| %comspec% /c set LANG=sl_SI.UTF-8 && start grampsw.exe"
|
|-
| Japanese
| ja_JP.UTF-8
| %comspec% /c set LANG=ja_JP.UTF-8 && start grampsw.exe"
|
|-
| Arabic (Saudi Arabia)
| ar_SA.UTF-8
| %comspec% /c set LANG=ar_SA.UTF-8 && start grampsw.exe"
|
|-
|
|
|
|
|-
|
|
|
|
|}
*The language codes are two-letter lowercase ISO language codes (such as "da") as defined by [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1].
*The country codes are two-letter uppercase ISO country codes (such as "BE") as defined by [https://en.wikipedia.org/wiki/ISO_3166-1 ISO 3166-1].

===Setting up the language environment===

{{stub}} 



====Window====

More information can be found at [[Installing_Gramps_for_Windows_computers#Missing_other_languages]] page.

===Advanced manipulation of settings===
{{stub}}

{{man warn| Warning ** Make sure you have closed Gramps **|The contents of this section is outside the scope of interest of a general user of Gramps. If you proceed with tweaking the options on the low level you may damage your Gramps installation. Be careful. '''YOU HAVE BEEN WARNED!'''}}

Besides the settings available in Preferences, you may also wish to explore the advanced settings.

Gramps uses '''[https://en.wikipedia.org/wiki/INI_file#Keys_(properties) INI keys]''' and [https://en.wikipedia.org/wiki/INI_file#Sections INI sections] for managing user preferences and program settings these are stored in the text file <code>gramps.ini</code> under the <code>.gramps/gramps[XX]</code> folder in your home or user directory.

The <code>gramps.ini</code> file has following sections:
* [behavior] : typical Key names are: [https://github.com/gramps-project/gramps/blob/master/gramps/gui/grampsgui.py#L502 betawarn], enable-autobackup, use-tips...
* [colors] :
* [csv] :
* [database] : related to database settings for the Family Tree.
* [export] : export and import folders/directories
* [geography] :
* [interface] : a lot of keys regarding height and width of the different Views: e.g. event-height: 450, event-ref-height: 585, event-ref-width: 728, event-width: 712...
* [paths] : keys related to recent imported files and folders/directories
* [plugin] :
* [preferences] : keys related to preferences: all the common prefixes , todo -colors..
* [researcher] : all information regarding the researcher
* [spacing] :
* [test] :
* [utf8] :

====Example <code>gramps.ini</code> file====
Example contents of the <code>gramps.ini</code> file:


<pre>
;; Gramps key file
;; Automatically created at 2025/05/24 08:49:41

[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0
;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps60', True]]
;;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps60'
;;autoload=0
;;avg-generation-gap=20
;;check-for-addon-update-types=['new']
;;check-for-addon-updates=0
;;date-about-range=50
;;date-after-range=50
;;date-before-range=50
;;do-not-show-previously-seen-addon-updates=1
;;generation-depth=15
;;immediate-warn=0
;;last-check-for-addon-updates='1970/01/01'
;;max-age-prob-alive=110
;;max-sib-age-diff=20
;;min-generation-years=13
;;owner-warn=0
;;pop-plugin-status=0
;;previously-seen-addon-updates=[]
;;recent-export-type=3
;;runcheck=0
;;spellcheck=0
;;startup=0
;;surname-guessing=0
translator-needed=0
;;use-tips=1
;;web-search-url='https://google.com/search?q=%(text)s'
;;welcome=100

[colors]
;;border-family=['#cccccc', '#252525']
;;border-family-divorced=['#ff7373', '#720b0b']
;;border-female-alive=['#861f69', '#261111']
;;border-female-dead=['#000000', '#000000']
;;border-male-alive=['#1f4986', '#171d26']
;;border-male-dead=['#000000', '#000000']
;;border-other-alive=['#2a5f16', '#26a269']
;;border-other-dead=['#000000', '#000000']
;;border-unknown-alive=['#8e5801', '#8e5801']
;;border-unknown-dead=['#000000', '#000000']
;;family=['#eeeeee', '#454545']
;;family-civil-union=['#eeeeee', '#454545']
;;family-divorced=['#ffdede', '#5c3636']
;;family-married=['#eeeeee', '#454545']
;;family-unknown=['#eeeeee', '#454545']
;;family-unmarried=['#eeeeee', '#454545']
;;female-alive=['#feccf0', '#62242D']
;;female-dead=['#feccf0', '#3a292b']
;;home-person=['#bbe68a', '#304918']
;;male-alive=['#b8cee6', '#1f344a']
;;male-dead=['#b8cee6', '#2d3039']
;;other-alive=['#94ef9e', '#285b27']
;;other-dead=['#94ef9e', '#062304']
;;scheme=0
;;unknown-alive=['#f3dbb6', '#75507B']
;;unknown-dead=['#f3dbb6', '#35103b']

[csv]
;;delimiter=','
;;dialect='excel'

[database]
;;autobackup=0
;;backend='sqlite'
;;backup-on-exit=1
;;backup-path='C:\\Users\\[username]'
;;compress-backup=1
;;host=''
;;path='C:\\Users\\[username]\\AppData\\Roaming\\gramps\\grampsdb'
;;port=''

[export]
;;proxy-order=[['privacy', 0], ['living', 0], ['person', 0], ['note', 0], ['reference', 0]]

[geography]
;;center-lat=0.0
;;center-lon=0.0
;;lock=0
;;map_service=1
;;path=''
;;personal-map=''
;;show_cross=0
;;use-keypad=1
;;zoom=0
;;zoom_when_center=12

[interface]
dbmanager-height=370
;;dbmanager-horiz-position=12
;;dbmanager-vert-position=85
;;dbmanager-width=780
;;dont-ask=0
;;filter=0
;;fullscreen=0
;;grampletbar-close=1
;;hide-lds=0
;;ignore-gexiv2=0
;;ignore-osmgpsmap=0
;;ignore-pil=0
;;main-window-height=500
;;main-window-horiz-position=15
;;main-window-vert-position=10
;;main-window-width=775
;;mapservice='OpenStreetMap'
;;open-with-default-viewer=0
;;pedview-layout=0
;;pedview-show-images=1
;;pedview-show-marriage=0
;;pedview-show-unknown-people=0
;;pedview-tree-direction=2
;;pedview-tree-size=5
;;place-name-height=100
;;place-name-width=450
;;sidebar-text=1
;;size-checked=0
;;statusbar=1
;;surname-box-height=150
;;tipofday-height=350
tipofday-horiz-position=-49
tipofday-vert-position=84
;;tipofday-width=550
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-style=0
;;toolbar-tools=1
;;treemodel-cache-size=1000
;;view=1
;;view-categories=['Dashboard', 'People', 'Relationships', 'Families', 'Ancestry', 'Events', 'Places', 'Geography', 'Sources', 'Citations', 'Repositories', 'Media', 'Notes']

[paths]
;;quick-backup-directory='C:\\Users\\[username]'
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'
;;recent-export-dir='C:\\Users\\[username]'
;;recent-file=''
;;recent-import-dir='C:\\Users\\[username]'
;;report-directory='C:\\Users\\[username]'
;;website-cal-uri=''
;;website-cms-uri=''
;;website-directory='C:\\Users\\[username]'
;;website-extra-page-name=''
;;website-extra-page-uri=''

[plugin]
;;addonplugins=[]
;;hiddenplugins=[]

[preferences]
;;age-after-death=1
;;age-display-precision=1
;;age-rounded-year=1
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-legacy'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;default-source=0
;;eprefix='E%04d'
;;family-relation-type=3
;;family-warn=0
;;february-29=0
;;fprefix='F%04d'
;;hide-ep-msg=0
;;invalid-date-format='%s'
;;iprefix='I%04d'
last-view='dashboardview'
last-views=['dashboardview', '', '', '', '', '', '', '', '', '', '', '', '']
;;name-format=1
;;no-given-text='[Missing Given Name]'
;;no-record-text='[Missing Record]'
;;no-surname-text='[Missing Surname]'
;;nprefix='N%04d'
;;online-maps=0
;;oprefix='O%04d'
;;paper-metric=0
;;paper-preference='Letter'
;;patronimic-surname=0
;;place-auto=1
;;place-format=0
;;pprefix='P%04d'
;;private-given-text='[Living]'
;;private-record-text='[Private Record]'
;;private-surname-text='[Living]'
;;quick-backup-include-mode=0
;;rprefix='R%04d'
;;sprefix='S%04d'
;;tag-on-import=0
;;tag-on-import-format='Imported %Y/%m/%d %H:%M:%S'
;;use-last-view=0

[researcher]
;;researcher-addr=''
;;researcher-city=''
;;researcher-country=''
;;researcher-email=''
;;researcher-locality=''
;;researcher-name=''
;;researcher-phone=''
;;researcher-postal=''
;;researcher-state=''

[spacing]
dbman=[22.605613425925927, 5.877459490740741, 9.856047453703704]

[test]
;;january='January'

[utf8]
;;baptism-symbol='~'
;;birth-symbol='*'
;;buried-symbol='[]'
;;cremated-symbol='⚱'
;;dead-symbol='✝'
;;death-symbol=2
;;divorce-symbol='o|o'
;;engaged-symbol='o'
;;in-use=0
;;killed-symbol='x'
;;marriage-symbol='oo'
;;partner-symbol='o-o'
;;selected-font=''
</pre>

====Advanced backup filename setting====
You can also define the naming pattern for the backup filename by setting the ''<code>paths.quick-backup-filename</code>'' in the <code>~/.gramps/gramps60/gramps.ini</code> key file like the following:
{{-}}
[paths]
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'

by removing the two semicolons(<code>;;</code>) from the front of INI key line and using use any of the following keywords for the filename pattern:
*filename
*year
*month
*day
*hour
*minutes
*seconds
*extension :
**'''.gpkg'''(default) if you include media.
**''.gramps'' if you exclude media.

Use the appropriate ~/.gramps/gramps{XX}/gramps.ini key file.
*Gramps version 6.0 :
~/.gramps/gramps60/gramps.ini

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Command_Line#Configuration_.28config.29_option]]
* [[Install_latest_BSDDB#Make_Gramps_use_bsddb3]]
* [[Customize_the_Genealogical_Symbols_lookup_table#Genealogy_symbols_preferences]]

===Theme===
The look of Gramps can be changed.

* [[Addon:ThemePreferences|Addon:Theme Preferences]]
* [[Windows_AIO_themes]]
* [[GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme|GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion]]
* [[Overrule_Gramps_Icons]] - for older Gramps versions.
* [[UI style]]

Some reports can also be changed:

* [[Website report Themes]]
{{-}}
{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

Gramps 6.0 Wiki Manual - Settings

2026-07-21T23:14:06Z

Sam888: /* Setting up the language environment */

{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{#vardefine:chapter|15}}
{{#vardefine:figure|0}}
This section deals with settings you can manage within Gramps either in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog or [[Gramps_6.0_Wiki_Manual_-_Settings#Other_settings|other various settings]]. As well as various ways of [[Gramps_6.0_Wiki_Manual_-_Settings#Customizing|customizing]] Gramps.

== Preferences ==
[[File:EditPreferencesTabsOnly-overview-60.png|center|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all default Preferences tabs]]

Most of the settings affecting the entire Gramps program are configured in the {{man label|Preferences}} dialog. To invoke it, select the menu {{man menu|Edit ➡ Preferences...}} or select the {{man button|[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_Preferences|Open Preferences]]}} icon on the toolbar.

There are overrides that can be set ''before'' running Gramps (such setting the Language shown in the interfaces or for reports) that can be set temporarily or permanently from the [[Gramps_6.0_Wiki_Manual_-_Command_Line|command line interface]].

For configuration options that are limited to the current view or Gramplet set, choose via the menu {{man menu|View ➡ Configure View...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The tabs on the top display the available option categories as follows:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#General|General]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Import|Import]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Text|Text]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Warnings|Warnings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher]]}}

Also ''other'' additional tabs maybe shown from any [[6.0_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== Data ===
[[File:EditPreferences-Data-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab defaults]]
The {{man label|Data}} tab contains preferences relevant to the following two sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Input_Options|Input Options]]}}
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Display Options" section defaults]]
The {{man label|Display Options}} section contains the following options:

*{{checkbox|1}}{{man label|Automate Place format:}} This option controls the display of places. {{man tooltip|Enables automatic place title generation using specified format.}} This feature was labeled as "Enable automatic place title generation" in the 5.0 revision and as "Place format(auto place title)" in the 5.1 revision. The [[Gramps_4.1_Wiki_Manual_-_What%27s_new%3F#Place_hierarchies|hierarchy of Places]] was new in the [[Template:Releases/4.1.0|4.1.0]] revision and the [[Gramps_4.2_Wiki_Manual_-_Settings#Places|Places tab]] of Preferences only existed in the 4.2 version. Major revisions are expected for Place hierarchies so this interfaces is likely to relocated and renamed again.
** '''Full''' (default)
*** Selecting the {{man button|Edit...}} button will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]}}
*{{man label|Coordinates format:}} This option controls the display of Coordinates. (See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]])
** '''DEG Degree,minutes,seconds notation''' (default)
** DEG-: degree, minutes, seconds notation with :
** D.D4 degree notation, 4 decimals
** D.D8 degree notation, 8 decimals (precision like ISO-DMS)
** RT90 Output format for the [https://en.wikipedia.org/wiki/Swedish_grid Swedish coordinate system RT90]
*{{man label|Name format:}} This option controls the display of names in the current database (the setting is saved in the database and is not system wide). In Gramps there are two type of name display formats: the predefined formats, and the user defined custom formats{{man label|Custom name display options are unique to each family tree.}}. Several different predefined name formats are available: '''"Surname, Given Suffix"''' (default), ''"Given Surname Suffix"'', ''"Given"'', ''"Primary[sur] Primary[con] NotPatronymic, Given Patronymic[sur] Suffix Primary[pre]"''
** Clicking on the right hand side {{man button|Edit...}} button will bring up a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}} window where the available list of options is shown. The format is given as well as an example. When predefined formats are not suitable one can define one's own format. You can use the {{man button|Add}} button to add a Name format to the list. Clicking once will give you a '''SURNAME,Given Suffix(call)''' format and as example : '''SMITH, Edwin Jose Sr (Ed)'''. If you added new name formats to the list the {{man button|Remove}} and {{man button|Edit}} buttons become available to change the name format list.
***{{checkbox|0}}{{man label|Consider single pa/matronymic as surname}}: Checkbox unselected by default. If selected enables Gramps to consider patronymic and matronymic names as surnames.

{{man note|1=Besides this database-wide setting|2=Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]]}} dialog}}

*{{man label|Date format *:}} This option controls the display of dates. It is a global setting, requiring a restart of Gramps to take effect, and applies to the display of dates in all databases loaded within Gramps until such time as the date display format is changed again. Several different formats are available, which may be dependent on your locale. {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new date display format}}
** '''YYYY-MM-DD (ISO)''' (default) - Example 2020-09-30 - Displays the date using the international standard [https://wikipedia.org/wiki/ISO_8601 ISO 8601 Data elements and interchange formats – Information interchange] particularly useful when sharing data between countries with different conventions for writing numeric dates and times.
** Numerical
** Month Day, Year
** MON DAY, YEAR
** Day Month Year
** DAY MON YEAR

*{{man label|Age display precision *:}} {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new Age precision format}}
** '''Years''' (default)
** Years, Months
** Years, Months, Days
*{{checkbox|1}}{{man label|Round the year}}
*{{checkbox|1}}{{man label|Display ages for events after death *}} {{man menu|Please note that once changed, it is necessary to restart Gramps to see the change.}}

*{{man label|Calendar on reports:}} '''Gregorian''' (default). This option controls the display of calendar on reports, tools, gramplets, views. Several different calendars are available (see [[Gramps_6.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_1#Editing_dates|Date Edition]]). Two dates with two different calendars will not properly display timeline or period, (e.g. Using the Gregorian calendar as the default displayed calendar, users will have a better coherency for displaying dates on period).
*{{man label|Calendar on input:}} '''Gregorian''' (default).
*{{man label|Show leap day anniversaries:}} '''On the previous day''' (default). {{man tooltip|For non leap years, anniversaries are displayed on either February 28, March 1 or not at all in Gregorian calendars}}

*{{man label|Status bar:}} This option controls the information displayed in the status bar. This can be either the '''[[Gramps_Glossary#active_person|Active Person]]'s name and ID''' (default) or '''Relationship to [[Gramps_Glossary#home_person|home person]]'''.

*{{man label|Citation formatter:}} '''Legacy''' (default). Select from the available plugins for composing and display of Citation data. The built-in "Legacy" [[Addon_list_legend#cite|CITE plugin]] is compatible with versions 5.1.6 and earlier.

===== Place Format Editor =====
[[File:EditPreferences-Data-tab-DisplayOptions-section-PlaceFormatEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place Format Editor - dialog (default) from Menu: "Edit > Preferences..." - "Data" tab "Display Options" section]]

The {{man label|Place Format Editor}} dialog contains preferences relevant to how Places should be shown.

The {{man label|Place Format Editor}} dialog can be accessed from the {{man menu|Edit > Preferences...}} - "Data" tab in the [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]] section via the {{man button|Edit}} button on the {{man label|[] Automate Place Format}} option.

The {{man label|Place Format Editor}} dialog allows you to create custom Place formats by using the {{man button|Add}} button in the left column and choosing how each part of the Place shown should be displayed based on the following settings:

*{{man label|Name:}} <code>New</code> (by default) - A name for the place format strongly suggest you change this to be unique.
*{{man label|Levels:}} <code>:</code> (default colon ":" meaning display all of the place name ) - Select the hierarchy levels of the place names to be displayed.
** Each level in the hierarchy is represented by a positive integer, starting with 0 for the selected place and increasing by 1 for each level up the hierarchy. The levels can also be represented by negative integers, starting with -1 for the top level (usually a country) and decreasing by 1 for each level lower in the hierarchy. In addition, the populated place (city, town, village or hamlet) is represented by the letter p; this can be used with an offset (e.g. p+1 or p-2).
** The names to be displayed are defined as a comma-separated list of ranges. A range can either be a single level, or a start level and an end level separated by a colon. The start level must be less than the end level in a range. The start and end levels default to 0 and -1 if missing.
*{{man label|Street format:}} - Optionally concatenate the number and street in order to suppress the comma.
** '''None''' (default) - Display as is.
** ''Number Street'' - For these options to work, the street must have the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''']] ''Street'' and house number must have the '''Type''' ''Number''.
** ''Street Number'' - as per ''Number Street''
*{{man label|Language:}} (Empty by Default) A [https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes two-digit language code].
*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)

You can remove a custom place format using the {{man button|Remove}} button.

The {{man label|Place Format Editor}} has one pre-defined format named '''Full''' by default.

{{man note|Creates a <code>place_formats.xml</code> file in your Gramps User directory|Not backed up see: [[Template:Backup_Omissions]]}}

See also:
* [https://github.com/gramps-project/gramps/pull/368 Implement place formats #368]
* [[Hierarchical Place Structure]]
* https://gramps-project.org/wiki/index.php/GEPS_045:_Place_Model_Enhancements_-_Place_Changes_Screenshots#Enhanced_Place_Format_Editor
* [https://sourceforge.net/p/gramps/mailman/message/36637553/ (Gramps-users) Proposed place formatting dialogs] From: Nick Hall. - 2019-04-11
* https://sourceforge.net/p/gramps/mailman/message/36422019/
* https://sourceforge.net/p/gramps/mailman/message/36363239/
* https://sourceforge.net/p/gramps/mailman/message/35694337/
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name Editor dialog]]
{{-}}
====== Example Place Formats ======
{{stub}}
The editor has a new field called "levels". It allows users to select hierarchy levels in the place loosely based on the python string slicing syntax. A number of colon ranges can be specified in a comma-separated list. "0" represents the lowest level - typically a building or street. "-1" represents the highest level - typically a country. The populated place is represented as "p".

For example:
"p:" = Populated place upwards.
"p,-1" = Populated place and country.

Valid options:
* <tt>0 - 9</tt> - Hierarchy Level
* <tt>-</tt> - Negative
* <tt>:</tt> - ??
* <tt>p</tt> - Populated Place
* <tt>,</tt> - comma

Place Format examples
* ["p:" = Populated place upwards]
* ["p,-1" = Populated place and country.]
* [1,p House and city],[p,1 City and house]

It lets you restrict long place descriptions in reports and views. [https://github.com/gramps-project/gramps/pull/368#issuecomment-290886087]

{{-}}

=====Display Name Editor=====

{{man note|1=Custom name display formats are stored in the Family Trees|2=Thus before loading any Family Tree the {{man label|Custom format details}} expander is disabled.}}

[[File:EditPreferences-Data-tab-DisplayOptions-section-DisplayNameEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Display Name Editor" - dialog (default) from Menu: "Edit>Preferences..." - "Data" tab > "Display Options" section]]
The {{man label|Display Name Editor}} allows you to define custom name formats, that can be shown on reports and charts at a global level or a per person level.

The {{man label|Display Name Editor}} has two section:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference|Help Reference]]}} section shown at the top
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_list|Display Name list]]}} table section

The {{man label|Display Name Editor}} can be accessed from the menu: {{man menu|Edit>Preferences...}} - {{man label|Data}} tab > {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}} sections {{man label|Name format:}} {{man button|Edit...}} button.
{{-}}
======Help Reference======


Display Name Help Reference:
<hr>
The following keywords are replaced with the appropriate name parts:
* '''Given''' - given name (first name)
* '''Title''' - title (Dr., Mrs.)
* '''Call''' - call name
* '''Initials''' - first letters of Given
* '''Prefix''' - all prefixes (von, de)
* '''Surname''' - surnames (with prefix and connectors)
* '''Suffix''' - suffix (Jr., Sr.)
* '''Nickname''' - nick name
* '''Common''' - nick name as first option if it exists, Call as second option, otherwise first of Given
<hr>
:Surname:
* '''Rest''' - non primary surnames
* '''Familynick''' - family nick name
* '''Primary, Primary[pre] or [sur] or [con]'''- full primary surname, prefix, surname only, connector
* '''Patronymic, or [pre] or [sur] or [con]''' - full pa/matronymic surname, prefix, surname only, connector
* '''Notpatronymic'''- all surnames, except pa/matronymic & primary
* '''Rawsurnames'''- surnames (no prefixes and connectors)
<hr>
{{man menu|UPPERCASE versions of these keywords forces uppercase to be displayed.}} Extra parentheses, commas are removed. Other text appears literally.
<hr>
:'''Example:''' Dr. Edwin Jose von der Smith and Weston Wilson Sr (“Ed”) - Underhills 
:''Edwin Jose'': '''Given''', ''von der'': '''Prefix''', ''Smith'' and ''Weston'': '''Primary''', ''and'': <abbr title="a connector">'''[con]'''</abbr>, ''Wilson'': '''Patronymic''', 
:''Dr.'': '''Title''', ''Sr'': '''Suffix''', ''Ed'': '''Nickname''', ''Underhills'' <abbr title="family nick name">'''Familynick'''</abbr>, Jose <abbr title="called (preferred given name)">'''Call'''</abbr>.
<hr>
{{-}}

======Help Reference Example person======
[[File:NameEditor-format_reference_example-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor's - reference person  shown in the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]] dialog]]

All the fields for the Help Reference '''Example''' person except the Family Nickname can be added in the standard Person Editor dialog. Double-click the Preferred name in Names tab of the Person Editor to access additional fields including: the Family Nick Name, Grouping controls, exception Sorting and Display controls, Date range controls for using a particular name.
{{-}}

======Display Name list======


In this section you can add, remove or edit existing name formats as well as see an example of the formatted name.

Table shows two headings {{man label|Format}} and {{man label|Example}}
* {{man label|Format}} - Based on the name parts shown
* {{man label|Example}} - Displays the name format applied to a ? [[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|builtin reference person]] ?

The List shows four default display name formats they are: 
* ''Surname, Given Suffix'' - displays the name as:
* ''Given Surname Suffix'' - displays the name as:
* ''Given'' - displays the name as: ''Edwin Jose''
* ''xxx''' - displays the name as:

* {{man button|Add}} - a new name format, type the required keywords as needed and press the {{man button|Enter}} key to see the resulting {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|Example]]}}
* {{man button|Remove}} - an existing name format (except for the four default name formats )
* {{man button|Edit}} - an existing name format (except for the four default name formats )
{{stub}}
{{-}}

==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Input Options" section defaults]]

*{{man label|Surname guessing:}} This option affects the initial family name of a child when they are added to the family tree.
** '''Father's surname''' (default) - will use the family name of the father.
** ''None'' - means that no surname guessing will be attempted.
** ''Combination of mother's and father's surname'' - will use the father's name followed by the mother's name.
** ''[https://wikipedia.org/wiki/Icelandic_name Icelandic style]'' - will use the father's given name followed by the "sson" suffix (e.g. the son of Edwin will be guessed as Edwin''sson'').

{{man tip|1=Tip |2=The {{man label|Surname guessing:}} option only affects the initial family name guessed by Gramps when the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog is launched from a {{man label|Family Editor}} window.
You can modify that name any way you see fit. Set this Preferences [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display tab]] option to the value that you will most frequently use, as it will save you a lot of typing.

See:
* [https://gramps-project.org/bugs/view.php?id=1715 feature request to support other local variations for surname guessing]
* [https://wikipedia.org/wiki/Category:Names_by_country Category:Names by country], From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Category:Names_by_language Category:Names by language], From Wikipedia, the free encyclopedia}}

*{{man label|Default family relationship:}} - used by the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Family Editor]]}} dialog.
** '''Unknown''' (default)
** ''Married''
** ''Unmarried''
** ''Civil Union''

*{{checkbox|0}}{{man label|Hide LDS tab in [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS|person]] and [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS_2|family]] editors}}: Latter Days Saints
{{-}}

=== General ===
[[File:EditPreferences-General-tab-EnviromentSettings-section-default-60.png|Right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "General" tab "Environment Settings" section defaults]]

This tab contains one section containing preferences relevant to the general operation of the program.

==== Environment Settings ====
*{{checkbox|0}}{{man label|Display Tip of the Day}}: This checkbox option controls the enabling and disabling of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tip_of_the_Day_dialog|Tip of the Day]]}} dialog at startup. {{man tooltip|Show useful information about using Gramps on startup.}}
*{{checkbox|0}}{{man label|Remember last Family Tree}}: Selecting this checkbox option causes the last used database to load upon start. It bypasses the '''Manage Family Trees''' dialog.
*{{checkbox|0}}{{man label|Remember last view displayed}}: This checkbox option controls the enabling and disabling of the display of the last [[Gramps_Glossary#view|View]]. Enabling will bring you to the view where you stopped the program the last time. {{man tooltip|Remember last view displayed and open it next time.}}
*{{checkbox|0}}{{man label|Enable spell checker}}: This checkbox option controls the enabling and disabling of the global spelling checker for notes. The '''[https://gitlab.gnome.org/GNOME/gspell gspell]''' package must be loaded for this to have an effect.[https://github.com/gramps-project/gramps/pull/1450] ( See: [[Troubleshoot Spellcheck]] ) {{man tooltip|Enable the spelling checker for notes.}} (Note the Edit>preferences option enables global English or the language your Gramps is run in and the note context menu is per note in the selected Language of your choice)

*{{checkbox|1}}{{man label|Show text label beside Navigator buttons *}} ''checked'' (default) This checkbox controls whether or not a text description is displayed next to the icon in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Navigator|Navigator]] in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Main_Window|Main Window]]. This option takes effect after the program has been restarted. {{man tooltip|Show or hide text beside Navigator buttons (People, Families, Events...). Requires Gramps restart to apply.}}

*{{checkbox|1}}{{man label|Show Clipboard icon on toolbar}}
*{{checkbox|1}}{{man label|Show Reports icon on toolbar}}
*{{checkbox|1}}{{man label|Show Tools icon on toolbar}}
*{{checkbox|1}}{{man label|Show Addons icon on toolbar}}
*{{checkbox|1}}{{man label|Show Preferences icon on toolbar}}
*{{man label|Toolbar Style:}} {{man tooltip|Display text, icons or both on the toolbar buttons.}}
** '''Both text and icons''' (default)
** ''Text only''
** ''Icons only''
*{{checkbox|1}}{{man label|Show close button in gramplet bar tabs}} ''checked''(default) {{man tooltip|Show close button to simplify removing gramplets from bars.}}

*{{man label|Markup for invalid date format:}} Default: <code>%s</code>
** Convenience markups are:
*** Bold (Default)
*** <big><big>Makes font relatively larger</big></big>
*** Italic
*** <s><s>Strikethrough</s></s>
*** Subscript
*** Superscript
*** Makes font relatively smaller
*** <tt><tt>Monospace font</tt></tt>
*** Underline
**** For example: %s will display Underlined bold date.

*{{man label|Multiple surname box height:}} Default: <code>150</code> Pixels {{man tooltip|Enter height in pixels. When multiple surnames are entered, these names display in a box. This setting sets the size of this box.}}

====Tip of the Day dialog====

[[File:TipOfTheDay-dialog--example-PrivacyInGramps-60.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog - example]]

When enabled in {{man menu|Edit > Preferences}} {{man label|General}} tab the {{man label|Tip of the Day}} dialog shows helpful hints.

The following options are available:
*{{checkbox|1}} {{man label|Display on startup}} (check box checked by default - once enabled) - uncheck to stop further tips appearing.
*{{man button|Forward}} - Advance to the next tip.
*{{man button|Close}} - exit for this session until the Gramps program is restarted.
[[Category:Tips]]

{{-}}

=== Family Tree ===
[[File:EditPreferences-FamilyTree-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - defaults]]
The {{man label|Family Tree}} tab contains the following four sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Location|Database Location]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a family tree]] - more information on backups
* [[Template:Backup_Omissions|Backup omissions]] - what is not included during a backup
{{-}}
====Database Settings====
[[File:EditPreferences-FamilyTree-tab-DatabaseSetting-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Settings" section defaults]]

*{{man label|Database backend:}} -
** '''[[Gramps_Glossary#sqlite|SQLite]]''' (''default'') - the [[DB-API Database Backend]]
** When multiple database backends are installed, they will be included in this list. <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr> backends: [[Addon:PostgreSQL|PostgreSQL]], SharedPostgreSQL, MongoDB. This menu can be trimmed by 'hiding' the unwanted database backends in the Plugin Manager.

{{man tip|Converting Trees from the retired BSDDB backend|The BSDDB backend developed incompatibilities as Python libraries evolved. That backend choice (as ''default'') was supseded with SQLite in Gramps 5.2 and has been retired (to read-only status) as of the Gramps 6.0 release. Although BSDDB '''''was''''' the default backend default in Gramps 2.0 through Gramp 5.1, all Gramps Trees should be converted another database backend at the earliest opportunity. '''[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Make a backup]] before any critical change.''' To convert a Tree, first select the target database backend in Preferences, then use the '''Convert''' button for the selected tree in the '''Family Tree ‐> Manage Family Trees''' dialog.}}

See also:
* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds experimental support for PostgreSQL databases. Recommended for Experts only!

{{-}}

====Database Location====
[[File:EditPreferences-FamilyTree-tab-DatabaseLocation-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Location" section defaults]]
*{{man label|Host:}} - Server address or other computer IP address for the location of the database.
*{{man label|Port:}} - Port number to access the Host database
*{{man label|Database path:}} Unless you have a definite reason to change this, stay with the default path. The default path where databases are stored is <code>grampsdb</code> within the [[Gramps_6.0_Wiki_Manual_-_User_Directory|User Directory]].
{{-}}

====Backup Management====
[[File:EditPreferences-FamilyTree-tab-BackupManagement-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Backup Management" section defaults]]
*{{man label|Backup path:}} - Location in which to save your Gramps backup archive files.
*{{checkbox|1}}{{man label|Backup on exit}} - Selecting this option will Backup Your family tree upon choosing to exit Gramps. The file be saved to the Backup path specified above. The filename of the backup will match the Family Tree appended with a date and time.
*{{man label|Autobackup:}} timer interval for triggering full backups during Gramps editing sessions.
** '''Never''' (''default'')
** Every 15 minutes
** Every 30 minutes
** Every hour
** Every 12 hours
** Every day
{{-}}

====Family Tree's Media path====
[[File:EditPreferences-FamilyTree-tab-FamilyTreesMediaPath-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Family Tree's Media path" section defaults]]
*{{man label|Base media path:}} Here you can fill in a base path for the media objects.
** Selecting the {{man button|Directory}} button gives you a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Select_media_directory_dialog|Select media directory]]}} dialog where you can fill in the required path.

{{man tip|The base relative media path is specific to the active family tree.|It is not a global setting in Gramps. Each family tree is able to have a unique media base path that is stored with the database.}}

{{man tip|To make media paths relative|You also need to select the {{man label|[ ] Convert to a relative path}} checkbox, at the bottom of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_a_media_object_selector|Select a media object selector]]}} dialog. Once checked for the first time it will be remembered for each subsequent media selection.}}

See also:
*[[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|{{man label|Gramps Media Manager}}]] a group of four separate tools two of which allow you to:
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}

{{-}}
=====Select media directory dialog=====

{{stub}}

See [[Gramps_6.0_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}

=====Missing Media Objects 'broken link' icon of a box with a red 'x'=====
[[File:BrokenMediaPath-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media object with a broken filepath]]

If the Preview thumbnails displays 'broken link' icon of a box with a red 'x' you will need to correct {{man label|Base media path:}} for your family tree in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section.

See also:
* Example.gramps - [[Example.gramps#Connecting_to_the_example_Media_Objects|Connecting to the example Media Objects]]
* [[Addon:Media_Verify_Tool|Media Verify Tool]] addon tool for revalidating media paths
{{-}}
{{stub}}

=== Import ===
[[File:EditPreferences-Import-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Import" - tab - defaults]]
The {{man label|Import}} tab has two sections as follows:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tag_Records|Tag Records]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Source_GEDCOM_import|Source GEDCOM import]]}}

==== Tag Records ====

*{{checkbox|0}}{{man label|Add tag on import}}: Checkbox (Default: <code>Imported %Y/%m/%d %H:%M:%S</code> ) ''' {{man tooltip|Specified tag will be added on import. Clear to set default value.}} Note - Adding a timestamped [[Gramps_Glossary#tag|Tag]] on import can significantly slow down the importing of your data, but are helpful for the ensuing data cleanup.'''

==== Source GEDCOM import ====

*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_import|GEDCOM data]]. If this is set, each item that is imported will contain a [[Gramps_Glossary#source|Source]] reference to the imported file. '''Note - Adding a default source can significantly slow down the importing of your GEDCOM data, but are helpful for the ensuing data cleanup.'''

{{-}}

=== Limits ===
[[File:EditPreferences-Limits-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Limits" - tab - defaults]]

Settings used for calculation operations of dates, ages and generations.

See also:
* [[Gramps 6.0 Wiki Manual - Probably Alive]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_dates|Editing dates]]
* Setting the [[Match_dates#Changing_after.2Fbefore.2Fabout_range|date approximation .ini]] manually

==== Calculation limits ====

*{{man label|Date 'about' year range: (date ± #):}} Default: <code>50</code>
** Defines the number of years +/- of the event date "<code>about <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'after' year range: (date + #):}} Default: <code>50</code>
** Defines the number of years after the event date "<code>after <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'before' year range: (date - #):}} Default: <code>50</code>
** Defines the number of years before the event date "<code>before <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Maximum age probably alive:}} Default: <code>110</code>
** Absent a Death event, the age by which Gramps will consider the person is no longer alive.
*{{man label|Maximum sibling age difference:}} Default: <code>20</code>
*{{man label|Minimum years between generations:}} Default: <code>13</code>
*{{man label|Average years between generations:}} Default: <code>20</code>
*{{man label|Max generations for relationships:}} You can enter the number of generations used to determine relationships. The default value is '''<code>15</code>'''. Limits the scope of features based on the [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
{{-}}

=== Colors ===
[[File:EditPreferences-Colors-tab-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - defaults]]

This tab has seven section related to allowing you to set the '''colors used for boxes in the graphical views'''.

Each of the colors can be customized using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]}}.

==== Colors used for boxes in the graphical views ====

You can select the
* {{man label|Color scheme:}}
** '''Light colors''' (default)
** ''Dark colors''
*** {{man button|Restore to defaults}} - restores themes default colors.

====Colors for Male persons====
* {{man label|Background for Alive:}} [ ] #b8cee6
* {{man label|Border for Alive:}} [ ] #1f4986
* {{man label|Background for Dead:}} [ ] #b8cee6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Female persons====
* {{man label|Background for Alive:}} [ ] #feccf0
* {{man label|Border for Alive:}} [ ] #861f69
* {{man label|Background for Dead:}} [ ] #feccf0
* {{man label|Border for Dead:}} [ ] #000000

====Colors for people who are neither male nor female====
* {{man label|Background for Alive:}} [ ] #94ef9e
* {{man label|Border for Alive:}} [ ] #2a5d16
* {{man label|Background for Dead:}} [ ] #94ef9e
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Unknown persons====
* {{man label|Background for Alive:}} [ ] #f3dbb6
* {{man label|Border for Alive:}} [ ] #8e5801
* {{man label|Background for Dead:}} [ ] #f3dbb6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Family nodes====
* {{man label|Default background:}} [ ] #eeeeee
* {{man label|Default border:}} [ ] #cccccc
* {{man label|Background for Married:}} [ ] #eeeeee
* {{man label|Background for Unmarried:}} [ ] #eeeeee
* {{man label|Background for Civil Union:}} [ ] #eeeeee
* {{man label|Background for Unknown:}} [ ] #eeeeee
* {{man label|Background for Divorced:}} [ ] #eeeeee
* {{man label|Border for Divorced:}} [ ] #ff7373

====Other colors====
* {{man label|Background for Home Person:}} [ ] #bbe68a
{{-}}

=== Genealogical Symbols ===
{{stub}}
{{man warn|Prerequisites exist for this feature|The Genealogical Symbols tab can only be used if the [[#Prerequisite_to_use_Genealogical_Symbols|prerequisite]] program <code>[[#Prerequisite_to_use_Genealogical_Symbols|python-fontconfig]]</code> is present that Gramps can use.}}

[[File:EditPreferences-GenealogicalSymbols-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Genealogical Symbols" - tab - defaults]]

Allows you to use Genealogical symbols instead of text abbreviations in reports, charts and the Gramps interface.

This tab gives you the possibility to use one font which is able to show all genealogical symbols. (Once configured see: [[#Prerequisite_to_use_Genealogical_Symbols|Prerequisite to use Genealogical Symbols]])

If you select the "{{man label|Use symbols}}" checkbox, Gramps will use the selected font if it exists.

This can be useful if you want to add phonetic in a note to show how to pronounce a name or if you mix multiple languages like Greek and Russian.

You can only configure the death symbol from this tab.

:List of Genealogical Symbols shown (listed in order shown at bottom of screenshot):

* Female
* Male
* Asexuality, sexless, genderless
* Lesbianism
* Male homosexuality
* Heterosexuality
* Transgender, hermaphrodite (in entomology)
* Transgender
* Neuter

* Illegitimate
* Birth
* Baptism/Christening
* Engaged
* Marriage
* Divorce
* Unmarried partnership
* Buried
* Cremated/Funeral urn
* Killed in action
* Extinct

* Death

{{-}}

{| class="wikitable"
|-
! meaning
! symbol
! Unicode code point(s)
! name
|-
! male
| ♂
| U+2642
| Male Sign
|-
! female
| ♀
| U+2640
| Female Sign
|-
! unknown
| ⚪︎
| U+26AA
| Medium White Circle
|-
! hermaphrodite
| ⚥
| U+26A5
| Interlocked Male and Female Sign
|-
! neuter
| ⚲
| U+26B2
| Neuter

|-
! birth
| *
| U+002A
| Asterisk
|-
! baptisation, christening
| ~
| U+007E
| Tilde
|-
! death
| ✝︎
| U+271D
| Latin Cross
|-
! burial
| ⚰︎
| U+26B0
| Coffin
|-
! cremation
| ⚱︎
| U+26B1
| Funeral Urn
|-
! stillborn
| ✝︎*
| U+0086 U+002A
| Latin Cross, Asterisk
|-
! born illegitimately
| *⃝
| U+002A U+20DD
| Circled Asterisk
|-
! born illegitimately
| ⊛
| U+229B
| Circled Asterisk Operator
|-
! killed in action
| ⚔︎
| U+2694
| Crossed Swords
|-
! this line extinct
| ‡
| U+2021
| Double Dagger
|-
! approximate(ly)
| ±
| U+00B1
| Plus-Minus
|-
! before
| <
| U+003C
| Less-Than Symbol
|-
! after
| >
| U+003E
| Greater-Than Symbol

|-
! engaged
| ⚬
| U+26AC
| Medium Small White Circle
|-
! married
| ⚭
| U+26AD
| Marriage Symbol
|-
! divorced
| ⚮
| U+26AE
| Divorce Symbol
|-
! unmarried
| ⚯
| U+26AF
| Unmarried Partnership Symbol
|}
{{-}}
====Prerequisite to use Genealogical Symbols====
{{stub}}
[[File:EditPreferences-GenealogicalSymbols-tab-default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences tab - defaults]]

=====Initial setup=====

If the fontconfig [[Gramps_6.0_Wiki_Manual_-_Settings#Prerequisite|prerequisite has been installed]], then on the {{man label|Genealogical Symbols}} tab select the {{man button|Try to find}} button, Gramps will attempt to detect any suitable unicode text fonts that can be used.

[[File:EditPreferences-GenealogicalSymbols-FindFont-51.png|center|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Finding fonts]]

When the search has completed select one of the fonts from the {{man button|Choose font}} list and then select the checkbox:

{{checkbox|1|Use symbols}}

=====Prerequisite=====
Prerequisite : '''python-fontconfig''' : Python bindings of fontconfig and its dependencies are required for displaying genealogical symbols
{{man note|Use the [[Addon:Prerequisites_Checker_Gramplet|Prerequisites Checker]]|Do you have <code>python-fontconfig</code> installed? Run the Prerequisites Checker Addon and look for something similar to the following line:<pre>* python-fontconfig 0.5.0 (Success version 0.5.x is installed.)</pre>}}

See also:
* Tamura Jones expounds on [https://www.tamurajones.net/GenealogySymbols.xhtml Genealogical Symbols] ''(the 'Unicode' section is particularly relevant)''
* [[GEPS 039: Genealogical symbols in gramps]]
* Feature request: {{bug|9098}} Gramps should be able to use genealogy symbols everywhere.
* [[Customize the Genealogical Symbols lookup table]] located in the [[Gramps_6.0_Wiki_Manual_-_User_Directory#MS_Windows|Gramps user directory]] at: [https://github.com/gramps-project/gramps/blob/maintenance/gramps51/gramps/gen/utils/symbols.py gramps\gen\utils\symbols.py]
{{-}}

=== ID Formats ===
{{man tip|ID Prefixes |The ID prefixes use formatting conventions common for C, Python, and other programming languages. For example, the <code>%04d</code> expands to an integer, prepended with zeros to have the total width of four digits. If you would like IDs to be 1, 2, 3, etc., simply set the formatting parameter to <code>%d</code>, the 'd' specifies Decimal Integer, outputting the number in base 10. See: Python [https://docs.python.org/3/library/string.html#format-specification-mini-language (String) Format Specification Mini-Language]}}

[[File:EditPreferences-IDFormats-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "ID Formats" - tab - defaults]]

This tab contains preferences relevant to the automatic generation of Gramps IDs.

*{{man label|Person:}} Provides the template for generating IDs for a Person. Default value: <code>I%04d</code>
*{{man label|Family:}} Provides the template for generating IDs for a Family. Default value: <code>F%04d</code>
*{{man label|Place:}} Provides the template for generating IDs for a Place. Default value: <code>P%04d</code>
*{{man label|Source:}} Provides the template for generating IDs for a Source. Default value: <code>S%04d</code>
*{{man label|Citation:}} Provides the template for generating IDs for a Citation. Default value: <code>C%04d</code>
*{{man label|Media Object:}} Provides the template for generating IDs for a Media Object. Default value: <code>O%04d</code>
*{{man label|Event:}} Provides the template for generating IDs for an Event. Default value: <code>E%04d</code>
*{{man label|Repository:}} Provides the template for generating IDs for a Repository. Default value: <code>R%04d</code>
*{{man label|Note:}} Provides the template for generating IDs for a Note. Default value: <code>N%04d</code>

You can use the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}

=== Text ===

[[File:EditPreferences-Text-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Text" - tab - defaults]]

This tab contains one section {{man label|Conditional Text Replacements}} with preferences relevant to how missing and private names and records should be shown.

==== Conditional Text Replacements ====

*{{man label|Missing surname:}} in the input field you can determine how a missing surname should be displayed. Default value is '''<code>[Missing Surname]</code>'''. You can change this to [--] or whatever is most convenient for you.
*{{man label|Missing given name}} in the input field you can determine how a missing given name should be displayed. Default value is '''<code>[Missing Given Name]</code>'''. You can change this to whatever you want.
*{{man label|Missing record:}} Default: <code>[Missing Record]</code>
*{{man label|Private surname:}} Default: <code>[Living]</code>
*{{man label|Private given name:}} Default: <code>[Living]</code>
*{{man label|Private record:}} Default: <code>[Private Record]</code>
{{-}}

=== Warnings ===
[[File:EditPreferences-Warnings-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]

This tab has one section {{man label|Warnings and Error dialogs}} that controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.

See the [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
==== Warnings and Error dialogs ====
*{{checkbox|0}}{{man label|Suppress warning when adding parents to a child.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_adding_parents_to_a_child|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning when cancelling with changed data.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_cancelling_with_changed_data|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning about missing researcher when exporting to GEDCOM.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_about_missing_researcher_when_exporting_to_GEDCOM|Dialog]])
*{{checkbox|0}}{{man label|Suppress tooltip warnings about data being saved immediately.}} Checkbox unchecked by Default
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])
{{-}}

=== Researcher ===
{{man tip|Researcher Information|This contact information is independent of the family trees you create. Most exports and reports will be filtered to protect the privacy of living people of the Tree... including yourself. This information feeds into the authoring and citation features of any publication (or archival) options.}}
[[File:EditPreferences-Researcher-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Researcher" - tab - defaults]]

Allows you to {{man label|Enter your information so people can contact you when you distribute your Family Tree}} in the corresponding text entry fields. Although Gramps requests information about you, this information is used only so that Gramps can create valid GEDCOM output files. A valid GEDCOM file requires information about the file's creator. If you choose, you may leave the information empty, however none of your exported GEDCOM files will be valid.

The available text entry fields are (all blank by default):
*{{man label|Name:}}
*{{man label|Address:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

The information entered under this preference acts as default value for family tree specific values that can be adjusted with the {{man menu|Tools->Family Tree Processing->[[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information...]]}}.
{{-}}

== Other settings ==

Besides {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog, there are other settings available in Gramps. For various reasons they have been made more readily accessible, as listed below.
{{-}}
===Columns editor===

{{man tip|The {{man label|Columns}} editor is available and works in the same way for all list views.|Specifically, it is available for People View, Family View (children list). Sources View, Citations View, Places View, Media View, Repositories View and the Notes View.}}

[[File:ColumnsEditorTab-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Columns''' editor tab - dialog - People Tree View default columns]]

The columns of the list views may be added, removed, or reordered in a {{man label|Columns}} editor dialog.

To use the {{man label|Columns}} editor dialog for the current view, choose via the menu {{man menu|View ➡ Configure...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

Only columns with a selected checkbox will be shown in the view. You can also change the position of a column in the View by clicking and dragging it to a new position in the Editor ([https://wikipedia.org/wiki/Drag-and-drop ''drag and drop'']). Once you have made the changes you want click {{man button|Apply}}, then click {{man button|OK}} to exit the Editor and see your changes in the View.

By default, the View List, displays several columns of information about the respective category. You can add or remove columns to and from the display

The default sort key for the view [always ascending] is the left-most field [i.e. at the top in the Columns Editor], so changing which field is in that position affects default sorting. For some views the first field cannot be changed and the reason will be mentioned at the top of the Columns editor.

The {{man label|Columns Editor}} dialog will have a different selection of columns for each category of View that displays a simple table.

Changes will only be enacted when the {{man button|Apply}} button is clicked.

Once the View columns changes have been applied, clicking once on the column header sorts in ascending order, clicking again sorts in descending order.

The subset of columns and the current [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] will also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|Export View...]]}} operation. Hidden columns and records will not be exported.
{{-}}

=== Sorting columns ===

[[File:PersonView-PeopleListView-example-with-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Before''' - default sort by "Name" column "People" Category - "Person" (List) View]]

[[File:PeopleCategory-PeopleListView-SortedByBirthDateColumn-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''After''' - Sorted by "Birth Date" column in the list mode of the People Category View - example]]

By default, each Category View presenting data in a columnated table layout will sort the rows in ascending order based on the data in the first (left-most) column. If the table has grouped rows, the grouped data will be sub-sorted. ''(Tables in tabbed subsets of data, Editors and Selectors will work similarly.)''

Click once on a different column header to sort on the data of that column in ascending order. Click the header again to sort in reverse order.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]]}} dialog can be used to add, remove and rearrange the displayed columns. Choosing a different first column will make that the new default sorting column of the view [though always ascending].
{{-}}

===Setting Home person===
[[File:MenuEdit-SetHomePerson-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu showing ''Set Home Person'']]

To set (designate) the [[Gramps_Glossary#home_person|Home person]], select the People Category and select the desired person to make them into the [[Gramps_Glossary#active_person|Active Person]] and then choose {{man menu|Edit ->Set Home Person}} via the menus.

Alternately, when editing any Person, right-clicking on inactive areas (areas without a text-entry box) of the top section displays a pop-up menu which includes an option to {{man menu|Make Home Person}} of that profile.

The Home person is the persistently designated person who becomes the [[Gramps_Glossary#active_person|Active Person]] when one of the following occurs:
*By default, when the Family tree database is opened ''(The [[Gramps_6.0_Wiki_Manual_-_Settings#General_Gramps_settings|General]] setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]] can modify this default behavior. The "Remember last view displayed" will return to the last [[Gramps_Glossary#active_person|Active Person]] of the previous session.)''
*As the toolbar {{man button|Home}} button is clicked
*When the Home menu item is selected from either the {{man button|Go}} menu or the right-click context menu in selected views
*As the [[Gramps_6.0_Wiki_Manual_-_Keybindings#15|keybinding]] {{Man key press|ALT|Home}} is pressed to return to the '''Home Person'''.

The toolbar {{man button|Home}} button is available in the People Category, Relationships Category, and Charts Category. [[File:Gramps Go-Home48x48 win.png|text-bottom]]
====See also====
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Home_Person|Setting the Home Person]]
{{-}}

===Adjusting viewing controls===

Whether the toolbar, the sidebar, or the filter (not available on Charts and Relationships Views) are displayed in the main window is adjusted through the View menu.

In the different views clicking the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Navigation#View|View]]}} menu will shows for boxes you can click:
*Navigator
*Toolbar
*Sidebar
*Bottombar
*Full Screen {{man key press|F11}}

Additionally, depending on the view you are in, other options will be available on {{man label|Configure}}.

*Gramplets:
**Set Columns to 1
**Set Columns to 2
**Set Columns to 3
*Relationships:
**Show Siblings
**Show Details
*Geography:
**Time period
**Layout

All other Views: the [[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]].

===Export View===

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - "Family Trees" - overview example showing "Export View" menu entry]]

On most [[Gramps_6.0_Wiki_Manual_-_Categories#Categories_of_the_Navigator|Category List Views]], displayed data maybe be exported, choose via the {{man menu|Family Trees ->Export View...}} [[Gramps_6.0_Wiki_Manual_-_Navigation#Main_Menus|menu]] command.

This Menu command only appears if the displayed data can be exported. Gramps will export data on screen according your choice: '''CSV''' or '''Open Document''' spreadsheet format.

Note that the current configuration of the View's columns will control what data will be exported. The export will contain only the displayed column data (in the same order) and be limited to records matching any [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] you have applied.

Use the Views [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect]] tab control the type of CSV to be created.
{{-}}
====Export View as Spreadsheet dialog====

[[File:ExportViewAsSpreadsheet-CSV-file-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Export View as Spreadsheet" CSV(default) filetype - dialog - example]]

Gramps will then display the {{man label|Export View as Spreadsheet}} dialog where after choosing a file location to save to and a name for your file; export data on from the Category List View in one of two spreadsheet formats:
*{{man label|Formats:}}
** '''CSV''' (default)
** '''OpenDocument Spreadsheet''' - ODS format.

{{-}}
[[File:ExportViewAsSpreadsheet-ODS-Displayed-in-LibreOfficeCalc-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Example ODS Spreadsheet - Displayed in LibreOffice Calc]]

The example screenshot shows an export to the '''OpenDocument Spreadsheet''' (ODS format) displayed as a Spreadsheet in LibreOffice Calc.

{{-}}

====CSV Dialect====
[[File:CSV-Dialect-Tab-dialog-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "CSV Dialect" tab - dialog - example]]

All list table views have a {{man label|CSV Dialect}} tab in the dialog for the {{man menu|View -> Configure...}} menu. You can choose the CSV format's delimiter to be used when exporting and importing data in Gramps.

''Choose your dialect'' from:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_Dialect|excel]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_tab_Dialect|excel-tab]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Unix_Dialect|unix]]}}
*{{man label|Custom}}
**{{man label|Delimiter:}}
*** ',' ''comma'' (default)
*** ';' ''semicolon''
*** ':' ''colon''
*** '|' ''bar''
*** 'tab'

CSV stands for '''[https://wikipedia.org/wiki/Comma-separated_values comma-separated values]'''. It is a plain text file format that separate data into columns and rows for simple way to exchange data. Originally, data was limited by being separated into columns by fixed positions in <code>.txt</code> text files. When more flexibility was needed, the comma was chosen as a delimiter to mark the boundaries of the columns and the <code>.csv</code> format of a text file was established. To complicate matters, different Operating System marked their end-of-line and end-of-file with different terminating codes.

When comma was needed too frequently in the data itself, a <code>.tsv</code> (tab-separated-values) file format became popular. When other delimiters began being adopted, rather than use up more file extensions, CSV became synonymous with any text format with delimiter marked columns. They were just different 'dialects' of "CSV".

[https://docs.python.org/3/library/csv.html Python's <code>csv</code> module] provides several pre-defined dialects to simplify reading and writing CSV files. These dialects specify rules for parsing and formatting data. The standard dialects include {{man label|excel}}, {{man label|excel-tab}}, and {{man label|unix}}. The following sections outline each dialect's characteristics, including its separator, line terminator, and quoting behavior.

===== Excel Dialect =====

The {{man label|excel}} dialect is designed to be compatible with CSV files generated by Microsoft Excel. It is suitable for data that has been saved from Excel as comma-separated values.
*Separator:** Comma (<code>,</code>`)
*Line Terminator: Carriage return and line feed (<code>\r\n</code>)
*Quoting:
** Double quotes (<code>"</code>`) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Excel-tab Dialect =====

The {{man label|excel-tab}} dialect is similar to the `excel` dialect but uses tabs instead of commas as the separator. This format is often encountered when copying cell data from Excel to the OS clipboard. Pasting tab separated data into the [[Addon:Import_Text_Gramplet|Import Text]] addon gramplet is one of the quickest way to populate parts of your tree.

* Separator: Tab (<code>\t</code>)
* Line Terminator: Carriage return and line feed (<code>\r\n</code>)
* Quoting:
** Double quotes (<code>"</code>) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Unix Dialect =====

The {{man label|unix}} dialect is designed for use in Unix-like environments. It uses a line feed character as the line terminator and always quotes all fields.

* Separator: Comma (<code>,</code>)
* Line Terminator: Line feed (<code>\n</code>)
* Quoting:
** All fields are enclosed in double quotes (<code>"</code>).
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== See also: =====
* [https://github.com/gramps-project/gramps/pull/1314 CSV: possibility to select the dialect. #1314 ]
{{-}}

===Modularity and plugins===


Gramps has been designed for expansion. The Plugin (a.k.a. Plug-in, addon, extension) framework provides a path for third party development outside the normal Gramps release distributions.

The documentation for each addon is maintained outside the flow of these main wiki chapters. The interface and functionality of the software and documentation may not conform with the styles seen throughout the rest of Gramps... although we encourage Developers to try to make their additions as seamless as possible.

A brief description and screenshot of each addon can be found in the [[6.0_Addons#Addon_List|Addon List]] section of the wiki manual. The separately maintained documentation page for the addon is linked from the 1st column of that list.

See [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[6.0 Addons|Third-Party Addons]].
{{-}}

===Customize report output formats===
[[File:TextReports-DocumentOptions-section-PlainText-output-settings-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Options - tab defaults for Text Reports (Plain Text - output selected) example]]

What kind of output customization is available? This dialog allows you to change the fonts, font sizes, font color, background color of the text and alignment of paragraphs on the report.

For most report dialogs, in the top part are option tabs specifically related that particular report. The lower part will have more broadly reusable features and is called the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Document_Options|Document Options]]}} section.

From the {{man label|Style:}} drop down list you can choose an existing custom style. Or to make your own {{man label|Style:}} select the {{man button|Style Editor...}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Document_Styles_dialog|Document Styles]]}} dialog and then select the {{man button|Add a new style}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.

{{stub}}
{{-}}
====Document Styles dialog====

[[File:DocumentStyles-dialog-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Styles - dialog - default]]

The {{man label|Document Styles}} dialog, list the ''default'' style and any custom styles for that report and allows you to edit or delete any custom styles you have created. Select the {{man button|+ (Add a new style)}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}

====Style editor dialog====
[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

The {{man label|Style editor}} dialog allow you to customize the document style specific to each report.

Change the {{man label|Style sheet name:}} <code>New Style</code> (default) field to a unique name as it will appear in {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Document_Options|Document Options]]}} {{man label|Style:}} drop down list.

Once changes for your custom style have been finalized select the {{man button|OK}} button to save the changes or {{man button|Cancel}} to exit.

=====Style editor dialog tabs=====
On the left hand side you will see the {{man label|Style}} column that list the paragraph options specific to that report that you may modify. For example the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report]]}} shows the style options for <code>AHN-Entry</code>, <code>AHN-Generation</code> and <code>AHN-Title</code>.

On the right hand side are three tabs associated with each style listed in the left hand column:
* [[#Description|Description]]
* [[#Font_options|Font options]]
* [[#Paragraph_options|Paragraph options]]

{{-}}
======Description======

[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

*{{man label|Description}} tab describes what each paragraph is all about. For example shown here is the style used for the Ahnentafel Report ( <code>AHN-Entry</code> ) with the description: ''The basic style used for the text display.''
{{-}}

======Font options======

[[File:StyleEditor-dialog-FontOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Font options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Font options}} tab allows you to set the {{man label|Type face}} ''Roman'' or ''Swiss'', the {{man label|Size}} of the font in pt.(point), the {{man label|Color}} of the font and some {{man label|Options}} like ''Bold'', ''Italic'' or ''Underline''.
{{-}}

======Paragraph options======

[[File:StyleEditor-dialog-ParagraphOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Paragraph options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Paragraph options}} tab allows you to set the {{man label|Alignment}}, the {{man label|Background color}}, {{man label|Indentation}}, {{man label|Spacing}} and {{man label|Borders}} of your style.
{{-}}

===Context menu===
[[File:Clipboard-dialog-example-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clipboard - with example contextual pop-up menu from right-clicking a Family]]
[[Gramps_6.0_Wiki_Manual_-_Main_Window#Pop-up_menus|Pop-up menus]] are used in various places in Gramps; how you access the context menu is dependent on your operating systems:
* On Microsoft windows, you generally use the right button of your mouse to show the context menu or use the keyboard shortcut {{man button|Shift}}+{{man button|F10}}. see [https://docs.microsoft.com/en-us/previous-versions/windows/desktop/mpc/using-context-menus Using Context Menus - Microsoft Docs]
* On Apple macOS, you generally press {{man button|Ctrl}} while clicking the button of your mouse to show the context menu. see: [https://developer.apple.com/design/human-interface-guidelines/macos/menus/contextual-menus/ Contextual Menus - Menus - macOS - Human Interface Guidelines - Apple Developer]

List of known Context menus in Gramps:
* Pedigree View Context menus
* Clipboard context menu
* File Chooser - Context Menu options
* <Category view> context menus
* Manage Books dialog 
* ... and many more
{{stub}}

See also:
* [[Gramps 6.0 Wiki Manual - Keybindings|Keybindings]]

=== Selector dialogs ===
[[File:SelectFamily-SelectorDialog-example-60.png|450px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]] - showing Search Bar]]


Selector dialogs are a combo interface box and you generally use then to select an object (Person/Family/Events etc). Also various {{man label|Selectors}} also have search bars:
* [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Event_selector|Select Event selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Note_selector|Select Note selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Person_selector|Select Person selector]]
*[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Select_a_person_for_the_report_selector|Select a person for the report selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Father_selector|Select Father selector]] (filtered to Father)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Mother_selector|Select Mother selector]] (filtered to Mother)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Child_selector|Select Child selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Media_Object_selector|Select Media Object selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Place_selector|Select Place selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Repository_selector|Select Repository selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_or_Citation_selector|Select Source or Citation selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_selector|Select Source selector]]

{{-}}
See also
* [https://gramps-project.org/wiki/index.php/GEPS_041:_New_Selector GEPS_041:_New_Selector]
* [[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]

{{stub}}

== Customizing ==
Here are some ways that you can customize Gramps.
=== Preferences ===

In the "Display Options" section of the Edit>Preferences {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}} tab you can select the Name format used by default throughout Gramps. The Edit button for the {{man label|Name format:}} opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}}, allowing the creation of user-defined (custom) stylings beyond the pre-defined (built-in) name format choices.

See [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]

The Edit button for a person's preferred and alternative names opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Name Editor]]}}, allowing the selection of a name format exceptions that will override the format chosen in the Display tab of Preferences for the entire Tree.

The name format, grouping and sorting can be overridden for selected individuals and surnames. The Edit Person dialogs have two Edit buttons to access this feature. The button for Preferred name is to the right of the Suffix field. However, for any selected Name (Preferred or Alternative) in the Names tab which opens the Name Editor. The built-in and custom Display Name formats can be selected exceptions to "Group as:" and "Sort as:" options that default to the Name format selected in Preferences.

=== Pick a Color selector ===
The [[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]] tab of the Preferences allows customizing of the color of various elements of diagrams in the Charts category's graphical views.

==== Color Palette ====
[[File:PickAColor-selector-dialog-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - palette selector dialog]]
Select a color from the 45 [[Gramps_Glossary#swatch|swatches]] in predefined color palette area. Or select from the recently used {{man label|Custom}} color swatches. Or click the {{man button|+}} button to create your own custom color. Right-click on any swatch to add another custom color and open the gradient selector.

You can drag any color swatch to any swatch in the preference (or configure) dialog.

{{-}}
==== Color Gradient ====
[[File:PickAColor-gradient-dialog-52.png|right|thumb|436px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - gradient selector dialog]]
The gradient selector dialog is for adjust the [[Gramps_Glossary#swatch|color swatch]] at the top of the dialog. Once changed, either click the {{man button|Select}} button to apply the color. Drag the single gradient dialog swatch to any swatch in the preference (or configure) dialog.

Specific colors of the swatch can be changed in several ways:
* via direct entry 'color Hex color code'
* the hue slider (with a numeric fine control
* mouse left-click in the 1-dimensional (hue) rainbow gradient or the 2-dimensional (brightness and saturation) hue gradient.
* mouse right-click in either gradient to show the numeric control for the dimension(s) of the gradient
* mouse left-click on the eyedropper color picker to choose from any pixel shown on the monitor(s)
{{-}}

=== File Chooser ===
[[File:FileChooser_Bookmarks_Breadcrumbs.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Linux GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs mac.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} macOS GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs win.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Windows GTK File Chooser: highlighting breadcrumbs and bookmarking]]
The Open and Save dialogs (File Chooser) for Gramps are based on the [https://docs.gtk.org/gtk3/iface.FileChooser.html GTK File Chooser]. Each operating system has expected behaviors for clicks, double-clicks, sorting, [[Gramps_6.0_Wiki_Manual_-_Keybindings#Handy_Shortcuts|keybindings]], environmental variables, and standard file locations that are characteristic of File Chooser dialogs native to the operating system. A few of these can be customized via the user interface to feel more similar to the OS native File Choosers. However, the idiosyncrasies of various OSes mean shared network folders and URI support may not be as readily browsed as when using the OS native File Choosers.

The [https://developer-old.gnome.org/gtk4/stable/GtkFileChooser.html GtkFileChooser] allows for adding quick navigation hotlinks to commonly used places of the filesystem. In the default implementation, these are displayed in the left sidebar navigation pane. It may be a bit unclear at first that these shortcuts come from various sources and in various flavors, so let's explain the terminology here:
* '''[[#Bookmarking_file_folders|Bookmarks]]''': are created by the user, by dragging folders from the right pane to the left pane, or by using the “Add”. Bookmarks can be renamed and deleted by the user.
* '''Shortcuts''': can be provided by the Gramps application. For example, program may want to add a shortcut for a Downloads or Documents folder. Shortcuts ''cannot'' be added or removed by the user. The 'Rename...' context menu option allows them to be relabeled.
* '''Volumes''': are provided by the underlying filesystem abstraction. They are the “roots” of the filesystem. The Home and Downloads hotlinks are common "roots". Volumes cannot be modified by the user.

====File Chooser context menus====
Right-click on any file or folder in the current directory to open context pop-up menu with the following options:
<hr>
*{{man menu|Open With File Manager}}
<hr>
*{{man menu|Copy Location}}
*{{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Bookmarking_file_folders|Add to Bookmarks]]}}
<hr>
*{{man menu|❏ Show Hidden Files}}
*{{man menu|☑ Show Size Column}}
*{{man menu|☑ Show Type Column}}
*{{man menu|❏ Show Time}}
*{{man menu|❏ Sort Folders before Files}}
<hr>

Right-click in the navigation sidebar to open context pop-up menu with the following options:
<hr>
*{{man menu|Open}}
*{{man menu|Remove}}
*{{man menu|Rename...}}
<hr>

====Breadcrumbs and text-entry address bar====
By default, the file folder navigation in the File Chooser is by browsing. There are also some shortcuts on the left and breadcrumbs (highlighted in green in the dialog illustration) for quick navigation up and down the path.

Optionally, a text-entry address bar can be used to directly key-in or paste a path. Toggle between displaying breadcrumbs and the text-entry address bar with the {{Man key press|CTRL|L}} [[Gramps_6.0_Wiki_Manual_-_Keybindings|keybinding]].

====Bookmarking file folders====
File folder bookmarks can be user defined to make finding standard locations easier. These bookmarks are remembered between sessions and regardless of which Family Tree has been loaded.

With any Open or Save dialog open, navigate to the file location containing the folder to be bookmarked. Create the bookmark by either: dragging the folder icon to the navigation column on the left; or, right-clicking that folder to use the {{Man menu|Add to Bookmarks}} context menu option.

Right-clicking an existing Bookmark allows renaming that bookmark or removing it.

====File Formats====
Support for several file formats are built into the standard distribution of Gramps. Import plugin and Export Plugin Addons can be installed via the Plugin Manager or Preferences to expand the options.

See the [[Output_formats|Output Format]] article for list of file formats.

====See also====
* [https://ubuntugenius.wordpress.com/2010/05/14/how-to-show-text-entry-address-bar-or-breadcrumbs-navigation-buttons-in-nautilus-after-ubuntu-10-04-upgrade/ How to Show Text-Entry Address Bar or “Breadcrumbs” (Navigation Buttons)] in Nautilus After Ubuntu 10.04 Upgrade

*Discourse discussions about the GTK File Chooser:
** [https://gramps.discourse.group/t/need-suggestions-for-documenting-the-gtk-file-chooser/1820/8 Documenting the File Chooser in the wiki]
** [https://gramps.discourse.group/t/macos-and-windows-gtk-file-chooser-dialog-capture-request/3364 Illustrating the File Chooser in the Wiki]
** [https://gramps.discourse.group/t/can-i-cause-folders-to-sort-to-the-top-of-the-list-when-presented-with-the-folder-contents/1708/14 File Chooser: Sorting files and folders]
* [https://discourse.gnome.org/t/where-is-the-filechooser-feature-list/9101/1 Where is the FileChooser feature list?]

=== Language ===

Gramps has been translated into a number of [[Portal:Translators|languages]]. Usually Gramps automatically starts in your local language, as chosen for other applications, but sometimes this may not be right for you. And in other cases, a module or addon will not yet have been translated and a warning dialog will appear saying something like “Warning: plugin XYZ has no translation for any of your configured languages, using US English instead”. (Note that the US dialect of English is the default rather than British.) This can become annoying or intrusive.

The most idealistic situation is that you are as fluent in US English as the language selected for the operating system GUI on your computer. And that you would take the opportunity to translate that Gramps feature for users who are non-English speakers.

If your system is configured to show a language other then English, you can override this for Gramps.

As an example, assume that a computer in the Netherlands is configured to default to Unicode 8 Dutch: "LANG: nl_NL.UTF-8". You could either reset the OS language

In Windows, use the SET command to change the LANG environment variable to "en_GB.UTF-8" for British English. You can do this from the command line interface or [https://gramps-project.org/bugs/view.php?id=11009 create a startup shortcut with the following Target]:
<code>C:\Windows\System32\cmd.exe /c "SET LANG=en_GB.UTF-8 && START /D ^"C:\Program Files\GrampsAIO64-6.0.5^" gramps.exe"</code>

{{stub}} '''{{man warn|tbd|Describe for each main platform how the normal language is determined and how the user can [[Howto:Change_the_language_of_reports#Run_Gramps_in_a_different_language|choose a different language]].'''}}

==== Linux ====
{{stub}}

If you want to choose a locale 'variant' for sorting that is not the default variant, then you can start Gramps from the terminal (or console) with a different LC_COLLATE environment. For example, the default sorting (collation) variant for Swedish is "reformed", but you can instead choose "standard" by typing:
export LC_COLLATE="sv_SE.UTF-8@collation=standard"
python Gramps.py

==== macOS ====

For macOS see [[Mac_OS_X:Application_package#Advanced_setup|Advanced setup]] for details on how the language is normally chosen, and how to choose a special, non-default setting for the language, the sorting order or the format of such things as day and month names and number separators.

==== MS Windows ====
[[File:MicrosoftWindowGrampsAIO-Installer-ChooseComponents-Selection-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps 6.0.3 AIO 64 bit for Microsoft Windows installer - "Choose Components" page showing selection of the "de"( German) Translation]]
If you want to run Gramps in another language other than English using the Gramps AIO installer, then you must select it during installation process.

Otherwise it will not be available.

More information can be found at [[Installing_Gramps_for_Windows_computers#Missing_other_languages]] page.

{{-}}

===Add Windows OS Menu Item===
[[File:Edit-Target-GrampsAIO64-Properties-Danish-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for Danish shortcut example.]]

To make Gramps work in your selected language (See table below for your [[Gramps_6.0_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:
* Using your mouse right button click on the "{{man label|GrampsAIO64 6.x.x}}" icon on Desktop and from menu choose: {{man label|Copy}}.
* Right click anywhere on Desktop and from menu choose: {{man label|Paste shortcut}}
* New icon will be created with name: "{{man label|GrampsAIO64 6.x.x (2)}}"
* Right click on that and from menu choose: {{man label|Properties}}
* A new window will open, click on first tab called {{man label|General}} and change text from "{{man label|GrampsAIO64 6.x.x (2)}}" to something more descriptive like: "{{man label|GrampsAIO Danish}}"
** Click on second tab called {{man label|Shortcut}}, change text in first entry called {{man label|Target}} from (note path will vary depending on Gramps version used):
***<code>"C:\Program Files\GrampsAIO64-6.x.x\grampsw.exe"</code> to:
***<code>%comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"</code>
* Click {{man label|OK}}

Now when you click on that icon Gramps will start in Danish.

{{-}}
{{man tip|You can download a zip file attached to feature request:{{bug|13204}} Gramps AIO64 X.x.x Language icons Shortcuts Pack ( for the languages shown in the [[#Language_codes|Language codes]] table below)}}
{{-}}

===Change the windows LANG variables===
Another option if you want Gramps to always load in say: French Canadian language, you can go to Windows > System Properties, and add the LANG variable in the user section of the environment variables dialog with the appropriate Value.

The value to add is:
<pre>
Name: LANG
Value: fr_CA.UTF-8
</pre>

* [https://www.redswitches.com/blog/environment-variables/#method-1-set-environment-variables-through-the-gui How to Set Environment Variables in Windows 10]

===Language codes===
Select from the following table of [[Portal:Translators|languages Gramps]] has been translated into:

{| {{prettytable}}
!Language
!ISO code
!Example
!Notes
|-
| English-USA (Default)
| en_US.UTF-8
| %comspec% /c set LANG=en_US.UTF-8 && start grampsw.exe"
|
|-
| English (British)
| en_GB.UTF-8
| %comspec% /c set LANG=en_GB.UTF-8 && start grampsw.exe"
|
|-
| Finnish
| fi.UTF-8
| %comspec% /c set LANG=fi.UTF-8 && start grampsw.exe"
|
|-
| Russian
| ru_RU.UTF-8
| %comspec% /c set LANG=ru_RU.UTF-8 && start grampsw.exe"
|
|-
| Albanian
| sq_AL.UTF-8
| %comspec% /c set LANG=sq_AL.UTF-8 && start grampsw.exe"
|
|-
| German
| de_DE.UTF-8
| %comspec% /c set LANG=de_DE.UTF-8 && start grampsw.exe"
|
|-
| French
| fr_FR.UTF-8
| %comspec% /c set LANG=fr_FR.UTF-8 && start grampsw.exe"
|
|-
| French Canadian
| fr_CA.UTF-8
| %comspec% /c set LANG=fr_CA.UTF-8 && start grampsw.exe"
|
|-
| Macedonian
| mk_MK.UTF-8 ???
|
|
|-
| Nederlands (Dutch)
| nl_NL.UTF-8
| %comspec% /c set LANG=nl_NL.UTF-8 && start grampsw.exe"
|
|-
| Dutch
| nl_BE.UTF-8
| %comspec% /c set LANG=nl_BE.UTF-8 && start grampsw.exe"
|
|-
| Slovak
| sk_SK.UTF-8
| %comspec% /c set LANG=sk_SK.UTF-8 && start grampsw.exe"
|
|-
| Hebrew
| he_IL.UTF-8
| %comspec% /c set LANG=he_IL.UTF-8 && start grampsw.exe"
|
|-
| Danish
| da_DK.UTF-8
| %comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"
|
|-
| Greek
| el_GR.UTF-8
| %comspec% /c set LANG=el_GR.UTF-8 && start grampsw.exe"
|
|-
| Italian
| it_IT.UTF-8
| %comspec% /c set LANG=it_IT.UTF-8 && start grampsw.exe"
|
|-
| Esperanto
| eo.UTF-8 ???
|
|
|-
| Chinese (Simplified)
| zh_CN.UTF-8
| %comspec% /c set LANG=zh_CN.UTF-8 && start grampsw.exe"
|
|-
| Chinese (Hong Kong)
| zh_HK.UTF-8 ???
|
|
|-
| Chinese (Traditional)
| zh_TW.UTF-8
| %comspec% /c set LANG=zh_TW.UTF-8 && start grampsw.exe"
|
|-
| Ukrainian
| uk_UA.UTF-8
|
|
|-
| Portuguese
| pt_PT.UTF-8
| %comspec% /c set LANG=pt_PT.UTF-8 && start grampsw.exe"
|
|-
| Portuguese (Brazil)
| pt_BR.UTF-8
| %comspec% /c set LANG=pt_BR.UTF-8 && start grampsw.exe"
|
|-
| Afrikaans
| af_ZA.UTF-8
|
|
|-
| Norwegian Bokmål
| nb_NO.UTF-8
| %comspec% /c set LANG=nb_NO.UTF-8 && start grampsw.exe"
|
|-
| Norwegian Nynorsk
| nn_NO.UTF-8
| %comspec% /c set LANG=nn_NO.UTF-8 && start grampsw.exe"
|
|-
| Turkish
| tr_TR.UTF-8
| %comspec% /c set LANG=tr_TR.UTF-8 && start grampsw.exe"
|
|-
| Spanish
| es_ES.UTF-8
| %comspec% /c set LANG=es_ES.UTF-8 && start grampsw.exe"
|
|-
| Polish
| pl_PL.UTF-8
| %comspec% /c set LANG=pl_PL.UTF-8 && start grampsw.exe"
|
|-
| Slovenian
| sl_SI.UTF-8
| %comspec% /c set LANG=sl_SI.UTF-8 && start grampsw.exe"
|
|-
| Japanese
| ja_JP.UTF-8
| %comspec% /c set LANG=ja_JP.UTF-8 && start grampsw.exe"
|
|-
| Arabic (Saudi Arabia)
| ar_SA.UTF-8
| %comspec% /c set LANG=ar_SA.UTF-8 && start grampsw.exe"
|
|-
|
|
|
|
|-
|
|
|
|
|}
*The language codes are two-letter lowercase ISO language codes (such as "da") as defined by [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1].
*The country codes are two-letter uppercase ISO country codes (such as "BE") as defined by [https://en.wikipedia.org/wiki/ISO_3166-1 ISO 3166-1].

===Setting up the language environment===

{{stub}} 



===Advanced manipulation of settings===
{{stub}}

{{man warn| Warning ** Make sure you have closed Gramps **|The contents of this section is outside the scope of interest of a general user of Gramps. If you proceed with tweaking the options on the low level you may damage your Gramps installation. Be careful. '''YOU HAVE BEEN WARNED!'''}}

Besides the settings available in Preferences, you may also wish to explore the advanced settings.

Gramps uses '''[https://en.wikipedia.org/wiki/INI_file#Keys_(properties) INI keys]''' and [https://en.wikipedia.org/wiki/INI_file#Sections INI sections] for managing user preferences and program settings these are stored in the text file <code>gramps.ini</code> under the <code>.gramps/gramps[XX]</code> folder in your home or user directory.

The <code>gramps.ini</code> file has following sections:
* [behavior] : typical Key names are: [https://github.com/gramps-project/gramps/blob/master/gramps/gui/grampsgui.py#L502 betawarn], enable-autobackup, use-tips...
* [colors] :
* [csv] :
* [database] : related to database settings for the Family Tree.
* [export] : export and import folders/directories
* [geography] :
* [interface] : a lot of keys regarding height and width of the different Views: e.g. event-height: 450, event-ref-height: 585, event-ref-width: 728, event-width: 712...
* [paths] : keys related to recent imported files and folders/directories
* [plugin] :
* [preferences] : keys related to preferences: all the common prefixes , todo -colors..
* [researcher] : all information regarding the researcher
* [spacing] :
* [test] :
* [utf8] :

====Example <code>gramps.ini</code> file====
Example contents of the <code>gramps.ini</code> file:


<pre>
;; Gramps key file
;; Automatically created at 2025/05/24 08:49:41

[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0
;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps60', True]]
;;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps60'
;;autoload=0
;;avg-generation-gap=20
;;check-for-addon-update-types=['new']
;;check-for-addon-updates=0
;;date-about-range=50
;;date-after-range=50
;;date-before-range=50
;;do-not-show-previously-seen-addon-updates=1
;;generation-depth=15
;;immediate-warn=0
;;last-check-for-addon-updates='1970/01/01'
;;max-age-prob-alive=110
;;max-sib-age-diff=20
;;min-generation-years=13
;;owner-warn=0
;;pop-plugin-status=0
;;previously-seen-addon-updates=[]
;;recent-export-type=3
;;runcheck=0
;;spellcheck=0
;;startup=0
;;surname-guessing=0
translator-needed=0
;;use-tips=1
;;web-search-url='https://google.com/search?q=%(text)s'
;;welcome=100

[colors]
;;border-family=['#cccccc', '#252525']
;;border-family-divorced=['#ff7373', '#720b0b']
;;border-female-alive=['#861f69', '#261111']
;;border-female-dead=['#000000', '#000000']
;;border-male-alive=['#1f4986', '#171d26']
;;border-male-dead=['#000000', '#000000']
;;border-other-alive=['#2a5f16', '#26a269']
;;border-other-dead=['#000000', '#000000']
;;border-unknown-alive=['#8e5801', '#8e5801']
;;border-unknown-dead=['#000000', '#000000']
;;family=['#eeeeee', '#454545']
;;family-civil-union=['#eeeeee', '#454545']
;;family-divorced=['#ffdede', '#5c3636']
;;family-married=['#eeeeee', '#454545']
;;family-unknown=['#eeeeee', '#454545']
;;family-unmarried=['#eeeeee', '#454545']
;;female-alive=['#feccf0', '#62242D']
;;female-dead=['#feccf0', '#3a292b']
;;home-person=['#bbe68a', '#304918']
;;male-alive=['#b8cee6', '#1f344a']
;;male-dead=['#b8cee6', '#2d3039']
;;other-alive=['#94ef9e', '#285b27']
;;other-dead=['#94ef9e', '#062304']
;;scheme=0
;;unknown-alive=['#f3dbb6', '#75507B']
;;unknown-dead=['#f3dbb6', '#35103b']

[csv]
;;delimiter=','
;;dialect='excel'

[database]
;;autobackup=0
;;backend='sqlite'
;;backup-on-exit=1
;;backup-path='C:\\Users\\[username]'
;;compress-backup=1
;;host=''
;;path='C:\\Users\\[username]\\AppData\\Roaming\\gramps\\grampsdb'
;;port=''

[export]
;;proxy-order=[['privacy', 0], ['living', 0], ['person', 0], ['note', 0], ['reference', 0]]

[geography]
;;center-lat=0.0
;;center-lon=0.0
;;lock=0
;;map_service=1
;;path=''
;;personal-map=''
;;show_cross=0
;;use-keypad=1
;;zoom=0
;;zoom_when_center=12

[interface]
dbmanager-height=370
;;dbmanager-horiz-position=12
;;dbmanager-vert-position=85
;;dbmanager-width=780
;;dont-ask=0
;;filter=0
;;fullscreen=0
;;grampletbar-close=1
;;hide-lds=0
;;ignore-gexiv2=0
;;ignore-osmgpsmap=0
;;ignore-pil=0
;;main-window-height=500
;;main-window-horiz-position=15
;;main-window-vert-position=10
;;main-window-width=775
;;mapservice='OpenStreetMap'
;;open-with-default-viewer=0
;;pedview-layout=0
;;pedview-show-images=1
;;pedview-show-marriage=0
;;pedview-show-unknown-people=0
;;pedview-tree-direction=2
;;pedview-tree-size=5
;;place-name-height=100
;;place-name-width=450
;;sidebar-text=1
;;size-checked=0
;;statusbar=1
;;surname-box-height=150
;;tipofday-height=350
tipofday-horiz-position=-49
tipofday-vert-position=84
;;tipofday-width=550
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-style=0
;;toolbar-tools=1
;;treemodel-cache-size=1000
;;view=1
;;view-categories=['Dashboard', 'People', 'Relationships', 'Families', 'Ancestry', 'Events', 'Places', 'Geography', 'Sources', 'Citations', 'Repositories', 'Media', 'Notes']

[paths]
;;quick-backup-directory='C:\\Users\\[username]'
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'
;;recent-export-dir='C:\\Users\\[username]'
;;recent-file=''
;;recent-import-dir='C:\\Users\\[username]'
;;report-directory='C:\\Users\\[username]'
;;website-cal-uri=''
;;website-cms-uri=''
;;website-directory='C:\\Users\\[username]'
;;website-extra-page-name=''
;;website-extra-page-uri=''

[plugin]
;;addonplugins=[]
;;hiddenplugins=[]

[preferences]
;;age-after-death=1
;;age-display-precision=1
;;age-rounded-year=1
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-legacy'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;default-source=0
;;eprefix='E%04d'
;;family-relation-type=3
;;family-warn=0
;;february-29=0
;;fprefix='F%04d'
;;hide-ep-msg=0
;;invalid-date-format='%s'
;;iprefix='I%04d'
last-view='dashboardview'
last-views=['dashboardview', '', '', '', '', '', '', '', '', '', '', '', '']
;;name-format=1
;;no-given-text='[Missing Given Name]'
;;no-record-text='[Missing Record]'
;;no-surname-text='[Missing Surname]'
;;nprefix='N%04d'
;;online-maps=0
;;oprefix='O%04d'
;;paper-metric=0
;;paper-preference='Letter'
;;patronimic-surname=0
;;place-auto=1
;;place-format=0
;;pprefix='P%04d'
;;private-given-text='[Living]'
;;private-record-text='[Private Record]'
;;private-surname-text='[Living]'
;;quick-backup-include-mode=0
;;rprefix='R%04d'
;;sprefix='S%04d'
;;tag-on-import=0
;;tag-on-import-format='Imported %Y/%m/%d %H:%M:%S'
;;use-last-view=0

[researcher]
;;researcher-addr=''
;;researcher-city=''
;;researcher-country=''
;;researcher-email=''
;;researcher-locality=''
;;researcher-name=''
;;researcher-phone=''
;;researcher-postal=''
;;researcher-state=''

[spacing]
dbman=[22.605613425925927, 5.877459490740741, 9.856047453703704]

[test]
;;january='January'

[utf8]
;;baptism-symbol='~'
;;birth-symbol='*'
;;buried-symbol='[]'
;;cremated-symbol='⚱'
;;dead-symbol='✝'
;;death-symbol=2
;;divorce-symbol='o|o'
;;engaged-symbol='o'
;;in-use=0
;;killed-symbol='x'
;;marriage-symbol='oo'
;;partner-symbol='o-o'
;;selected-font=''
</pre>

====Advanced backup filename setting====
You can also define the naming pattern for the backup filename by setting the ''<code>paths.quick-backup-filename</code>'' in the <code>~/.gramps/gramps60/gramps.ini</code> key file like the following:
{{-}}
[paths]
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'

by removing the two semicolons(<code>;;</code>) from the front of INI key line and using use any of the following keywords for the filename pattern:
*filename
*year
*month
*day
*hour
*minutes
*seconds
*extension :
**'''.gpkg'''(default) if you include media.
**''.gramps'' if you exclude media.

Use the appropriate ~/.gramps/gramps{XX}/gramps.ini key file.
*Gramps version 6.0 :
~/.gramps/gramps60/gramps.ini

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Command_Line#Configuration_.28config.29_option]]
* [[Install_latest_BSDDB#Make_Gramps_use_bsddb3]]
* [[Customize_the_Genealogical_Symbols_lookup_table#Genealogy_symbols_preferences]]

===Theme===
The look of Gramps can be changed.

* [[Addon:ThemePreferences|Addon:Theme Preferences]]
* [[Windows_AIO_themes]]
* [[GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme|GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion]]
* [[Overrule_Gramps_Icons]] - for older Gramps versions.
* [[UI style]]

Some reports can also be changed:

* [[Website report Themes]]
{{-}}
{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

Gramps 6.0 Wiki Manual - Settings

2026-07-21T23:06:46Z

Sam888: /* Advanced manipulation of settings */ https://github.com/gramps-project/gramps/pull/2469 added for 6.1 release

{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{#vardefine:chapter|15}}
{{#vardefine:figure|0}}
This section deals with settings you can manage within Gramps either in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog or [[Gramps_6.0_Wiki_Manual_-_Settings#Other_settings|other various settings]]. As well as various ways of [[Gramps_6.0_Wiki_Manual_-_Settings#Customizing|customizing]] Gramps.

== Preferences ==
[[File:EditPreferencesTabsOnly-overview-60.png|center|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all default Preferences tabs]]

Most of the settings affecting the entire Gramps program are configured in the {{man label|Preferences}} dialog. To invoke it, select the menu {{man menu|Edit ➡ Preferences...}} or select the {{man button|[[Gramps_6.0_Wiki_Manual_-_Navigation#Open_Preferences|Open Preferences]]}} icon on the toolbar.

There are overrides that can be set ''before'' running Gramps (such setting the Language shown in the interfaces or for reports) that can be set temporarily or permanently from the [[Gramps_6.0_Wiki_Manual_-_Command_Line|command line interface]].

For configuration options that are limited to the current view or Gramplet set, choose via the menu {{man menu|View ➡ Configure View...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The tabs on the top display the available option categories as follows:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#General|General]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree|Family Tree]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Import|Import]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Limits|Limits]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Genealogical Symbols|Genealogical Symbols]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#ID_Formats|ID Formats]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Text|Text]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Warnings|Warnings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Researcher|Researcher]]}}

Also ''other'' additional tabs maybe shown from any [[6.0_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== Data ===
[[File:EditPreferences-Data-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab defaults]]
The {{man label|Data}} tab contains preferences relevant to the following two sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Input_Options|Input Options]]}}
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Display Options" section defaults]]
The {{man label|Display Options}} section contains the following options:

*{{checkbox|1}}{{man label|Automate Place format:}} This option controls the display of places. {{man tooltip|Enables automatic place title generation using specified format.}} This feature was labeled as "Enable automatic place title generation" in the 5.0 revision and as "Place format(auto place title)" in the 5.1 revision. The [[Gramps_4.1_Wiki_Manual_-_What%27s_new%3F#Place_hierarchies|hierarchy of Places]] was new in the [[Template:Releases/4.1.0|4.1.0]] revision and the [[Gramps_4.2_Wiki_Manual_-_Settings#Places|Places tab]] of Preferences only existed in the 4.2 version. Major revisions are expected for Place hierarchies so this interfaces is likely to relocated and renamed again.
** '''Full''' (default)
*** Selecting the {{man button|Edit...}} button will show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]}}
*{{man label|Coordinates format:}} This option controls the display of Coordinates. (See [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]])
** '''DEG Degree,minutes,seconds notation''' (default)
** DEG-: degree, minutes, seconds notation with :
** D.D4 degree notation, 4 decimals
** D.D8 degree notation, 8 decimals (precision like ISO-DMS)
** RT90 Output format for the [https://en.wikipedia.org/wiki/Swedish_grid Swedish coordinate system RT90]
*{{man label|Name format:}} This option controls the display of names in the current database (the setting is saved in the database and is not system wide). In Gramps there are two type of name display formats: the predefined formats, and the user defined custom formats{{man label|Custom name display options are unique to each family tree.}}. Several different predefined name formats are available: '''"Surname, Given Suffix"''' (default), ''"Given Surname Suffix"'', ''"Given"'', ''"Primary[sur] Primary[con] NotPatronymic, Given Patronymic[sur] Suffix Primary[pre]"''
** Clicking on the right hand side {{man button|Edit...}} button will bring up a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}} window where the available list of options is shown. The format is given as well as an example. When predefined formats are not suitable one can define one's own format. You can use the {{man button|Add}} button to add a Name format to the list. Clicking once will give you a '''SURNAME,Given Suffix(call)''' format and as example : '''SMITH, Edwin Jose Sr (Ed)'''. If you added new name formats to the list the {{man button|Remove}} and {{man button|Edit}} buttons become available to change the name format list.
***{{checkbox|0}}{{man label|Consider single pa/matronymic as surname}}: Checkbox unselected by default. If selected enables Gramps to consider patronymic and matronymic names as surnames.

{{man note|1=Besides this database-wide setting|2=Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]]}} dialog}}

*{{man label|Date format *:}} This option controls the display of dates. It is a global setting, requiring a restart of Gramps to take effect, and applies to the display of dates in all databases loaded within Gramps until such time as the date display format is changed again. Several different formats are available, which may be dependent on your locale. {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new date display format}}
** '''YYYY-MM-DD (ISO)''' (default) - Example 2020-09-30 - Displays the date using the international standard [https://wikipedia.org/wiki/ISO_8601 ISO 8601 Data elements and interchange formats – Information interchange] particularly useful when sharing data between countries with different conventions for writing numeric dates and times.
** Numerical
** Month Day, Year
** MON DAY, YEAR
** Day Month Year
** DAY MON YEAR

*{{man label|Age display precision *:}} {{man menu|Please note that once changed, it is necessary to restart Gramps to view the new Age precision format}}
** '''Years''' (default)
** Years, Months
** Years, Months, Days
*{{checkbox|1}}{{man label|Round the year}}
*{{checkbox|1}}{{man label|Display ages for events after death *}} {{man menu|Please note that once changed, it is necessary to restart Gramps to see the change.}}

*{{man label|Calendar on reports:}} '''Gregorian''' (default). This option controls the display of calendar on reports, tools, gramplets, views. Several different calendars are available (see [[Gramps_6.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_1#Editing_dates|Date Edition]]). Two dates with two different calendars will not properly display timeline or period, (e.g. Using the Gregorian calendar as the default displayed calendar, users will have a better coherency for displaying dates on period).
*{{man label|Calendar on input:}} '''Gregorian''' (default).
*{{man label|Show leap day anniversaries:}} '''On the previous day''' (default). {{man tooltip|For non leap years, anniversaries are displayed on either February 28, March 1 or not at all in Gregorian calendars}}

*{{man label|Status bar:}} This option controls the information displayed in the status bar. This can be either the '''[[Gramps_Glossary#active_person|Active Person]]'s name and ID''' (default) or '''Relationship to [[Gramps_Glossary#home_person|home person]]'''.

*{{man label|Citation formatter:}} '''Legacy''' (default). Select from the available plugins for composing and display of Citation data. The built-in "Legacy" [[Addon_list_legend#cite|CITE plugin]] is compatible with versions 5.1.6 and earlier.

===== Place Format Editor =====
[[File:EditPreferences-Data-tab-DisplayOptions-section-PlaceFormatEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place Format Editor - dialog (default) from Menu: "Edit > Preferences..." - "Data" tab "Display Options" section]]

The {{man label|Place Format Editor}} dialog contains preferences relevant to how Places should be shown.

The {{man label|Place Format Editor}} dialog can be accessed from the {{man menu|Edit > Preferences...}} - "Data" tab in the [[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]] section via the {{man button|Edit}} button on the {{man label|[] Automate Place Format}} option.

The {{man label|Place Format Editor}} dialog allows you to create custom Place formats by using the {{man button|Add}} button in the left column and choosing how each part of the Place shown should be displayed based on the following settings:

*{{man label|Name:}} <code>New</code> (by default) - A name for the place format strongly suggest you change this to be unique.
*{{man label|Levels:}} <code>:</code> (default colon ":" meaning display all of the place name ) - Select the hierarchy levels of the place names to be displayed.
** Each level in the hierarchy is represented by a positive integer, starting with 0 for the selected place and increasing by 1 for each level up the hierarchy. The levels can also be represented by negative integers, starting with -1 for the top level (usually a country) and decreasing by 1 for each level lower in the hierarchy. In addition, the populated place (city, town, village or hamlet) is represented by the letter p; this can be used with an offset (e.g. p+1 or p-2).
** The names to be displayed are defined as a comma-separated list of ranges. A range can either be a single level, or a start level and an end level separated by a colon. The start level must be less than the end level in a range. The start and end levels default to 0 and -1 if missing.
*{{man label|Street format:}} - Optionally concatenate the number and street in order to suppress the comma.
** '''None''' (default) - Display as is.
** ''Number Street'' - For these options to work, the street must have the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''']] ''Street'' and house number must have the '''Type''' ''Number''.
** ''Street Number'' - as per ''Number Street''
*{{man label|Language:}} (Empty by Default) A [https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes two-digit language code].
*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)

You can remove a custom place format using the {{man button|Remove}} button.

The {{man label|Place Format Editor}} has one pre-defined format named '''Full''' by default.

{{man note|Creates a <code>place_formats.xml</code> file in your Gramps User directory|Not backed up see: [[Template:Backup_Omissions]]}}

See also:
* [https://github.com/gramps-project/gramps/pull/368 Implement place formats #368]
* [[Hierarchical Place Structure]]
* https://gramps-project.org/wiki/index.php/GEPS_045:_Place_Model_Enhancements_-_Place_Changes_Screenshots#Enhanced_Place_Format_Editor
* [https://sourceforge.net/p/gramps/mailman/message/36637553/ (Gramps-users) Proposed place formatting dialogs] From: Nick Hall. - 2019-04-11
* https://sourceforge.net/p/gramps/mailman/message/36422019/
* https://sourceforge.net/p/gramps/mailman/message/36363239/
* https://sourceforge.net/p/gramps/mailman/message/35694337/
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name Editor dialog]]
{{-}}
====== Example Place Formats ======
{{stub}}
The editor has a new field called "levels". It allows users to select hierarchy levels in the place loosely based on the python string slicing syntax. A number of colon ranges can be specified in a comma-separated list. "0" represents the lowest level - typically a building or street. "-1" represents the highest level - typically a country. The populated place is represented as "p".

For example:
"p:" = Populated place upwards.
"p,-1" = Populated place and country.

Valid options:
* <tt>0 - 9</tt> - Hierarchy Level
* <tt>-</tt> - Negative
* <tt>:</tt> - ??
* <tt>p</tt> - Populated Place
* <tt>,</tt> - comma

Place Format examples
* ["p:" = Populated place upwards]
* ["p,-1" = Populated place and country.]
* [1,p House and city],[p,1 City and house]

It lets you restrict long place descriptions in reports and views. [https://github.com/gramps-project/gramps/pull/368#issuecomment-290886087]

{{-}}

=====Display Name Editor=====

{{man note|1=Custom name display formats are stored in the Family Trees|2=Thus before loading any Family Tree the {{man label|Custom format details}} expander is disabled.}}

[[File:EditPreferences-Data-tab-DisplayOptions-section-DisplayNameEditor-dialog-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Display Name Editor" - dialog (default) from Menu: "Edit>Preferences..." - "Data" tab > "Display Options" section]]
The {{man label|Display Name Editor}} allows you to define custom name formats, that can be shown on reports and charts at a global level or a per person level.

The {{man label|Display Name Editor}} has two section:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference|Help Reference]]}} section shown at the top
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_list|Display Name list]]}} table section

The {{man label|Display Name Editor}} can be accessed from the menu: {{man menu|Edit>Preferences...}} - {{man label|Data}} tab > {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Options|Display Options]]}} sections {{man label|Name format:}} {{man button|Edit...}} button.
{{-}}
======Help Reference======


Display Name Help Reference:
<hr>
The following keywords are replaced with the appropriate name parts:
* '''Given''' - given name (first name)
* '''Title''' - title (Dr., Mrs.)
* '''Call''' - call name
* '''Initials''' - first letters of Given
* '''Prefix''' - all prefixes (von, de)
* '''Surname''' - surnames (with prefix and connectors)
* '''Suffix''' - suffix (Jr., Sr.)
* '''Nickname''' - nick name
* '''Common''' - nick name as first option if it exists, Call as second option, otherwise first of Given
<hr>
:Surname:
* '''Rest''' - non primary surnames
* '''Familynick''' - family nick name
* '''Primary, Primary[pre] or [sur] or [con]'''- full primary surname, prefix, surname only, connector
* '''Patronymic, or [pre] or [sur] or [con]''' - full pa/matronymic surname, prefix, surname only, connector
* '''Notpatronymic'''- all surnames, except pa/matronymic & primary
* '''Rawsurnames'''- surnames (no prefixes and connectors)
<hr>
{{man menu|UPPERCASE versions of these keywords forces uppercase to be displayed.}} Extra parentheses, commas are removed. Other text appears literally.
<hr>
:'''Example:''' Dr. Edwin Jose von der Smith and Weston Wilson Sr (“Ed”) - Underhills 
:''Edwin Jose'': '''Given''', ''von der'': '''Prefix''', ''Smith'' and ''Weston'': '''Primary''', ''and'': <abbr title="a connector">'''[con]'''</abbr>, ''Wilson'': '''Patronymic''', 
:''Dr.'': '''Title''', ''Sr'': '''Suffix''', ''Ed'': '''Nickname''', ''Underhills'' <abbr title="family nick name">'''Familynick'''</abbr>, Jose <abbr title="called (preferred given name)">'''Call'''</abbr>.
<hr>
{{-}}

======Help Reference Example person======
[[File:NameEditor-format_reference_example-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor's - reference person  shown in the [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Name_Editor|Name Editor]] dialog]]

All the fields for the Help Reference '''Example''' person except the Family Nickname can be added in the standard Person Editor dialog. Double-click the Preferred name in Names tab of the Person Editor to access additional fields including: the Family Nick Name, Grouping controls, exception Sorting and Display controls, Date range controls for using a particular name.
{{-}}

======Display Name list======


In this section you can add, remove or edit existing name formats as well as see an example of the formatted name.

Table shows two headings {{man label|Format}} and {{man label|Example}}
* {{man label|Format}} - Based on the name parts shown
* {{man label|Example}} - Displays the name format applied to a ? [[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|builtin reference person]] ?

The List shows four default display name formats they are: 
* ''Surname, Given Suffix'' - displays the name as:
* ''Given Surname Suffix'' - displays the name as:
* ''Given'' - displays the name as: ''Edwin Jose''
* ''xxx''' - displays the name as:

* {{man button|Add}} - a new name format, type the required keywords as needed and press the {{man button|Enter}} key to see the resulting {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Help_Reference_Example_person|Example]]}}
* {{man button|Remove}} - an existing name format (except for the four default name formats )
* {{man button|Edit}} - an existing name format (except for the four default name formats )
{{stub}}
{{-}}

==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "Data" tab "Input Options" section defaults]]

*{{man label|Surname guessing:}} This option affects the initial family name of a child when they are added to the family tree.
** '''Father's surname''' (default) - will use the family name of the father.
** ''None'' - means that no surname guessing will be attempted.
** ''Combination of mother's and father's surname'' - will use the father's name followed by the mother's name.
** ''[https://wikipedia.org/wiki/Icelandic_name Icelandic style]'' - will use the father's given name followed by the "sson" suffix (e.g. the son of Edwin will be guessed as Edwin''sson'').

{{man tip|1=Tip |2=The {{man label|Surname guessing:}} option only affects the initial family name guessed by Gramps when the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog is launched from a {{man label|Family Editor}} window.
You can modify that name any way you see fit. Set this Preferences [[Gramps_6.0_Wiki_Manual_-_Settings#Display|Display tab]] option to the value that you will most frequently use, as it will save you a lot of typing.

See:
* [https://gramps-project.org/bugs/view.php?id=1715 feature request to support other local variations for surname guessing]
* [https://wikipedia.org/wiki/Category:Names_by_country Category:Names by country], From Wikipedia, the free encyclopedia
* [https://wikipedia.org/wiki/Category:Names_by_language Category:Names by language], From Wikipedia, the free encyclopedia}}

*{{man label|Default family relationship:}} - used by the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Family Editor]]}} dialog.
** '''Unknown''' (default)
** ''Married''
** ''Unmarried''
** ''Civil Union''

*{{checkbox|0}}{{man label|Hide LDS tab in [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS|person]] and [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS_2|family]] editors}}: Latter Days Saints
{{-}}

=== General ===
[[File:EditPreferences-General-tab-EnviromentSettings-section-default-60.png|Right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit -> Preferences..." "General" tab "Environment Settings" section defaults]]

This tab contains one section containing preferences relevant to the general operation of the program.

==== Environment Settings ====
*{{checkbox|0}}{{man label|Display Tip of the Day}}: This checkbox option controls the enabling and disabling of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tip_of_the_Day_dialog|Tip of the Day]]}} dialog at startup. {{man tooltip|Show useful information about using Gramps on startup.}}
*{{checkbox|0}}{{man label|Remember last Family Tree}}: Selecting this checkbox option causes the last used database to load upon start. It bypasses the '''Manage Family Trees''' dialog.
*{{checkbox|0}}{{man label|Remember last view displayed}}: This checkbox option controls the enabling and disabling of the display of the last [[Gramps_Glossary#view|View]]. Enabling will bring you to the view where you stopped the program the last time. {{man tooltip|Remember last view displayed and open it next time.}}
*{{checkbox|0}}{{man label|Enable spell checker}}: This checkbox option controls the enabling and disabling of the global spelling checker for notes. The '''[https://gitlab.gnome.org/GNOME/gspell gspell]''' package must be loaded for this to have an effect.[https://github.com/gramps-project/gramps/pull/1450] ( See: [[Troubleshoot Spellcheck]] ) {{man tooltip|Enable the spelling checker for notes.}} (Note the Edit>preferences option enables global English or the language your Gramps is run in and the note context menu is per note in the selected Language of your choice)

*{{checkbox|1}}{{man label|Show text label beside Navigator buttons *}} ''checked'' (default) This checkbox controls whether or not a text description is displayed next to the icon in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Navigator|Navigator]] in the [[Gramps_6.0_Wiki_Manual_-_Main_Window#Main_Window|Main Window]]. This option takes effect after the program has been restarted. {{man tooltip|Show or hide text beside Navigator buttons (People, Families, Events...). Requires Gramps restart to apply.}}

*{{checkbox|1}}{{man label|Show Clipboard icon on toolbar}}
*{{checkbox|1}}{{man label|Show Reports icon on toolbar}}
*{{checkbox|1}}{{man label|Show Tools icon on toolbar}}
*{{checkbox|1}}{{man label|Show Addons icon on toolbar}}
*{{checkbox|1}}{{man label|Show Preferences icon on toolbar}}
*{{man label|Toolbar Style:}} {{man tooltip|Display text, icons or both on the toolbar buttons.}}
** '''Both text and icons''' (default)
** ''Text only''
** ''Icons only''
*{{checkbox|1}}{{man label|Show close button in gramplet bar tabs}} ''checked''(default) {{man tooltip|Show close button to simplify removing gramplets from bars.}}

*{{man label|Markup for invalid date format:}} Default: <code>%s</code>
** Convenience markups are:
*** Bold (Default)
*** <big><big>Makes font relatively larger</big></big>
*** Italic
*** <s><s>Strikethrough</s></s>
*** Subscript
*** Superscript
*** Makes font relatively smaller
*** <tt><tt>Monospace font</tt></tt>
*** Underline
**** For example: %s will display Underlined bold date.

*{{man label|Multiple surname box height:}} Default: <code>150</code> Pixels {{man tooltip|Enter height in pixels. When multiple surnames are entered, these names display in a box. This setting sets the size of this box.}}

====Tip of the Day dialog====

[[File:TipOfTheDay-dialog--example-PrivacyInGramps-60.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog - example]]

When enabled in {{man menu|Edit > Preferences}} {{man label|General}} tab the {{man label|Tip of the Day}} dialog shows helpful hints.

The following options are available:
*{{checkbox|1}} {{man label|Display on startup}} (check box checked by default - once enabled) - uncheck to stop further tips appearing.
*{{man button|Forward}} - Advance to the next tip.
*{{man button|Close}} - exit for this session until the Gramps program is restarted.
[[Category:Tips]]

{{-}}

=== Family Tree ===
[[File:EditPreferences-FamilyTree-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - defaults]]
The {{man label|Family Tree}} tab contains the following four sections:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Database_Location|Database Location]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}}

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a family tree]] - more information on backups
* [[Template:Backup_Omissions|Backup omissions]] - what is not included during a backup
{{-}}
====Database Settings====
[[File:EditPreferences-FamilyTree-tab-DatabaseSetting-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Settings" section defaults]]

*{{man label|Database backend:}} -
** '''[[Gramps_Glossary#sqlite|SQLite]]''' (''default'') - the [[DB-API Database Backend]]
** When multiple database backends are installed, they will be included in this list. <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr> backends: [[Addon:PostgreSQL|PostgreSQL]], SharedPostgreSQL, MongoDB. This menu can be trimmed by 'hiding' the unwanted database backends in the Plugin Manager.

{{man tip|Converting Trees from the retired BSDDB backend|The BSDDB backend developed incompatibilities as Python libraries evolved. That backend choice (as ''default'') was supseded with SQLite in Gramps 5.2 and has been retired (to read-only status) as of the Gramps 6.0 release. Although BSDDB '''''was''''' the default backend default in Gramps 2.0 through Gramp 5.1, all Gramps Trees should be converted another database backend at the earliest opportunity. '''[[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Make a backup]] before any critical change.''' To convert a Tree, first select the target database backend in Preferences, then use the '''Convert''' button for the selected tree in the '''Family Tree ‐> Manage Family Trees''' dialog.}}

See also:
* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds experimental support for PostgreSQL databases. Recommended for Experts only!

{{-}}

====Database Location====
[[File:EditPreferences-FamilyTree-tab-DatabaseLocation-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Database Location" section defaults]]
*{{man label|Host:}} - Server address or other computer IP address for the location of the database.
*{{man label|Port:}} - Port number to access the Host database
*{{man label|Database path:}} Unless you have a definite reason to change this, stay with the default path. The default path where databases are stored is <code>grampsdb</code> within the [[Gramps_6.0_Wiki_Manual_-_User_Directory|User Directory]].
{{-}}

====Backup Management====
[[File:EditPreferences-FamilyTree-tab-BackupManagement-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Backup Management" section defaults]]
*{{man label|Backup path:}} - Location in which to save your Gramps backup archive files.
*{{checkbox|1}}{{man label|Backup on exit}} - Selecting this option will Backup Your family tree upon choosing to exit Gramps. The file be saved to the Backup path specified above. The filename of the backup will match the Family Tree appended with a date and time.
*{{man label|Autobackup:}} timer interval for triggering full backups during Gramps editing sessions.
** '''Never''' (''default'')
** Every 15 minutes
** Every 30 minutes
** Every hour
** Every 12 hours
** Every day
{{-}}

====Family Tree's Media path====
[[File:EditPreferences-FamilyTree-tab-FamilyTreesMediaPath-section-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: {{man menu|Edit>Preferences...}} - "Family Tree" - tab - "Family Tree's Media path" section defaults]]
*{{man label|Base media path:}} Here you can fill in a base path for the media objects.
** Selecting the {{man button|Directory}} button gives you a {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Select_media_directory_dialog|Select media directory]]}} dialog where you can fill in the required path.

{{man tip|The base relative media path is specific to the active family tree.|It is not a global setting in Gramps. Each family tree is able to have a unique media base path that is stored with the database.}}

{{man tip|To make media paths relative|You also need to select the {{man label|[ ] Convert to a relative path}} checkbox, at the bottom of the {{man label|[[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_a_media_object_selector|Select a media object selector]]}} dialog. Once checked for the first time it will be remembered for each subsequent media selection.}}

See also:
*[[Gramps_6.0_Wiki_Manual_-_Tools#Media_Manager|{{man label|Gramps Media Manager}}]] a group of four separate tools two of which allow you to:
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_6.0_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}

{{-}}
=====Select media directory dialog=====

{{stub}}

See [[Gramps_6.0_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}

=====Missing Media Objects 'broken link' icon of a box with a red 'x'=====
[[File:BrokenMediaPath-example-60.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media object with a broken filepath]]

If the Preview thumbnails displays 'broken link' icon of a box with a red 'x' you will need to correct {{man label|Base media path:}} for your family tree in the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section.

See also:
* Example.gramps - [[Example.gramps#Connecting_to_the_example_Media_Objects|Connecting to the example Media Objects]]
* [[Addon:Media_Verify_Tool|Media Verify Tool]] addon tool for revalidating media paths
{{-}}
{{stub}}

=== Import ===
[[File:EditPreferences-Import-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Import" - tab - defaults]]
The {{man label|Import}} tab has two sections as follows:
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Tag_Records|Tag Records]]}}
* {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Source_GEDCOM_import|Source GEDCOM import]]}}

==== Tag Records ====

*{{checkbox|0}}{{man label|Add tag on import}}: Checkbox (Default: <code>Imported %Y/%m/%d %H:%M:%S</code> ) ''' {{man tooltip|Specified tag will be added on import. Clear to set default value.}} Note - Adding a timestamped [[Gramps_Glossary#tag|Tag]] on import can significantly slow down the importing of your data, but are helpful for the ensuing data cleanup.'''

==== Source GEDCOM import ====

*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_import|GEDCOM data]]. If this is set, each item that is imported will contain a [[Gramps_Glossary#source|Source]] reference to the imported file. '''Note - Adding a default source can significantly slow down the importing of your GEDCOM data, but are helpful for the ensuing data cleanup.'''

{{-}}

=== Limits ===
[[File:EditPreferences-Limits-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Limits" - tab - defaults]]

Settings used for calculation operations of dates, ages and generations.

See also:
* [[Gramps 6.0 Wiki Manual - Probably Alive]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_dates|Editing dates]]
* Setting the [[Match_dates#Changing_after.2Fbefore.2Fabout_range|date approximation .ini]] manually

==== Calculation limits ====

*{{man label|Date 'about' year range: (date ± #):}} Default: <code>50</code>
** Defines the number of years +/- of the event date "<code>about <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'after' year range: (date + #):}} Default: <code>50</code>
** Defines the number of years after the event date "<code>after <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Date 'before' year range: (date - #):}} Default: <code>50</code>
** Defines the number of years before the event date "<code>before <date></code>" that the event will return as valid for a filter.
** Used in the calculation of the person's age.
*{{man label|Maximum age probably alive:}} Default: <code>110</code>
** Absent a Death event, the age by which Gramps will consider the person is no longer alive.
*{{man label|Maximum sibling age difference:}} Default: <code>20</code>
*{{man label|Minimum years between generations:}} Default: <code>13</code>
*{{man label|Average years between generations:}} Default: <code>20</code>
*{{man label|Max generations for relationships:}} You can enter the number of generations used to determine relationships. The default value is '''<code>15</code>'''. Limits the scope of features based on the [[Gramps_6.0_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
{{-}}

=== Colors ===
[[File:EditPreferences-Colors-tab-default-60.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - defaults]]

This tab has seven section related to allowing you to set the '''colors used for boxes in the graphical views'''.

Each of the colors can be customized using the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]}}.

==== Colors used for boxes in the graphical views ====

You can select the
* {{man label|Color scheme:}}
** '''Light colors''' (default)
** ''Dark colors''
*** {{man button|Restore to defaults}} - restores themes default colors.

====Colors for Male persons====
* {{man label|Background for Alive:}} [ ] #b8cee6
* {{man label|Border for Alive:}} [ ] #1f4986
* {{man label|Background for Dead:}} [ ] #b8cee6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Female persons====
* {{man label|Background for Alive:}} [ ] #feccf0
* {{man label|Border for Alive:}} [ ] #861f69
* {{man label|Background for Dead:}} [ ] #feccf0
* {{man label|Border for Dead:}} [ ] #000000

====Colors for people who are neither male nor female====
* {{man label|Background for Alive:}} [ ] #94ef9e
* {{man label|Border for Alive:}} [ ] #2a5d16
* {{man label|Background for Dead:}} [ ] #94ef9e
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Unknown persons====
* {{man label|Background for Alive:}} [ ] #f3dbb6
* {{man label|Border for Alive:}} [ ] #8e5801
* {{man label|Background for Dead:}} [ ] #f3dbb6
* {{man label|Border for Dead:}} [ ] #000000

====Colors for Family nodes====
* {{man label|Default background:}} [ ] #eeeeee
* {{man label|Default border:}} [ ] #cccccc
* {{man label|Background for Married:}} [ ] #eeeeee
* {{man label|Background for Unmarried:}} [ ] #eeeeee
* {{man label|Background for Civil Union:}} [ ] #eeeeee
* {{man label|Background for Unknown:}} [ ] #eeeeee
* {{man label|Background for Divorced:}} [ ] #eeeeee
* {{man label|Border for Divorced:}} [ ] #ff7373

====Other colors====
* {{man label|Background for Home Person:}} [ ] #bbe68a
{{-}}

=== Genealogical Symbols ===
{{stub}}
{{man warn|Prerequisites exist for this feature|The Genealogical Symbols tab can only be used if the [[#Prerequisite_to_use_Genealogical_Symbols|prerequisite]] program <code>[[#Prerequisite_to_use_Genealogical_Symbols|python-fontconfig]]</code> is present that Gramps can use.}}

[[File:EditPreferences-GenealogicalSymbols-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Genealogical Symbols" - tab - defaults]]

Allows you to use Genealogical symbols instead of text abbreviations in reports, charts and the Gramps interface.

This tab gives you the possibility to use one font which is able to show all genealogical symbols. (Once configured see: [[#Prerequisite_to_use_Genealogical_Symbols|Prerequisite to use Genealogical Symbols]])

If you select the "{{man label|Use symbols}}" checkbox, Gramps will use the selected font if it exists.

This can be useful if you want to add phonetic in a note to show how to pronounce a name or if you mix multiple languages like Greek and Russian.

You can only configure the death symbol from this tab.

:List of Genealogical Symbols shown (listed in order shown at bottom of screenshot):

* Female
* Male
* Asexuality, sexless, genderless
* Lesbianism
* Male homosexuality
* Heterosexuality
* Transgender, hermaphrodite (in entomology)
* Transgender
* Neuter

* Illegitimate
* Birth
* Baptism/Christening
* Engaged
* Marriage
* Divorce
* Unmarried partnership
* Buried
* Cremated/Funeral urn
* Killed in action
* Extinct

* Death

{{-}}

{| class="wikitable"
|-
! meaning
! symbol
! Unicode code point(s)
! name
|-
! male
| ♂
| U+2642
| Male Sign
|-
! female
| ♀
| U+2640
| Female Sign
|-
! unknown
| ⚪︎
| U+26AA
| Medium White Circle
|-
! hermaphrodite
| ⚥
| U+26A5
| Interlocked Male and Female Sign
|-
! neuter
| ⚲
| U+26B2
| Neuter

|-
! birth
| *
| U+002A
| Asterisk
|-
! baptisation, christening
| ~
| U+007E
| Tilde
|-
! death
| ✝︎
| U+271D
| Latin Cross
|-
! burial
| ⚰︎
| U+26B0
| Coffin
|-
! cremation
| ⚱︎
| U+26B1
| Funeral Urn
|-
! stillborn
| ✝︎*
| U+0086 U+002A
| Latin Cross, Asterisk
|-
! born illegitimately
| *⃝
| U+002A U+20DD
| Circled Asterisk
|-
! born illegitimately
| ⊛
| U+229B
| Circled Asterisk Operator
|-
! killed in action
| ⚔︎
| U+2694
| Crossed Swords
|-
! this line extinct
| ‡
| U+2021
| Double Dagger
|-
! approximate(ly)
| ±
| U+00B1
| Plus-Minus
|-
! before
| <
| U+003C
| Less-Than Symbol
|-
! after
| >
| U+003E
| Greater-Than Symbol

|-
! engaged
| ⚬
| U+26AC
| Medium Small White Circle
|-
! married
| ⚭
| U+26AD
| Marriage Symbol
|-
! divorced
| ⚮
| U+26AE
| Divorce Symbol
|-
! unmarried
| ⚯
| U+26AF
| Unmarried Partnership Symbol
|}
{{-}}
====Prerequisite to use Genealogical Symbols====
{{stub}}
[[File:EditPreferences-GenealogicalSymbols-tab-default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences tab - defaults]]

=====Initial setup=====

If the fontconfig [[Gramps_6.0_Wiki_Manual_-_Settings#Prerequisite|prerequisite has been installed]], then on the {{man label|Genealogical Symbols}} tab select the {{man button|Try to find}} button, Gramps will attempt to detect any suitable unicode text fonts that can be used.

[[File:EditPreferences-GenealogicalSymbols-FindFont-51.png|center|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Finding fonts]]

When the search has completed select one of the fonts from the {{man button|Choose font}} list and then select the checkbox:

{{checkbox|1|Use symbols}}

=====Prerequisite=====
Prerequisite : '''python-fontconfig''' : Python bindings of fontconfig and its dependencies are required for displaying genealogical symbols
{{man note|Use the [[Addon:Prerequisites_Checker_Gramplet|Prerequisites Checker]]|Do you have <code>python-fontconfig</code> installed? Run the Prerequisites Checker Addon and look for something similar to the following line:<pre>* python-fontconfig 0.5.0 (Success version 0.5.x is installed.)</pre>}}

See also:
* Tamura Jones expounds on [https://www.tamurajones.net/GenealogySymbols.xhtml Genealogical Symbols] ''(the 'Unicode' section is particularly relevant)''
* [[GEPS 039: Genealogical symbols in gramps]]
* Feature request: {{bug|9098}} Gramps should be able to use genealogy symbols everywhere.
* [[Customize the Genealogical Symbols lookup table]] located in the [[Gramps_6.0_Wiki_Manual_-_User_Directory#MS_Windows|Gramps user directory]] at: [https://github.com/gramps-project/gramps/blob/maintenance/gramps51/gramps/gen/utils/symbols.py gramps\gen\utils\symbols.py]
{{-}}

=== ID Formats ===
{{man tip|ID Prefixes |The ID prefixes use formatting conventions common for C, Python, and other programming languages. For example, the <code>%04d</code> expands to an integer, prepended with zeros to have the total width of four digits. If you would like IDs to be 1, 2, 3, etc., simply set the formatting parameter to <code>%d</code>, the 'd' specifies Decimal Integer, outputting the number in base 10. See: Python [https://docs.python.org/3/library/string.html#format-specification-mini-language (String) Format Specification Mini-Language]}}

[[File:EditPreferences-IDFormats-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "ID Formats" - tab - defaults]]

This tab contains preferences relevant to the automatic generation of Gramps IDs.

*{{man label|Person:}} Provides the template for generating IDs for a Person. Default value: <code>I%04d</code>
*{{man label|Family:}} Provides the template for generating IDs for a Family. Default value: <code>F%04d</code>
*{{man label|Place:}} Provides the template for generating IDs for a Place. Default value: <code>P%04d</code>
*{{man label|Source:}} Provides the template for generating IDs for a Source. Default value: <code>S%04d</code>
*{{man label|Citation:}} Provides the template for generating IDs for a Citation. Default value: <code>C%04d</code>
*{{man label|Media Object:}} Provides the template for generating IDs for a Media Object. Default value: <code>O%04d</code>
*{{man label|Event:}} Provides the template for generating IDs for an Event. Default value: <code>E%04d</code>
*{{man label|Repository:}} Provides the template for generating IDs for a Repository. Default value: <code>R%04d</code>
*{{man label|Note:}} Provides the template for generating IDs for a Note. Default value: <code>N%04d</code>

You can use the [[Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}

=== Text ===

[[File:EditPreferences-Text-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Text" - tab - defaults]]

This tab contains one section {{man label|Conditional Text Replacements}} with preferences relevant to how missing and private names and records should be shown.

==== Conditional Text Replacements ====

*{{man label|Missing surname:}} in the input field you can determine how a missing surname should be displayed. Default value is '''<code>[Missing Surname]</code>'''. You can change this to [--] or whatever is most convenient for you.
*{{man label|Missing given name}} in the input field you can determine how a missing given name should be displayed. Default value is '''<code>[Missing Given Name]</code>'''. You can change this to whatever you want.
*{{man label|Missing record:}} Default: <code>[Missing Record]</code>
*{{man label|Private surname:}} Default: <code>[Living]</code>
*{{man label|Private given name:}} Default: <code>[Living]</code>
*{{man label|Private record:}} Default: <code>[Private Record]</code>
{{-}}

=== Warnings ===
[[File:EditPreferences-Warnings-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]

This tab has one section {{man label|Warnings and Error dialogs}} that controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.

See the [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
==== Warnings and Error dialogs ====
*{{checkbox|0}}{{man label|Suppress warning when adding parents to a child.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_adding_parents_to_a_child|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning when cancelling with changed data.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_when_cancelling_with_changed_data|Dialog]])
*{{checkbox|0}}{{man label|Suppress warning about missing researcher when exporting to GEDCOM.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Suppress_warning_about_missing_researcher_when_exporting_to_GEDCOM|Dialog]])
*{{checkbox|0}}{{man label|Suppress tooltip warnings about data being saved immediately.}} Checkbox unchecked by Default
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_6.0_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])
{{-}}

=== Researcher ===
{{man tip|Researcher Information|This contact information is independent of the family trees you create. Most exports and reports will be filtered to protect the privacy of living people of the Tree... including yourself. This information feeds into the authoring and citation features of any publication (or archival) options.}}
[[File:EditPreferences-Researcher-tab-default-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Researcher" - tab - defaults]]

Allows you to {{man label|Enter your information so people can contact you when you distribute your Family Tree}} in the corresponding text entry fields. Although Gramps requests information about you, this information is used only so that Gramps can create valid GEDCOM output files. A valid GEDCOM file requires information about the file's creator. If you choose, you may leave the information empty, however none of your exported GEDCOM files will be valid.

The available text entry fields are (all blank by default):
*{{man label|Name:}}
*{{man label|Address:}}
*{{man label|Locality:}}
*{{man label|City:}}
*{{man label|State/County:}}
*{{man label|Country:}}
*{{man label|ZIP/Postal Code:}}
*{{man label|Phone:}}
*{{man label|Email:}}

The information entered under this preference acts as default value for family tree specific values that can be adjusted with the {{man menu|Tools->Family Tree Processing->[[Gramps_6.0_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information...]]}}.
{{-}}

== Other settings ==

Besides {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]}} dialog, there are other settings available in Gramps. For various reasons they have been made more readily accessible, as listed below.
{{-}}
===Columns editor===

{{man tip|The {{man label|Columns}} editor is available and works in the same way for all list views.|Specifically, it is available for People View, Family View (children list). Sources View, Citations View, Places View, Media View, Repositories View and the Notes View.}}

[[File:ColumnsEditorTab-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Columns''' editor tab - dialog - People Tree View default columns]]

The columns of the list views may be added, removed, or reordered in a {{man label|Columns}} editor dialog.

To use the {{man label|Columns}} editor dialog for the current view, choose via the menu {{man menu|View ➡ Configure...}}, click on [[File:Gramps-config.png|34px]]{{man button|Configure View...}} toolbar button or press the ''Configure active view'' [[Gramps_6.0_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

Only columns with a selected checkbox will be shown in the view. You can also change the position of a column in the View by clicking and dragging it to a new position in the Editor ([https://wikipedia.org/wiki/Drag-and-drop ''drag and drop'']). Once you have made the changes you want click {{man button|Apply}}, then click {{man button|OK}} to exit the Editor and see your changes in the View.

By default, the View List, displays several columns of information about the respective category. You can add or remove columns to and from the display

The default sort key for the view [always ascending] is the left-most field [i.e. at the top in the Columns Editor], so changing which field is in that position affects default sorting. For some views the first field cannot be changed and the reason will be mentioned at the top of the Columns editor.

The {{man label|Columns Editor}} dialog will have a different selection of columns for each category of View that displays a simple table.

Changes will only be enacted when the {{man button|Apply}} button is clicked.

Once the View columns changes have been applied, clicking once on the column header sorts in ascending order, clicking again sorts in descending order.

The subset of columns and the current [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] will also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_6.0_Wiki_Manual_-_Settings#Export_View|Export View...]]}} operation. Hidden columns and records will not be exported.
{{-}}

=== Sorting columns ===

[[File:PersonView-PeopleListView-example-with-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''Before''' - default sort by "Name" column "People" Category - "Person" (List) View]]

[[File:PeopleCategory-PeopleListView-SortedByBirthDateColumn-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} '''After''' - Sorted by "Birth Date" column in the list mode of the People Category View - example]]

By default, each Category View presenting data in a columnated table layout will sort the rows in ascending order based on the data in the first (left-most) column. If the table has grouped rows, the grouped data will be sub-sorted. ''(Tables in tabbed subsets of data, Editors and Selectors will work similarly.)''

Click once on a different column header to sort on the data of that column in ascending order. Click the header again to sort in reverse order.

The {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]]}} dialog can be used to add, remove and rearrange the displayed columns. Choosing a different first column will make that the new default sorting column of the view [though always ascending].
{{-}}

===Setting Home person===
[[File:MenuEdit-SetHomePerson-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu showing ''Set Home Person'']]

To set (designate) the [[Gramps_Glossary#home_person|Home person]], select the People Category and select the desired person to make them into the [[Gramps_Glossary#active_person|Active Person]] and then choose {{man menu|Edit ->Set Home Person}} via the menus.

Alternately, when editing any Person, right-clicking on inactive areas (areas without a text-entry box) of the top section displays a pop-up menu which includes an option to {{man menu|Make Home Person}} of that profile.

The Home person is the persistently designated person who becomes the [[Gramps_Glossary#active_person|Active Person]] when one of the following occurs:
*By default, when the Family tree database is opened ''(The [[Gramps_6.0_Wiki_Manual_-_Settings#General_Gramps_settings|General]] setting in [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]] can modify this default behavior. The "Remember last view displayed" will return to the last [[Gramps_Glossary#active_person|Active Person]] of the previous session.)''
*As the toolbar {{man button|Home}} button is clicked
*When the Home menu item is selected from either the {{man button|Go}} menu or the right-click context menu in selected views
*As the [[Gramps_6.0_Wiki_Manual_-_Keybindings#15|keybinding]] {{Man key press|ALT|Home}} is pressed to return to the '''Home Person'''.

The toolbar {{man button|Home}} button is available in the People Category, Relationships Category, and Charts Category. [[File:Gramps Go-Home48x48 win.png|text-bottom]]
====See also====
* [[Gramps_6.0_Wiki_Manual_-_Navigation#Setting_the_Home_Person|Setting the Home Person]]
{{-}}

===Adjusting viewing controls===

Whether the toolbar, the sidebar, or the filter (not available on Charts and Relationships Views) are displayed in the main window is adjusted through the View menu.

In the different views clicking the {{man menu|[[Gramps_6.0_Wiki_Manual_-_Navigation#View|View]]}} menu will shows for boxes you can click:
*Navigator
*Toolbar
*Sidebar
*Bottombar
*Full Screen {{man key press|F11}}

Additionally, depending on the view you are in, other options will be available on {{man label|Configure}}.

*Gramplets:
**Set Columns to 1
**Set Columns to 2
**Set Columns to 3
*Relationships:
**Show Siblings
**Show Details
*Geography:
**Time period
**Layout

All other Views: the [[Gramps_6.0_Wiki_Manual_-_Settings#Columns_editor|Columns editor]].

===Export View===

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menubar - "Family Trees" - overview example showing "Export View" menu entry]]

On most [[Gramps_6.0_Wiki_Manual_-_Categories#Categories_of_the_Navigator|Category List Views]], displayed data maybe be exported, choose via the {{man menu|Family Trees ->Export View...}} [[Gramps_6.0_Wiki_Manual_-_Navigation#Main_Menus|menu]] command.

This Menu command only appears if the displayed data can be exported. Gramps will export data on screen according your choice: '''CSV''' or '''Open Document''' spreadsheet format.

Note that the current configuration of the View's columns will control what data will be exported. The export will contain only the displayed column data (in the same order) and be limited to records matching any [[Gramps_6.0_Wiki_Manual_-_Filters|filters]] you have applied.

Use the Views [[Gramps_6.0_Wiki_Manual_-_Settings#CSV_Dialect|CSV Dialect]] tab control the type of CSV to be created.
{{-}}
====Export View as Spreadsheet dialog====

[[File:ExportViewAsSpreadsheet-CSV-file-dialog-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Export View as Spreadsheet" CSV(default) filetype - dialog - example]]

Gramps will then display the {{man label|Export View as Spreadsheet}} dialog where after choosing a file location to save to and a name for your file; export data on from the Category List View in one of two spreadsheet formats:
*{{man label|Formats:}}
** '''CSV''' (default)
** '''OpenDocument Spreadsheet''' - ODS format.

{{-}}
[[File:ExportViewAsSpreadsheet-ODS-Displayed-in-LibreOfficeCalc-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Example ODS Spreadsheet - Displayed in LibreOffice Calc]]

The example screenshot shows an export to the '''OpenDocument Spreadsheet''' (ODS format) displayed as a Spreadsheet in LibreOffice Calc.

{{-}}

====CSV Dialect====
[[File:CSV-Dialect-Tab-dialog-example-60.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "CSV Dialect" tab - dialog - example]]

All list table views have a {{man label|CSV Dialect}} tab in the dialog for the {{man menu|View -> Configure...}} menu. You can choose the CSV format's delimiter to be used when exporting and importing data in Gramps.

''Choose your dialect'' from:
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_Dialect|excel]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Excel_tab_Dialect|excel-tab]]}}
*{{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Unix_Dialect|unix]]}}
*{{man label|Custom}}
**{{man label|Delimiter:}}
*** ',' ''comma'' (default)
*** ';' ''semicolon''
*** ':' ''colon''
*** '|' ''bar''
*** 'tab'

CSV stands for '''[https://wikipedia.org/wiki/Comma-separated_values comma-separated values]'''. It is a plain text file format that separate data into columns and rows for simple way to exchange data. Originally, data was limited by being separated into columns by fixed positions in <code>.txt</code> text files. When more flexibility was needed, the comma was chosen as a delimiter to mark the boundaries of the columns and the <code>.csv</code> format of a text file was established. To complicate matters, different Operating System marked their end-of-line and end-of-file with different terminating codes.

When comma was needed too frequently in the data itself, a <code>.tsv</code> (tab-separated-values) file format became popular. When other delimiters began being adopted, rather than use up more file extensions, CSV became synonymous with any text format with delimiter marked columns. They were just different 'dialects' of "CSV".

[https://docs.python.org/3/library/csv.html Python's <code>csv</code> module] provides several pre-defined dialects to simplify reading and writing CSV files. These dialects specify rules for parsing and formatting data. The standard dialects include {{man label|excel}}, {{man label|excel-tab}}, and {{man label|unix}}. The following sections outline each dialect's characteristics, including its separator, line terminator, and quoting behavior.

===== Excel Dialect =====

The {{man label|excel}} dialect is designed to be compatible with CSV files generated by Microsoft Excel. It is suitable for data that has been saved from Excel as comma-separated values.
*Separator:** Comma (<code>,</code>`)
*Line Terminator: Carriage return and line feed (<code>\r\n</code>)
*Quoting:
** Double quotes (<code>"</code>`) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Excel-tab Dialect =====

The {{man label|excel-tab}} dialect is similar to the `excel` dialect but uses tabs instead of commas as the separator. This format is often encountered when copying cell data from Excel to the OS clipboard. Pasting tab separated data into the [[Addon:Import_Text_Gramplet|Import Text]] addon gramplet is one of the quickest way to populate parts of your tree.

* Separator: Tab (<code>\t</code>)
* Line Terminator: Carriage return and line feed (<code>\r\n</code>)
* Quoting:
** Double quotes (<code>"</code>) are used to enclose fields containing the separator or other special characters.
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== Unix Dialect =====

The {{man label|unix}} dialect is designed for use in Unix-like environments. It uses a line feed character as the line terminator and always quotes all fields.

* Separator: Comma (<code>,</code>)
* Line Terminator: Line feed (<code>\n</code>)
* Quoting:
** All fields are enclosed in double quotes (<code>"</code>).
** To include a double quote within a quoted field, it is escaped by doubling it (e.g., <code>""example""</code>).

===== See also: =====
* [https://github.com/gramps-project/gramps/pull/1314 CSV: possibility to select the dialect. #1314 ]
{{-}}

===Modularity and plugins===


Gramps has been designed for expansion. The Plugin (a.k.a. Plug-in, addon, extension) framework provides a path for third party development outside the normal Gramps release distributions.

The documentation for each addon is maintained outside the flow of these main wiki chapters. The interface and functionality of the software and documentation may not conform with the styles seen throughout the rest of Gramps... although we encourage Developers to try to make their additions as seamless as possible.

A brief description and screenshot of each addon can be found in the [[6.0_Addons#Addon_List|Addon List]] section of the wiki manual. The separately maintained documentation page for the addon is linked from the 1st column of that list.

See [[Gramps_6.0_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[6.0 Addons|Third-Party Addons]].
{{-}}

===Customize report output formats===
[[File:TextReports-DocumentOptions-section-PlainText-output-settings-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Options - tab defaults for Text Reports (Plain Text - output selected) example]]

What kind of output customization is available? This dialog allows you to change the fonts, font sizes, font color, background color of the text and alignment of paragraphs on the report.

For most report dialogs, in the top part are option tabs specifically related that particular report. The lower part will have more broadly reusable features and is called the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Document_Options|Document Options]]}} section.

From the {{man label|Style:}} drop down list you can choose an existing custom style. Or to make your own {{man label|Style:}} select the {{man button|Style Editor...}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Document_Styles_dialog|Document Styles]]}} dialog and then select the {{man button|Add a new style}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.

{{stub}}
{{-}}
====Document Styles dialog====

[[File:DocumentStyles-dialog-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Document Styles - dialog - default]]

The {{man label|Document Styles}} dialog, list the ''default'' style and any custom styles for that report and allows you to edit or delete any custom styles you have created. Select the {{man button|+ (Add a new style)}} button to show the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}

====Style editor dialog====
[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

The {{man label|Style editor}} dialog allow you to customize the document style specific to each report.

Change the {{man label|Style sheet name:}} <code>New Style</code> (default) field to a unique name as it will appear in {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Document_Options|Document Options]]}} {{man label|Style:}} drop down list.

Once changes for your custom style have been finalized select the {{man button|OK}} button to save the changes or {{man button|Cancel}} to exit.

=====Style editor dialog tabs=====
On the left hand side you will see the {{man label|Style}} column that list the paragraph options specific to that report that you may modify. For example the {{man label|[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report]]}} shows the style options for <code>AHN-Entry</code>, <code>AHN-Generation</code> and <code>AHN-Title</code>.

On the right hand side are three tabs associated with each style listed in the left hand column:
* [[#Description|Description]]
* [[#Font_options|Font options]]
* [[#Paragraph_options|Paragraph options]]

{{-}}
======Description======

[[File:StyleEditor-dialog-Description-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Description options tab - Document Styles - dialog - default styles for Ahnentafel Report]]

*{{man label|Description}} tab describes what each paragraph is all about. For example shown here is the style used for the Ahnentafel Report ( <code>AHN-Entry</code> ) with the description: ''The basic style used for the text display.''
{{-}}

======Font options======

[[File:StyleEditor-dialog-FontOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Font options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Font options}} tab allows you to set the {{man label|Type face}} ''Roman'' or ''Swiss'', the {{man label|Size}} of the font in pt.(point), the {{man label|Color}} of the font and some {{man label|Options}} like ''Bold'', ''Italic'' or ''Underline''.
{{-}}

======Paragraph options======

[[File:StyleEditor-dialog-ParagraphOptions-tab-example-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Paragraph options" tab - "Style Editor" dialog for "Document Styles" (default styles for Ahnentafel Report)]]

*{{man label|Paragraph options}} tab allows you to set the {{man label|Alignment}}, the {{man label|Background color}}, {{man label|Indentation}}, {{man label|Spacing}} and {{man label|Borders}} of your style.
{{-}}

===Context menu===
[[File:Clipboard-dialog-example-context-menu-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Clipboard - with example contextual pop-up menu from right-clicking a Family]]
[[Gramps_6.0_Wiki_Manual_-_Main_Window#Pop-up_menus|Pop-up menus]] are used in various places in Gramps; how you access the context menu is dependent on your operating systems:
* On Microsoft windows, you generally use the right button of your mouse to show the context menu or use the keyboard shortcut {{man button|Shift}}+{{man button|F10}}. see [https://docs.microsoft.com/en-us/previous-versions/windows/desktop/mpc/using-context-menus Using Context Menus - Microsoft Docs]
* On Apple macOS, you generally press {{man button|Ctrl}} while clicking the button of your mouse to show the context menu. see: [https://developer.apple.com/design/human-interface-guidelines/macos/menus/contextual-menus/ Contextual Menus - Menus - macOS - Human Interface Guidelines - Apple Developer]

List of known Context menus in Gramps:
* Pedigree View Context menus
* Clipboard context menu
* File Chooser - Context Menu options
* <Category view> context menus
* Manage Books dialog 
* ... and many more
{{stub}}

See also:
* [[Gramps 6.0 Wiki Manual - Keybindings|Keybindings]]

=== Selector dialogs ===
[[File:SelectFamily-SelectorDialog-example-60.png|450px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]] - showing Search Bar]]


Selector dialogs are a combo interface box and you generally use then to select an object (Person/Family/Events etc). Also various {{man label|Selectors}} also have search bars:
* [[Gramps_6.0_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Event_selector|Select Event selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Note_selector|Select Note selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Person_selector|Select Person selector]]
*[[Gramps_6.0_Wiki_Manual_-_Reports_-_part_4#Select_a_person_for_the_report_selector|Select a person for the report selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Father_selector|Select Father selector]] (filtered to Father)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Mother_selector|Select Mother selector]] (filtered to Mother)
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Child_selector|Select Child selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Select_Media_Object_selector|Select Media Object selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Place_selector|Select Place selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Repository_selector|Select Repository selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_or_Citation_selector|Select Source or Citation selector]]
* [[Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Select_Source_selector|Select Source selector]]

{{-}}
See also
* [https://gramps-project.org/wiki/index.php/GEPS_041:_New_Selector GEPS_041:_New_Selector]
* [[Gramps_6.0_Wiki_Manual_-_Settings#Pick_a_Color_selector|Pick a Color selector]]

{{stub}}

== Customizing ==
Here are some ways that you can customize Gramps.
=== Preferences ===

In the "Display Options" section of the Edit>Preferences {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Data|Data]]}} tab you can select the Name format used by default throughout Gramps. The Edit button for the {{man label|Name format:}} opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Display Name Editor]]}}, allowing the creation of user-defined (custom) stylings beyond the pre-defined (built-in) name format choices.

See [[Gramps_6.0_Wiki_Manual_-_Settings#Preferences|Preferences]]

The Edit button for a person's preferred and alternative names opens the {{man label|[[Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor|Name Editor]]}}, allowing the selection of a name format exceptions that will override the format chosen in the Display tab of Preferences for the entire Tree.

The name format, grouping and sorting can be overridden for selected individuals and surnames. The Edit Person dialogs have two Edit buttons to access this feature. The button for Preferred name is to the right of the Suffix field. However, for any selected Name (Preferred or Alternative) in the Names tab which opens the Name Editor. The built-in and custom Display Name formats can be selected exceptions to "Group as:" and "Sort as:" options that default to the Name format selected in Preferences.

=== Pick a Color selector ===
The [[Gramps_6.0_Wiki_Manual_-_Settings#Colors|Colors]] tab of the Preferences allows customizing of the color of various elements of diagrams in the Charts category's graphical views.

==== Color Palette ====
[[File:PickAColor-selector-dialog-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - palette selector dialog]]
Select a color from the 45 [[Gramps_Glossary#swatch|swatches]] in predefined color palette area. Or select from the recently used {{man label|Custom}} color swatches. Or click the {{man button|+}} button to create your own custom color. Right-click on any swatch to add another custom color and open the gradient selector.

You can drag any color swatch to any swatch in the preference (or configure) dialog.

{{-}}
==== Color Gradient ====
[[File:PickAColor-gradient-dialog-52.png|right|thumb|436px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Pick a Color" - gradient selector dialog]]
The gradient selector dialog is for adjust the [[Gramps_Glossary#swatch|color swatch]] at the top of the dialog. Once changed, either click the {{man button|Select}} button to apply the color. Drag the single gradient dialog swatch to any swatch in the preference (or configure) dialog.

Specific colors of the swatch can be changed in several ways:
* via direct entry 'color Hex color code'
* the hue slider (with a numeric fine control
* mouse left-click in the 1-dimensional (hue) rainbow gradient or the 2-dimensional (brightness and saturation) hue gradient.
* mouse right-click in either gradient to show the numeric control for the dimension(s) of the gradient
* mouse left-click on the eyedropper color picker to choose from any pixel shown on the monitor(s)
{{-}}

=== File Chooser ===
[[File:FileChooser_Bookmarks_Breadcrumbs.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Linux GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs mac.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} macOS GTK File Chooser: highlighting breadcrumbs and bookmarking]]
[[File:FileChooser Bookmarks Breadcrumbs win.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Windows GTK File Chooser: highlighting breadcrumbs and bookmarking]]
The Open and Save dialogs (File Chooser) for Gramps are based on the [https://docs.gtk.org/gtk3/iface.FileChooser.html GTK File Chooser]. Each operating system has expected behaviors for clicks, double-clicks, sorting, [[Gramps_6.0_Wiki_Manual_-_Keybindings#Handy_Shortcuts|keybindings]], environmental variables, and standard file locations that are characteristic of File Chooser dialogs native to the operating system. A few of these can be customized via the user interface to feel more similar to the OS native File Choosers. However, the idiosyncrasies of various OSes mean shared network folders and URI support may not be as readily browsed as when using the OS native File Choosers.

The [https://developer-old.gnome.org/gtk4/stable/GtkFileChooser.html GtkFileChooser] allows for adding quick navigation hotlinks to commonly used places of the filesystem. In the default implementation, these are displayed in the left sidebar navigation pane. It may be a bit unclear at first that these shortcuts come from various sources and in various flavors, so let's explain the terminology here:
* '''[[#Bookmarking_file_folders|Bookmarks]]''': are created by the user, by dragging folders from the right pane to the left pane, or by using the “Add”. Bookmarks can be renamed and deleted by the user.
* '''Shortcuts''': can be provided by the Gramps application. For example, program may want to add a shortcut for a Downloads or Documents folder. Shortcuts ''cannot'' be added or removed by the user. The 'Rename...' context menu option allows them to be relabeled.
* '''Volumes''': are provided by the underlying filesystem abstraction. They are the “roots” of the filesystem. The Home and Downloads hotlinks are common "roots". Volumes cannot be modified by the user.

====File Chooser context menus====
Right-click on any file or folder in the current directory to open context pop-up menu with the following options:
<hr>
*{{man menu|Open With File Manager}}
<hr>
*{{man menu|Copy Location}}
*{{man menu|[[Gramps_6.0_Wiki_Manual_-_Settings#Bookmarking_file_folders|Add to Bookmarks]]}}
<hr>
*{{man menu|❏ Show Hidden Files}}
*{{man menu|☑ Show Size Column}}
*{{man menu|☑ Show Type Column}}
*{{man menu|❏ Show Time}}
*{{man menu|❏ Sort Folders before Files}}
<hr>

Right-click in the navigation sidebar to open context pop-up menu with the following options:
<hr>
*{{man menu|Open}}
*{{man menu|Remove}}
*{{man menu|Rename...}}
<hr>

====Breadcrumbs and text-entry address bar====
By default, the file folder navigation in the File Chooser is by browsing. There are also some shortcuts on the left and breadcrumbs (highlighted in green in the dialog illustration) for quick navigation up and down the path.

Optionally, a text-entry address bar can be used to directly key-in or paste a path. Toggle between displaying breadcrumbs and the text-entry address bar with the {{Man key press|CTRL|L}} [[Gramps_6.0_Wiki_Manual_-_Keybindings|keybinding]].

====Bookmarking file folders====
File folder bookmarks can be user defined to make finding standard locations easier. These bookmarks are remembered between sessions and regardless of which Family Tree has been loaded.

With any Open or Save dialog open, navigate to the file location containing the folder to be bookmarked. Create the bookmark by either: dragging the folder icon to the navigation column on the left; or, right-clicking that folder to use the {{Man menu|Add to Bookmarks}} context menu option.

Right-clicking an existing Bookmark allows renaming that bookmark or removing it.

====File Formats====
Support for several file formats are built into the standard distribution of Gramps. Import plugin and Export Plugin Addons can be installed via the Plugin Manager or Preferences to expand the options.

See the [[Output_formats|Output Format]] article for list of file formats.

====See also====
* [https://ubuntugenius.wordpress.com/2010/05/14/how-to-show-text-entry-address-bar-or-breadcrumbs-navigation-buttons-in-nautilus-after-ubuntu-10-04-upgrade/ How to Show Text-Entry Address Bar or “Breadcrumbs” (Navigation Buttons)] in Nautilus After Ubuntu 10.04 Upgrade

*Discourse discussions about the GTK File Chooser:
** [https://gramps.discourse.group/t/need-suggestions-for-documenting-the-gtk-file-chooser/1820/8 Documenting the File Chooser in the wiki]
** [https://gramps.discourse.group/t/macos-and-windows-gtk-file-chooser-dialog-capture-request/3364 Illustrating the File Chooser in the Wiki]
** [https://gramps.discourse.group/t/can-i-cause-folders-to-sort-to-the-top-of-the-list-when-presented-with-the-folder-contents/1708/14 File Chooser: Sorting files and folders]
* [https://discourse.gnome.org/t/where-is-the-filechooser-feature-list/9101/1 Where is the FileChooser feature list?]

=== Language ===

Gramps has been translated into a number of [[Portal:Translators|languages]]. Usually Gramps automatically starts in your local language, as chosen for other applications, but sometimes this may not be right for you. And in other cases, a module or addon will not yet have been translated and a warning dialog will appear saying something like “Warning: plugin XYZ has no translation for any of your configured languages, using US English instead”. (Note that the US dialect of English is the default rather than British.) This can become annoying or intrusive.

The most idealistic situation is that you are as fluent in US English as the language selected for the operating system GUI on your computer. And that you would take the opportunity to translate that Gramps feature for users who are non-English speakers.

If your system is configured to show a language other then English, you can override this for Gramps.

As an example, assume that a computer in the Netherlands is configured to default to Unicode 8 Dutch: "LANG: nl_NL.UTF-8". You could either reset the OS language

In Windows, use the SET command to change the LANG environment variable to "en_GB.UTF-8" for British English. You can do this from the command line interface or [https://gramps-project.org/bugs/view.php?id=11009 create a startup shortcut with the following Target]:
<code>C:\Windows\System32\cmd.exe /c "SET LANG=en_GB.UTF-8 && START /D ^"C:\Program Files\GrampsAIO64-6.0.5^" gramps.exe"</code>

{{stub}} '''{{man warn|tbd|Describe for each main platform how the normal language is determined and how the user can [[Howto:Change_the_language_of_reports#Run_Gramps_in_a_different_language|choose a different language]].'''}}

==== Linux ====
{{stub}}

If you want to choose a locale 'variant' for sorting that is not the default variant, then you can start Gramps from the terminal (or console) with a different LC_COLLATE environment. For example, the default sorting (collation) variant for Swedish is "reformed", but you can instead choose "standard" by typing:
export LC_COLLATE="sv_SE.UTF-8@collation=standard"
python Gramps.py

==== macOS ====

For macOS see [[Mac_OS_X:Application_package#Advanced_setup|Advanced setup]] for details on how the language is normally chosen, and how to choose a special, non-default setting for the language, the sorting order or the format of such things as day and month names and number separators.

==== MS Windows ====
[[File:MicrosoftWindowGrampsAIO-Installer-ChooseComponents-Selection-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps 6.0.3 AIO 64 bit for Microsoft Windows installer - "Choose Components" page showing selection of the "de"( German) Translation]]
If you want to run Gramps in another language other than English using the Gramps AIO installer, then you must select it during installation process.

Otherwise it will not be available.

More information can be found at [[Installing_Gramps_for_Windows_computers#Missing_other_languages]] page.

{{-}}

===Add Windows OS Menu Item===
[[File:Edit-Target-GrampsAIO64-Properties-Danish-example-60.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for Danish shortcut example.]]

To make Gramps work in your selected language (See table below for your [[Gramps_6.0_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:
* Using your mouse right button click on the "{{man label|GrampsAIO64 6.x.x}}" icon on Desktop and from menu choose: {{man label|Copy}}.
* Right click anywhere on Desktop and from menu choose: {{man label|Paste shortcut}}
* New icon will be created with name: "{{man label|GrampsAIO64 6.x.x (2)}}"
* Right click on that and from menu choose: {{man label|Properties}}
* A new window will open, click on first tab called {{man label|General}} and change text from "{{man label|GrampsAIO64 6.x.x (2)}}" to something more descriptive like: "{{man label|GrampsAIO Danish}}"
** Click on second tab called {{man label|Shortcut}}, change text in first entry called {{man label|Target}} from (note path will vary depending on Gramps version used):
***<code>"C:\Program Files\GrampsAIO64-6.x.x\grampsw.exe"</code> to:
***<code>%comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"</code>
* Click {{man label|OK}}

Now when you click on that icon Gramps will start in Danish.

{{-}}
{{man tip|You can download a zip file attached to feature request:{{bug|13204}} Gramps AIO64 X.x.x Language icons Shortcuts Pack ( for the languages shown in the [[#Language_codes|Language codes]] table below)}}
{{-}}

===Change the windows LANG variables===
Another option if you want Gramps to always load in say: French Canadian language, you can go to Windows > System Properties, and add the LANG variable in the user section of the environment variables dialog with the appropriate Value.

The value to add is:
<pre>
Name: LANG
Value: fr_CA.UTF-8
</pre>

* [https://www.redswitches.com/blog/environment-variables/#method-1-set-environment-variables-through-the-gui How to Set Environment Variables in Windows 10]

===Language codes===
Select from the following table of [[Portal:Translators|languages Gramps]] has been translated into:

{| {{prettytable}}
!Language
!ISO code
!Example
!Notes
|-
| English-USA (Default)
| en_US.UTF-8
| %comspec% /c set LANG=en_US.UTF-8 && start grampsw.exe"
|
|-
| English (British)
| en_GB.UTF-8
| %comspec% /c set LANG=en_GB.UTF-8 && start grampsw.exe"
|
|-
| Finnish
| fi.UTF-8
| %comspec% /c set LANG=fi.UTF-8 && start grampsw.exe"
|
|-
| Russian
| ru_RU.UTF-8
| %comspec% /c set LANG=ru_RU.UTF-8 && start grampsw.exe"
|
|-
| Albanian
| sq_AL.UTF-8
| %comspec% /c set LANG=sq_AL.UTF-8 && start grampsw.exe"
|
|-
| German
| de_DE.UTF-8
| %comspec% /c set LANG=de_DE.UTF-8 && start grampsw.exe"
|
|-
| French
| fr_FR.UTF-8
| %comspec% /c set LANG=fr_FR.UTF-8 && start grampsw.exe"
|
|-
| French Canadian
| fr_CA.UTF-8
| %comspec% /c set LANG=fr_CA.UTF-8 && start grampsw.exe"
|
|-
| Macedonian
| mk_MK.UTF-8 ???
|
|
|-
| Nederlands (Dutch)
| nl_NL.UTF-8
| %comspec% /c set LANG=nl_NL.UTF-8 && start grampsw.exe"
|
|-
| Dutch
| nl_BE.UTF-8
| %comspec% /c set LANG=nl_BE.UTF-8 && start grampsw.exe"
|
|-
| Slovak
| sk_SK.UTF-8
| %comspec% /c set LANG=sk_SK.UTF-8 && start grampsw.exe"
|
|-
| Hebrew
| he_IL.UTF-8
| %comspec% /c set LANG=he_IL.UTF-8 && start grampsw.exe"
|
|-
| Danish
| da_DK.UTF-8
| %comspec% /c set LANG=da_DK.UTF-8 && start grampsw.exe"
|
|-
| Greek
| el_GR.UTF-8
| %comspec% /c set LANG=el_GR.UTF-8 && start grampsw.exe"
|
|-
| Italian
| it_IT.UTF-8
| %comspec% /c set LANG=it_IT.UTF-8 && start grampsw.exe"
|
|-
| Esperanto
| eo.UTF-8 ???
|
|
|-
| Chinese (Simplified)
| zh_CN.UTF-8
| %comspec% /c set LANG=zh_CN.UTF-8 && start grampsw.exe"
|
|-
| Chinese (Hong Kong)
| zh_HK.UTF-8 ???
|
|
|-
| Chinese (Traditional)
| zh_TW.UTF-8
| %comspec% /c set LANG=zh_TW.UTF-8 && start grampsw.exe"
|
|-
| Ukrainian
| uk_UA.UTF-8
|
|
|-
| Portuguese
| pt_PT.UTF-8
| %comspec% /c set LANG=pt_PT.UTF-8 && start grampsw.exe"
|
|-
| Portuguese (Brazil)
| pt_BR.UTF-8
| %comspec% /c set LANG=pt_BR.UTF-8 && start grampsw.exe"
|
|-
| Afrikaans
| af_ZA.UTF-8
|
|
|-
| Norwegian Bokmål
| nb_NO.UTF-8
| %comspec% /c set LANG=nb_NO.UTF-8 && start grampsw.exe"
|
|-
| Norwegian Nynorsk
| nn_NO.UTF-8
| %comspec% /c set LANG=nn_NO.UTF-8 && start grampsw.exe"
|
|-
| Turkish
| tr_TR.UTF-8
| %comspec% /c set LANG=tr_TR.UTF-8 && start grampsw.exe"
|
|-
| Spanish
| es_ES.UTF-8
| %comspec% /c set LANG=es_ES.UTF-8 && start grampsw.exe"
|
|-
| Polish
| pl_PL.UTF-8
| %comspec% /c set LANG=pl_PL.UTF-8 && start grampsw.exe"
|
|-
| Slovenian
| sl_SI.UTF-8
| %comspec% /c set LANG=sl_SI.UTF-8 && start grampsw.exe"
|
|-
| Japanese
| ja_JP.UTF-8
| %comspec% /c set LANG=ja_JP.UTF-8 && start grampsw.exe"
|
|-
| Arabic (Saudi Arabia)
| ar_SA.UTF-8
| %comspec% /c set LANG=ar_SA.UTF-8 && start grampsw.exe"
|
|-
|
|
|
|
|-
|
|
|
|
|}
*The language codes are two-letter lowercase ISO language codes (such as "da") as defined by [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1].
*The country codes are two-letter uppercase ISO country codes (such as "BE") as defined by [https://en.wikipedia.org/wiki/ISO_3166-1 ISO 3166-1].

===Setting up the language environment===

{{stub}} 

===Advanced manipulation of settings===
{{stub}}

{{man warn| Warning ** Make sure you have closed Gramps **|The contents of this section is outside the scope of interest of a general user of Gramps. If you proceed with tweaking the options on the low level you may damage your Gramps installation. Be careful. '''YOU HAVE BEEN WARNED!'''}}

Besides the settings available in Preferences, you may also wish to explore the advanced settings.

Gramps uses '''[https://en.wikipedia.org/wiki/INI_file#Keys_(properties) INI keys]''' and [https://en.wikipedia.org/wiki/INI_file#Sections INI sections] for managing user preferences and program settings these are stored in the text file <code>gramps.ini</code> under the <code>.gramps/gramps[XX]</code> folder in your home or user directory.

The <code>gramps.ini</code> file has following sections:
* [behavior] : typical Key names are: [https://github.com/gramps-project/gramps/blob/master/gramps/gui/grampsgui.py#L502 betawarn], enable-autobackup, use-tips...
* [colors] :
* [csv] :
* [database] : related to database settings for the Family Tree.
* [export] : export and import folders/directories
* [geography] :
* [interface] : a lot of keys regarding height and width of the different Views: e.g. event-height: 450, event-ref-height: 585, event-ref-width: 728, event-width: 712...
* [paths] : keys related to recent imported files and folders/directories
* [plugin] :
* [preferences] : keys related to preferences: all the common prefixes , todo -colors..
* [researcher] : all information regarding the researcher
* [spacing] :
* [test] :
* [utf8] :

====Example <code>gramps.ini</code> file====
Example contents of the <code>gramps.ini</code> file:


<pre>
;; Gramps key file
;; Automatically created at 2025/05/24 08:49:41

[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0
;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps60', True]]
;;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps60'
;;autoload=0
;;avg-generation-gap=20
;;check-for-addon-update-types=['new']
;;check-for-addon-updates=0
;;date-about-range=50
;;date-after-range=50
;;date-before-range=50
;;do-not-show-previously-seen-addon-updates=1
;;generation-depth=15
;;immediate-warn=0
;;last-check-for-addon-updates='1970/01/01'
;;max-age-prob-alive=110
;;max-sib-age-diff=20
;;min-generation-years=13
;;owner-warn=0
;;pop-plugin-status=0
;;previously-seen-addon-updates=[]
;;recent-export-type=3
;;runcheck=0
;;spellcheck=0
;;startup=0
;;surname-guessing=0
translator-needed=0
;;use-tips=1
;;web-search-url='https://google.com/search?q=%(text)s'
;;welcome=100

[colors]
;;border-family=['#cccccc', '#252525']
;;border-family-divorced=['#ff7373', '#720b0b']
;;border-female-alive=['#861f69', '#261111']
;;border-female-dead=['#000000', '#000000']
;;border-male-alive=['#1f4986', '#171d26']
;;border-male-dead=['#000000', '#000000']
;;border-other-alive=['#2a5f16', '#26a269']
;;border-other-dead=['#000000', '#000000']
;;border-unknown-alive=['#8e5801', '#8e5801']
;;border-unknown-dead=['#000000', '#000000']
;;family=['#eeeeee', '#454545']
;;family-civil-union=['#eeeeee', '#454545']
;;family-divorced=['#ffdede', '#5c3636']
;;family-married=['#eeeeee', '#454545']
;;family-unknown=['#eeeeee', '#454545']
;;family-unmarried=['#eeeeee', '#454545']
;;female-alive=['#feccf0', '#62242D']
;;female-dead=['#feccf0', '#3a292b']
;;home-person=['#bbe68a', '#304918']
;;male-alive=['#b8cee6', '#1f344a']
;;male-dead=['#b8cee6', '#2d3039']
;;other-alive=['#94ef9e', '#285b27']
;;other-dead=['#94ef9e', '#062304']
;;scheme=0
;;unknown-alive=['#f3dbb6', '#75507B']
;;unknown-dead=['#f3dbb6', '#35103b']

[csv]
;;delimiter=','
;;dialect='excel'

[database]
;;autobackup=0
;;backend='sqlite'
;;backup-on-exit=1
;;backup-path='C:\\Users\\[username]'
;;compress-backup=1
;;host=''
;;path='C:\\Users\\[username]\\AppData\\Roaming\\gramps\\grampsdb'
;;port=''

[export]
;;proxy-order=[['privacy', 0], ['living', 0], ['person', 0], ['note', 0], ['reference', 0]]

[geography]
;;center-lat=0.0
;;center-lon=0.0
;;lock=0
;;map_service=1
;;path=''
;;personal-map=''
;;show_cross=0
;;use-keypad=1
;;zoom=0
;;zoom_when_center=12

[interface]
dbmanager-height=370
;;dbmanager-horiz-position=12
;;dbmanager-vert-position=85
;;dbmanager-width=780
;;dont-ask=0
;;filter=0
;;fullscreen=0
;;grampletbar-close=1
;;hide-lds=0
;;ignore-gexiv2=0
;;ignore-osmgpsmap=0
;;ignore-pil=0
;;main-window-height=500
;;main-window-horiz-position=15
;;main-window-vert-position=10
;;main-window-width=775
;;mapservice='OpenStreetMap'
;;open-with-default-viewer=0
;;pedview-layout=0
;;pedview-show-images=1
;;pedview-show-marriage=0
;;pedview-show-unknown-people=0
;;pedview-tree-direction=2
;;pedview-tree-size=5
;;place-name-height=100
;;place-name-width=450
;;sidebar-text=1
;;size-checked=0
;;statusbar=1
;;surname-box-height=150
;;tipofday-height=350
tipofday-horiz-position=-49
tipofday-vert-position=84
;;tipofday-width=550
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-style=0
;;toolbar-tools=1
;;treemodel-cache-size=1000
;;view=1
;;view-categories=['Dashboard', 'People', 'Relationships', 'Families', 'Ancestry', 'Events', 'Places', 'Geography', 'Sources', 'Citations', 'Repositories', 'Media', 'Notes']

[paths]
;;quick-backup-directory='C:\\Users\\[username]'
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'
;;recent-export-dir='C:\\Users\\[username]'
;;recent-file=''
;;recent-import-dir='C:\\Users\\[username]'
;;report-directory='C:\\Users\\[username]'
;;website-cal-uri=''
;;website-cms-uri=''
;;website-directory='C:\\Users\\[username]'
;;website-extra-page-name=''
;;website-extra-page-uri=''

[plugin]
;;addonplugins=[]
;;hiddenplugins=[]

[preferences]
;;age-after-death=1
;;age-display-precision=1
;;age-rounded-year=1
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-legacy'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;default-source=0
;;eprefix='E%04d'
;;family-relation-type=3
;;family-warn=0
;;february-29=0
;;fprefix='F%04d'
;;hide-ep-msg=0
;;invalid-date-format='%s'
;;iprefix='I%04d'
last-view='dashboardview'
last-views=['dashboardview', '', '', '', '', '', '', '', '', '', '', '', '']
;;name-format=1
;;no-given-text='[Missing Given Name]'
;;no-record-text='[Missing Record]'
;;no-surname-text='[Missing Surname]'
;;nprefix='N%04d'
;;online-maps=0
;;oprefix='O%04d'
;;paper-metric=0
;;paper-preference='Letter'
;;patronimic-surname=0
;;place-auto=1
;;place-format=0
;;pprefix='P%04d'
;;private-given-text='[Living]'
;;private-record-text='[Private Record]'
;;private-surname-text='[Living]'
;;quick-backup-include-mode=0
;;rprefix='R%04d'
;;sprefix='S%04d'
;;tag-on-import=0
;;tag-on-import-format='Imported %Y/%m/%d %H:%M:%S'
;;use-last-view=0

[researcher]
;;researcher-addr=''
;;researcher-city=''
;;researcher-country=''
;;researcher-email=''
;;researcher-locality=''
;;researcher-name=''
;;researcher-phone=''
;;researcher-postal=''
;;researcher-state=''

[spacing]
dbman=[22.605613425925927, 5.877459490740741, 9.856047453703704]

[test]
;;january='January'

[utf8]
;;baptism-symbol='~'
;;birth-symbol='*'
;;buried-symbol='[]'
;;cremated-symbol='⚱'
;;dead-symbol='✝'
;;death-symbol=2
;;divorce-symbol='o|o'
;;engaged-symbol='o'
;;in-use=0
;;killed-symbol='x'
;;marriage-symbol='oo'
;;partner-symbol='o-o'
;;selected-font=''
</pre>

====Advanced backup filename setting====
You can also define the naming pattern for the backup filename by setting the ''<code>paths.quick-backup-filename</code>'' in the <code>~/.gramps/gramps60/gramps.ini</code> key file like the following:
{{-}}
[paths]
;;quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'

by removing the two semicolons(<code>;;</code>) from the front of INI key line and using use any of the following keywords for the filename pattern:
*filename
*year
*month
*day
*hour
*minutes
*seconds
*extension :
**'''.gpkg'''(default) if you include media.
**''.gramps'' if you exclude media.

Use the appropriate ~/.gramps/gramps{XX}/gramps.ini key file.
*Gramps version 6.0 :
~/.gramps/gramps60/gramps.ini

See also:
* [[Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog]]
* [[Gramps_6.0_Wiki_Manual_-_Command_Line#Configuration_.28config.29_option]]
* [[Install_latest_BSDDB#Make_Gramps_use_bsddb3]]
* [[Customize_the_Genealogical_Symbols_lookup_table#Genealogy_symbols_preferences]]

===Theme===
The look of Gramps can be changed.

* [[Addon:ThemePreferences|Addon:Theme Preferences]]
* [[Windows_AIO_themes]]
* [[GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme|GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion]]
* [[Overrule_Gramps_Icons]] - for older Gramps versions.
* [[UI style]]

Some reports can also be changed:

* [[Website report Themes]]
{{-}}
{{man index|Gramps 6.0 Wiki Manual - Tools|Gramps 6.0 Wiki Manual - Filters|6.0}}
{{languages|Gramps_6.0_Wiki_Manual_-_Settings}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

Website application upgrades

2026-07-20T07:30:32Z

Sam888: /* Upgrade WordPress (blog) */ Upgrade to Wordpress 7.0.2

{{man warn|Notes for the webmaster@gramps-project.org|Used in the maintenance of the Gramps website.}}
= Upgrade Mantis Bug Tracker (bug tracker) =

<code>https://gramps-project.org/bugs/</code>

[https://www.mantisbt.org/ MantisBT] is an open source issue tracker.

[https://gramps-project.org/bugs/my_view_page.php Current installed version] 2.22.1 (released: 2019-09-27)

* Place MantisBT into [https://www.mantisbt.org/docs/master/en-US/Admin_Guide/html/admin.install.upgrade.html readonly mode] using the file <code>mantis_offline.php</code> to prevent users from using the system while the upgrade is in progress.
* Backup gramps_bugs mysql database using phpMyAdmin from the CPanel interface using the SQL format.
** Note that mantis attachments are stored in the <code>/home/gramps/public_html/files</code> folder.
* Download latest version of MantisBT ( https://github.com/mantisbt/mantisbt/releases ) - (Use the ".tar.gz" file.)
* Upload the MantisBT ".tar.gz" file into the Gramps hosting site either using ftp or the CPanel "File Manager".
* Use the CPanel "File Manager" to unarchive into <code>/home/gramps/</code> - it will create a new folder such as "mantisbt-release-2.10.0"
* Rename the new folder from such as "mantisbt-release-2.10.0" to "bugsnew"
* Copy "config_inc.php" from the old folder into the new folder (the "config_inc.php" file is located in the "config" directory.)
* Check any readme type files to make sure there are not any database schema changes required - and follow the directions if there are...
** Then check the install by using: "/mantisbt/admin/check/index.php"
** And then upgrade the installation using: "/mantisbt/admin/install.php"
* Rename the original folder from "bugs" to "bugsold"
* Rename the new folder from "bugsnew" to "bugs"
<hr>
Update the MantisBT plugins by downloading the updated version and install them (check the readme and follow any instructions)
* Source control integration plugin framework for MantisBT, including support for Github ( https://github.com/mantisbt-plugins/source-integration ) 2 part plugin (Get the master branch)[https://mantisbt.org/bugs/view.php?id=21201]
** Source control integration (version 2.3.0)
** Source Github integration (version 2.1.0)
* Google Analytics integration for MantisBT (version 2.0)( https://github.com/mantisbt-plugins/google-analytics )
<hr>
See if it works!
* Place MantisBT into normal mode by removing <code>mantis_offline.php</code>
* Login as a user
** Use the test user (see offline support document)
* Test a few things (Edit note/create feature/issue)
* Look at the bottom left corner of the main overview page where it will display the current upgraded to version number so you know you are looking at the new install (You may need to refresh to get a new copy, as there is probably some caching involved...)
<hr>
If not immediately functional
* Revert by renaming "bugs" to "bugsnew" and "bugsold" to "bugs"
* If any database schema changes had been made restore the original "gramps_bugs.sql" mysql database using phpMyAdmin.
that should put MantisBT back to square one...
<hr>
Otherwise if it worked.
* Remove the "admin" folder (Or else there is a warning each time you login to do this).
* Remove the MantisBT ".tar.gz" file you uploaded.
* Move the "bugsold" folder to <code>/home/gramps/</code> to prevent access.
* After a two weeks, remove the "bugsold" folder.
<hr>
Also check that the following two links work and are not blank:
* Changelog page
* Roadmap.
If they are follow the instructions in the offline support document.
<hr>
'''Backup the website!'''

= Upgrade MediaWiki (wiki) =

<code>https://gramps-project.org/wiki/</code>

[https://www.mediawiki.org/wiki/MediaWiki MediaWiki] is a free software open source wiki package written in PHP, originally for use on Wikipedia.

[https://gramps-project.org/wiki/index.php?title=Special:Version Current installed version] [https://www.mediawiki.org/wiki/MediaWiki_1.31 1.31.3] (released: 2019-07-02) LTS (Supported until [https://www.mediawiki.org/wiki/Version_lifecycle#Versions_and_their_end-of-life June 2021])

The gramps_wiki mysql database is quite a large, and MediaWiki upgrades are generally more likely to have problems when upgrading than other actions on the Gramps website!

* Place MediaWiki into restricted editing mode (See "LocalSettings.php" and uncomment the relevant section)
* Using the Gramps Cpanel interface go to the MySQL section, then select "phpMyAdmin" and remove the often large cache tables of gramps_wiki ( "l10n_cache" and "objectcache" ).
* Backup gramps_wiki mysql database using phpMyAdmin from the CPanel interface using the SQL format.
** If a timeout occurs try using SSH and the mysql command or even phpMyAdmin to clone/copy the existing database.
* Download latest version of MediaWiki ( https://www.mediawiki.org/wiki/Download ) - (Use the ".tar.gz" file.)
* Upload the MediaWiki ".tar.gz" file into the Gramps hosting site either using ftp or the CPanel "File Manager".
* Use the CPanel "File Manager" to unarchive it into <code>/</code> - it will create a new folder such as "mediawiki-1.31.3"

From here, you can use a combination of the Cpanel "File Manager" or ssh, so long as you get it all done!
* Rename the new folder from such as "mediawiki-1.31.3" to "wikinew"
* Copy the "LocalSettings.php" file from "wiki" to "wikinew" folder.
* Copy the entire "images" folder (quite large - nearly 1.9GB) from "wiki" to "wikinew" - you will be replacing an existing folder in wikinew. Again, you could do this with the filemanager or use ssh if you are comfortable with it). Even using ssh it takes quite a while, and I'm pretty sure it puts a load on the server...
* Copy folders from the "extensions" folder in "wiki" into "wikinew". '''Copy only the ones that do not exist there''' (that is, don't overwrite folders in the extensions directory with older versions - only copy across the ones that are not already there). We use the extensions listed below that do not come with the base install as well as a few also listed from the base install that you should not copy over. You need to check and see if there are new versions of these, as sometimes the original versions will not work with the new version of MediaWiki. Installed extensions are listed on the following page: https://gramps-project.org/wiki/index.php?title=Special:Version
** Extension that Gramps wiki uses that come with MediaWiki (do not need to be installed) but are listed in the LocalSettings.php file
*** ParserFunctions - Enhance parser with logical functions
** Thirdparty Extensions
*** Confirm User Accounts – Gives bureaucrats the ability to confirm account requests
*** LabeledSectionTransclusion
*** Variables - Parser functions allowing to work with dynamic variables in an article scoped context
*** Google Analytics Integration
** [https://www.mediawiki.org/wiki/Manual:Skins Mediawiki:Skins](Themes)
*** Default is "Vector" as it has been customised for Gramps ( see https://gramps-project.org/wiki/index.php/MediaWiki:Common.css )
*** MobileFrontEnd
**** "MinervaNeue" mobile Skin (which is the same one used on Wikipedia)

If there are any database schema changes, you may need to run the "update.php" file that is in the MediaWiki maintenance directory.
* Do that by using '''ssh''' (see offline support document) and changing to the "wiki/maintenance" directory and run <code>php update.php</code>
There may be some warnings about deprecated functions and the option to bail out - you should be able to continue to do the schema upgrade...
If it were to fail, you'll need to revert to the original files (by renaming the folders) and probably do a database restore to the unchanged version of the gramps_wiki SQL file.
Just hope it doesn't happen to you!

* Rename the original folder from "wiki" to "wikiold"
* Rename the new folder from "wikinew" to "wiki"

Otherwise if it worked.
* Place MediaWiki into normal mode
* Check the upgraded MediaWiki version details and all extensions are updated:
https://gramps-project.org/wiki/index.php?title=Special:Version
* Remove the MediaWiki ".tar.gz" file you uploaded.
* For the "wikiold" folder add a webprotect in the .Htaccess file to stop access to the old MediaWiki version (especially important if database schema update occurred)
* After a two weeks, remove the "wikiold" folder.

'''Backup the website.'''

= Upgrade WordPress (blog) =

<code>https://gramps-project.org/blog/</code>

[https://wordpress.org/ WordPress] is open source software used to create the blog.

Current installed version 7.0.2 ([https://wordpress.org/download/releases/ released:] 2026-06-17)

* Backup gramps_blog mysql database using phpMyAdmin from the CPanel interface using the SQL format.
* Login to the Gramps blog ( https://gramps-project.org/blog/wp-login.php ) using an admin login.

The Dashboard will indicated to you if there is a newer version available for updating/upgrading.

You can expect pretty good results by just:
* Clicking on the appropriate "Update to x.x.x" button to upgrade the main install.

After the update return to the Dashboard, Upgrades screen and
* Upgrade any plugins (after checking the compatibility notes for each) the following plugins are used on Gramps blog:
** Akismet Anti-Spam
** All-in-One WP Migration and Backup
** APCu Manager
** Autoptimize
** Classic Editor
** Easy HTTPS (SSL) Redirection
** Easy Updates Manager
** Github Embed
** Github Ribbon
** LightStart - Maintenance Mode, Coming Soon and Landing Page Builder
** Manage Notification Emails (Virgial)
** Google Captcha (reCAPTCHA) by BestWebSoft
** Sticky Side Buttons
** WordPress HTTPS
** WP File Manager
** WP-Optimize - Clean, Compress, Cache
** [https://wordpress.org/plugins/redirection/ Redirection]

Themes
* Do not update the Gramps Theme named "Hello Gramps!" as it has been customised by Jason Simanek (Unless you know how)
* Upgrade only the themes that come with WordPress

'''Backup the website.'''

=Announcement of upgrade email template =
* See the source for this wiki page (embedded as a comment).

=Changing to a new Hosting service=
{{stub}}
General summary of steps taken on move to current host.

=See also=
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]

[[Category:Developers/General]]

Rollover for the manual

2026-07-18T00:38:07Z

Sam888:

{{man warn|Notes for the webmaster@gramps-project.org|Used in the maintenance of the Gramps website}}
Technical details on how the Gramps wiki [[User manual]] is updated for each release.

== Rolling over the Gramps user manual ==
On this page, <code>6.x</code> refers to the 'old' (current {{man version}}) version of the manual - <code>7.z</code> refers to the new, to be created, version...
====Backup wiki====
Use the command-line to backup all of the wiki SQL tables:
* SSH to Hosting terminal
* [https://www.a2hosting.com/kb/developer-corner/mysql/import-and-export-a-mysql-database/ Command line:] <code>mysqldump --routines --no-tablespaces -u grampsa2_wiki -p grampsa2_wiki > grampsa2_wiki.sql</code>

You can alternatively use phpmyadmin to backup all of the wiki SQL tables, but it is not recommended.

====Process====
#Locate all pages on the wiki that have <code>6.x</code> in the title - from the {{man label|wiki menu: [[Special:AllPages|Tools > Special pages > All pages]]}}, page by page copy the text to get a full list of wiki pages.
#Copy/paste it into text processor - it may be in three columns separated by tabs. If so, use regular expression search/replace to replace tabs with carriage returns. Using GEDIT, best to replace <code>\t</code> with <code>\n</code> rather than <code>\r</code>. You now have a list of all files on the wiki, one title per line. Save it as a text file (I'll call it <code>myfile.txt</code> for this example).
#Use grep to find only the pages with <code>6.x</code> in the title: ''<code>grep "6\.x" myfile.txt > mynewfile.txt</code>'' The backslash will make the full stop a literal rather than trying to be part of a regular expression.
#Use a text editor to view the new file, and delete any pages that you don't want to roll over (That is, some pages may refer to <code>6.x</code> in the title, but are not pages that we want duplicated into <code>7.z</code>...) (Take note of the {{new|X.x}} template for new features and leave those version numbers)
#Go to the {{man label|wiki menu: [[Special:Export|Tools > Special pages > Export pages]]}} and Copy/paste the new list of page titles into the {{man label|Add pages manually:}} section then {{man menu|Be sure the checkbox is ticked for {{man label|Include only the current revision, not the full history}}}} and then to create the xml to screen press the {{man label|Export}} button.
#Copy/paste the xml into a text processor and use search/replace to replace <code>6.x</code> with <code>7.z</code>
#Save the file (I'll call it <code>export.xml</code> for this example).
#Upload the <code>export.xml</code> to the hosting site.

=== Import xml from the command line===
For the change to <code>5.4</code> and then from <code>5.4</code> to <code>6.0</code>, I used the mediwiki script in the maintenance directory to import xml from the command line. I was successful with (but I got an error in <code>importDump.php</code> and had to edit the file to ensure that <code>Maintenance.php</code> was included properly!):

'''-bash-prompt$<code>php importDump.php export.xml</code>'''

followed by:

'''-bash-prompt$<code>php rebuildrecentchanges.php</code>'''

That should now have created all of the new pages.

===Update searchindex table===
Before doing this backup the wiki SQL database.

{{man warn|Update searchindex table|New pages created by this sort of import do not automatically get added into the search index of the wiki.''}}

* Use phpmyadmin from the cpanel and via the GUI either:
** Use the repair tool(on the ''Operations'' tab and under ''table Maintenance>Repair table'' for the <code>searchindex</code> table.
** Or: In phpMyAdmin, enter "<code>REPAIR TABLE wikidb.searchindex;</code>" for rebuilding the search index. wikidb is your database's name.

===Update Statistics table===
To update the Statistics page for Page & Revision Counts run:

<code>php initSiteStats.php</code>

Backup the wiki SQL database.

===Set previous version pages to be protected===

Finally, if you want to set all the previous older user manual version pages to be protected, so only sysop mediawiki users are able to make changes (so all changes will be forced into the next set of pages...), you can use a series of sql statements in the form:
<pre>
UPDATE `grampswiki`.`page` SET `page_restrictions` = 0x656469743d7379736f703a6d6f76653d7379736f70 WHERE `page`.`page_title` ='Title_of_the_page_in_the_wiki' collate utf8_unicode_ci LIMIT 1;
</pre>
({{man menu|You'll need to replace the spaces in the page title with underscores...}})

{{man note|Beginning with MediaWiki 1.10|Page protection controls were moved to the page restrictions table, so this field will be empty in databases generated by more current versions of MediaWiki. However, this field is still used in current versions of MediaWiki for rows generated by older versions of MediaWiki!
 
https://www.mediawiki.org/wiki/Manual:Page_restrictions_table
 
https://www.mediawiki.org/wiki/Manual:Page_table#page_restrictions }}

Do that by using concatenation in a spreadsheet (call it <code>protectoldpages.xls</code>), creating the (long) SQL statements by combining a first part, the page names and the last part. You'll need to search for any single quotes and put a backslash in front of them in the page names first, too...

That updates a blob field to force protection without having to do the pages individually. You need to do the above sql statement for each page that you want to protect...

* Copy the resulting SQL statement to a text file <code>protectoldpages.txt</code>
* check the SQL statements syntax [https://www.piliapp.com/mysql-syntax-check/ here]
* Then run the SQL statement by either using phpmyadmin("SQL" tab to run the query) or the commandline.

Backup the database.

===Screenshots===
As there is no [[Screenshots|naming scheme]] we are trying to follow a rule for manual upgrade :
* <code>filename-{number of version}-{lang}.extension</code>
ex:
* <code>Edit-person-60-en.png</code>
We need to know if we keep the {number of version} or if we use the new one on migration (5.1->5.2->6.0->15.0...) ?

===Regenerate Version-Specific Content===
Update files dependency list :

{{man menu|''The documentation assumes the default (English-US) language on Linux''}}

Edit the manual section :

<code> https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_Command_Line&action=edit&section=8</code>

Copy (or pipe) the updated Gramps installation output from the command line Version option :

<code> gramps -v</code>

Replace any user-specific directory information with '''<~username>'''

If appropriate, please reference the Gramps "[[Gramps_Glossary#user_directory|User Directory]]" Glossary term entry instead of redundantly explaining the directory paths under any of the multiuser OSes. This glossary entry include a drill-down link to the Appendix describing how to find the directory for a particular fork of Gramps

<code>[[Gramps_Glossary#user_directory|User Directory]]</code>

Gramps user directory available on various operating systems.

===Remove "STUB" template from the previous User manual===
For the Gramps user manual only the latest version should be listed on [[:Category:Stub]].

* [[:Template:Stub Stagnant]] ??

=== Update the Releases wiki page to add new version ===
[[Previous_releases_of_Gramps|Previous releases of Gramps]] page, add a Versions table row for the new rollover version. Validate the links in the "User Manual" column for the ''previous'' version of the wiki and the English offline PDF from the [[User_manual_translations#Enabled|Enabled User Manual]] table.

=== Edit the "Whats New?" wiki page ===
Reset the "Whats New?" page removing past information.

==Version manual template==
Update the current ( {{man version}} ) version number using on [[:Template:man_version]] for pages outside of the user manual.

Manually update any REDIRECT pages also eg: "[https://gramps-project.org/wiki/index.php?title=Third-party_Addons&action=edit Third-party Addons]" link redirects to 6.1 Addons etc..

==Email announcement==
Send the following email announcement (see embedded email) to the mailing list.




==Other associated changes==
===Third-party Addons listings===
* [[Third-party Addons]]
** [[:Template:Addons6.0]]
* [[5.2 Builtins]] ??

===External Site changes===
* Some of the [https://discourse.gramps-project.org Discourse forum] '''automatic linking of key phrases''' point to sections in the current manual. A user with "Leader" or higher trust setting should review and update the Admin -> Customize -> [https://gramps.discourse.group/admin/customize/watched_words/action/link Watched Words -> Link] list. This is most easily accomplished by:
# using the discourse Download button to acquire a CSV of the list (which is an unqualified comma delimited list with a "phrase,url" on each line)
# edit it in a text editor
# replace the versions in the list
# save the file
# use the "Clear All" discourse button
# use the "Add from file" discourse button to upload the modified list
# refresh the Discourse page manually as that seems to be quirky
# use the "Test" discourse button to verify a couple linkify phrases

==See also==
* Generating the [[Manual_Generation_5.1|Offline User Manual]] (includes template scripts for English & 3 translations)
* [[User manual]]
* [[Manual Generation]] - revised 28 Aug 2023 for Gramps 5.1.6
* [[Manual Generation 3.0]]
* [[What to do for a release]]

[[Category:Developers/General]]

Download

2026-06-14T03:08:07Z

Sam888:

{{languages|Download}}
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]
'''Research, organize and share your family tree with Gramps.'''

Gramps is a free software project and community. We strive to produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists. It is a community project, created, developed and governed by genealogists.
{{-}}
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''{{version-released}}'''}}|For a list of updates see: ''[[Gramps 6.0 Wiki Manual - What's new?|What's new?]]}}

{{man warn|Before upgrading your distribution|Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the [[#1|hardy and portable XML format]].}}

<hr />
Linux
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]
<big>
For Linux, we recommend installing and upgrading Gramps using either [https://wikipedia.org/wiki/Flatpak FlatPak] or [https://en.wikipedia.org/wiki/Snap_(software) Snap]:
* A Flatpak is available from [https://flathub.org/apps/org.gramps_project.Gramps Flathub]. ([https://gramps.discourse.group/t/need-help-upgrading-to-6-0-5-flatpak-on-ubuntu-24-04/8765/4 Flatpak doesn’t include the BSDDB database backend.])
* A Snap is available from the [https://snapcraft.io/gramps Snap Store].
</big>

Gramps may also be available in the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[Installing_Gramps_for_Linux_computers#Linux_distributions|distribution]]. However, this is likely to be out-of-date in some popular distributions.

For advanced users, a source package is available:
* [{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]

Instructions for how to [[Linux:Build from source|build from source]] are available in our wiki.

{{-}}
<hr />
Microsoft Windows
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]
This executable installer supports Microsoft Windows in versions 8, 10, 11 (64-bit Only) and later.
<big>
* [{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]
After download: '''double-click to install Gramps'''.

Alternatives to the All-In-One installer include the [[Installing_Gramps_for_Windows_computers#PortableApps.com|PortableApps.com]] and [[Installing_Gramps_for_Windows_computers#Chocolatey_NuGet_Package|Chocolatey NuGet Package]]. Advanced users can install Gramps from source using the [[Gramps_for_Windows_with_MSYS2|MSYS2]] build environment.

Final Gramps versions for legacy Windows systems (PortableApps format): Windows 7 64-bit: [https://portableapps.com/downloading/?a=GrampsPortableLegacyWin7&s=s&p=&d=pa&n=Gramps%20Portable&f=GrampsPortableLegacyWin7_5.1.6_Rev_2.paf.exe 5.1.6], Windows 7/8/10 '''32-bit''': [https://portableapps.com/downloading/?a=GrampsPortableLegacyx86&s=s&p=&d=pa&n=Gramps%20Portable&f=GrampsPortableLegacyx86_5.1.5.paf.exe 5.1.5], Windows XP/Vista: [https://portableapps.com/downloading/?a=GrampsPortableLegacy3&s=s&p=&d=sfpa&n=Gramps%20Portable&f=GrampsPortableLegacy3_3.4.9.paf.exe 3.4.9]
{{-}}

<hr />
Apple macOS
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.
<big>
* [{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]
* [{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]
</big>
After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next, drag the Gramps application to your application folder and double-click to launch it.

Alternatives to the [[Mac_OS_X:Application_package|application package]] include the [[Installing_Gramps_for_macOS_computers#MacPorts|MacPorts]] and [[Installing_Gramps_for_macOS_computers#Homebrew|Homebrew]] package managers.

{{man warn|The Gramps app on Apple’s App Store is in no way affiliated with the Gramps project.|See: * 2025 Forum discussion [https://gramps.discourse.group/t/ios-app-named-gramps/6756/4 iOS app named “Gramps”]}}
{{-}}
<hr />
BSD platforms
[[File:Bsd daemon.png|128px|left|link=BSD platforms]]

For BSD, we recommend installing and upgrading Gramps using the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[BSD platforms#BSD_distributions|distribution]].

Advanced users can [[Linux:Build from source|build from source]] using the link in the Linux section.

Further information can be found on the [[BSD platforms]] page in the wiki.
{{-}}
<hr />

{{man tip|Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened.|Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the backup]] into this new Family Tree.}}
{{-}}
 
{{-}}
== Notes ==
Backup to '''Gramps XML''' format when updating. ''Although Gramps reads and writes '''GEDCOM 5.5.1''' format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML format.

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]

You will find a [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup...}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps versions. Alternately, use [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|Export...}}]] in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.

See: [[How to make a backup]]

== See also ==
* Installer [[Team#Package_Maintainers|package maintainers]]

===Installing Gramps for Desktops===
Installation instructions specific to the different OSes are on the [[File:linux_32x32.png|link=Installing_Gramps_for_Linux_computers#Linux_distributions]], [[File:windows_32x32.png|link=Installing_Gramps_for_Windows_computers]],[[File:macos_200x200.png|32px|link=Installing_Gramps_for_macOS_computers]] and [[File:Bsd daemon.png|32px|link=BSD_platforms]] pages.

===GitHub Gramps for Desktops Releases===
:* [{{github_url}}/releases/v{{version}} {{version}} version]
:* [{{github_url}}/releases/ Archive of Gramps releases]
Wiki pages
* [[Previous releases of Gramps]]
* [[:Category:Versions|Versions on various platforms]]

===Installing Gramps Web for online collaboration===
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend and a hosted instance of Gramps Web API
* Gramps Web frontend - [https://github.com/gramps-project/gramps-web/releases release history on GitHub] - ([https://calver.org Calendar Versioning]: Year.Month.Micro)
* Gramps Web backend api - [https://github.com/gramps-project/gramps-web-api/releases release history on GitHub] - ([https://semver.org Semantic Versioning]: Major.Minor.patch)

Deployments:
* [https://www.grampsweb.org/Deployment/ Docker]
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]

[[Category:Documentation]]

Download

2026-06-14T03:07:12Z

Sam888: Only show 64 bit version for download as final 32 bit listed below

{{languages|Download}}
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]
'''Research, organize and share your family tree with Gramps.'''

Gramps is a free software project and community. We strive to produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists. It is a community project, created, developed and governed by genealogists.
{{-}}
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''{{version-released}}'''}}|For a list of updates see: ''[[Gramps 6.0 Wiki Manual - What's new?|What's new?]]}}

{{man warn|Before upgrading your distribution|Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the [[#1|hardy and portable XML format]].}}

<hr />
Linux
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]
<big>
For Linux, we recommend installing and upgrading Gramps using either [https://wikipedia.org/wiki/Flatpak FlatPak] or [https://en.wikipedia.org/wiki/Snap_(software) Snap]:
* A Flatpak is available from [https://flathub.org/apps/org.gramps_project.Gramps Flathub]. ([https://gramps.discourse.group/t/need-help-upgrading-to-6-0-5-flatpak-on-ubuntu-24-04/8765/4 Flatpak doesn’t include the BSDDB database backend.])
* A Snap is available from the [https://snapcraft.io/gramps Snap Store].
</big>

Gramps may also be available in the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[Installing_Gramps_for_Linux_computers#Linux_distributions|distribution]]. However, this is likely to be out-of-date in some popular distributions.

For advanced users, a source package is available:
* [{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]

Instructions for how to [[Linux:Build from source|build from source]] are available in our wiki.

{{-}}
<hr />
Microsoft Windows
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]
This executable installer supports Microsoft Windows in versions 8, 10, 11 (64-bit Only) and later.
<big>
* [{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]
After download: '''double-click to install Gramps'''.

Alternatives to the All-In-One installer include the [[Installing_Gramps_for_Windows_computers#PortableApps.com|PortableApps.com]] and [[Installing_Gramps_for_Windows_computers#Chocolatey_NuGet_Package|Chocolatey NuGet Package]]. Advanced users can install Gramps from source using the [[Gramps_for_Windows_with_MSYS2|MSYS2]] build environment.

Final Gramps versions for legacy Windows systems (PortableApps format): Windows 7 64-bit: [https://portableapps.com/downloading/?a=GrampsPortableLegacyWin7&s=s&p=&d=pa&n=Gramps%20Portable&f=GrampsPortableLegacyWin7_5.1.6_Rev_2.paf.exe 5.1.6], Windows 7/8/10 '''32-bit''': [https://portableapps.com/downloading/?a=GrampsPortableLegacyx86&s=s&p=&d=pa&n=Gramps%20Portable&f=GrampsPortableLegacyx86_5.1.5.paf.exe 5.1.5], Windows XP/Vista: [https://portableapps.com/downloading/?a=GrampsPortableLegacy3&s=s&p=&d=sfpa&n=Gramps%20Portable&f=GrampsPortableLegacy3_3.4.9.paf.exe 3.4.9]
{{-}}
* [{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</big>
<hr />
Apple macOS
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.
<big>
* [{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]
* [{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]
</big>
After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next, drag the Gramps application to your application folder and double-click to launch it.

Alternatives to the [[Mac_OS_X:Application_package|application package]] include the [[Installing_Gramps_for_macOS_computers#MacPorts|MacPorts]] and [[Installing_Gramps_for_macOS_computers#Homebrew|Homebrew]] package managers.

{{man warn|The Gramps app on Apple’s App Store is in no way affiliated with the Gramps project.|See: * 2025 Forum discussion [https://gramps.discourse.group/t/ios-app-named-gramps/6756/4 iOS app named “Gramps”]}}
{{-}}
<hr />
BSD platforms
[[File:Bsd daemon.png|128px|left|link=BSD platforms]]

For BSD, we recommend installing and upgrading Gramps using the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[BSD platforms#BSD_distributions|distribution]].

Advanced users can [[Linux:Build from source|build from source]] using the link in the Linux section.

Further information can be found on the [[BSD platforms]] page in the wiki.
{{-}}
<hr />

{{man tip|Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened.|Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the backup]] into this new Family Tree.}}
{{-}}
 
{{-}}
== Notes ==
Backup to '''Gramps XML''' format when updating. ''Although Gramps reads and writes '''GEDCOM 5.5.1''' format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML format.

[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]

You will find a [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup...}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps versions. Alternately, use [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|Export...}}]] in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.

See: [[How to make a backup]]

== See also ==
* Installer [[Team#Package_Maintainers|package maintainers]]

===Installing Gramps for Desktops===
Installation instructions specific to the different OSes are on the [[File:linux_32x32.png|link=Installing_Gramps_for_Linux_computers#Linux_distributions]], [[File:windows_32x32.png|link=Installing_Gramps_for_Windows_computers]],[[File:macos_200x200.png|32px|link=Installing_Gramps_for_macOS_computers]] and [[File:Bsd daemon.png|32px|link=BSD_platforms]] pages.

===GitHub Gramps for Desktops Releases===
:* [{{github_url}}/releases/v{{version}} {{version}} version]
:* [{{github_url}}/releases/ Archive of Gramps releases]
Wiki pages
* [[Previous releases of Gramps]]
* [[:Category:Versions|Versions on various platforms]]

===Installing Gramps Web for online collaboration===
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend and a hosted instance of Gramps Web API
* Gramps Web frontend - [https://github.com/gramps-project/gramps-web/releases release history on GitHub] - ([https://calver.org Calendar Versioning]: Year.Month.Micro)
* Gramps Web backend api - [https://github.com/gramps-project/gramps-web-api/releases release history on GitHub] - ([https://semver.org Semantic Versioning]: Major.Minor.patch)

Deployments:
* [https://www.grampsweb.org/Deployment/ Docker]
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]

[[Category:Documentation]]

User:Sam888

2026-06-14T00:03:59Z

Sam888: /* Security rules */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] since January 27th, 2018 that provides:
* DNS record management
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks
* Blocks AI crawlers & bots


====[https://developers.cloudflare.com/security/rules/ Security rules]====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97 - Skip
# Github - IP Source Address equals 20.205.243.166 - Skip
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62 - Skip
# Sam888 - IP Source Address equals (my private ip) - Skip
# [Another User] - IP Source Address equals (another users private ip) - Skip

====DNS record management====
* Domain: https://gramps-project.org
** 36 Records (Type: A / CNAME / MX / SRV / TXT ) @ 2026/06/14

Note Domain Registration handled by Registrar: GoDaddy.com

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:59:22Z

Sam888: /* DNS record management */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] since January 27th, 2018 that provides:
* DNS record management
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks
* Blocks AI crawlers & bots


====[https://developers.cloudflare.com/security/rules/ Security rules]====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97
# Github - IP Source Address equals 20.205.243.166
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62
# Sam888 - IP Source Address equals (my private ip)
# [Another User] - IP Source Address equals (another users private ip)

====DNS record management====
* Domain: https://gramps-project.org
** 36 Records (Type: A / CNAME / MX / SRV / TXT ) @ 2026/06/14

Note Domain Registration handled by Registrar: GoDaddy.com

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:58:22Z

Sam888: /* Cloudflare */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] since January 27th, 2018 that provides:
* DNS record management
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks
* Blocks AI crawlers & bots


====[https://developers.cloudflare.com/security/rules/ Security rules]====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97
# Github - IP Source Address equals 20.205.243.166
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62
# Sam888 - IP Source Address equals (my private ip)
# [Another User] - IP Source Address equals (another users private ip)

====DNS record management====
* Domain: https://gramps-project.org
** 36 Records (Type: A / CNAME / MX / SRV / TXT ) @ 2026/06/14

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:57:23Z

Sam888: /* Cloudflare */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* DNS record management
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks
* Blocks AI crawlers & bots


====[https://developers.cloudflare.com/security/rules/ Security rules]====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97
# Github - IP Source Address equals 20.205.243.166
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62
# Sam888 - IP Source Address equals (my private ip)
# [Another User] - IP Source Address equals (another users private ip)

====DNS record management====
* Domain: https://gramps-project.org
** 36 Records (Type: A / CNAME / MX / SRV / TXT ) @ 2026/06/14

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:56:34Z

Sam888: /* DNS record management */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* DNS record management
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks


====[https://developers.cloudflare.com/security/rules/ Security rules]====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97
# Github - IP Source Address equals 20.205.243.166
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62
# Sam888 - IP Source Address equals (my private ip)
# [Another User] - IP Source Address equals (another users private ip)

====DNS record management====
* Domain: https://gramps-project.org
** 36 Records (Type: A / CNAME / MX / SRV / TXT ) @ 2026/06/14

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:56:08Z

Sam888: /* DNS record management ( https://gramps-project.org ) */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* DNS record management
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks


====[https://developers.cloudflare.com/security/rules/ Security rules]====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97
# Github - IP Source Address equals 20.205.243.166
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62
# Sam888 - IP Source Address equals (my private ip)
# [Another User] - IP Source Address equals (another users private ip)

====DNS record management====
* Domain: https://gramps-project.org
** 36 Records (Type: A / CNAME / MX / SRV / TXT )

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:53:37Z

Sam888: /* Cloudflare */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* DNS record management
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks


====[https://developers.cloudflare.com/security/rules/ Security rules]====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97
# Github - IP Source Address equals 20.205.243.166
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62
# Sam888 - IP Source Address equals (my private ip)
# [Another User] - IP Source Address equals (another users private ip)

====DNS record management ( https://gramps-project.org ) ====

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:47:16Z

Sam888: /* Security rules */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks


====[https://developers.cloudflare.com/security/rules/ Security rules]====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97
# Github - IP Source Address equals 20.205.243.166
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62
# Sam888 - IP Source Address equals (my private ip)
# [Another User] - IP Source Address equals (another users private ip)

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:45:52Z

Sam888: /* Security rules */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks


====Security rules====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97
# Github - IP Source Address equals 20.205.243.166
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62
# Sam888 - IP Source Address equals (my private ip)
# [Another User] - IP Source Address equals (another users private ip)

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:43:36Z

Sam888: /* Security rules */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks


====Security rules====
Custom rules 5/5 used @ 2026/06/14
# Gramps Weblate - IP Source Address equals 116.203.108.97
# Github - IP Source Address equals 20.205.243.166
# debian.org screenshots on Gramps wiki - IP Source Address equals 128.31.0.62
#
#

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:42:47Z

Sam888: /* Security rules */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks


====Security rules====
Custom rules 5/5 used @ 2026/06/14
* Gramps Weblate - IP Source Address equals 116.203.108.97
* Github - IP Source Address equals 20.205.243.166

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:42:21Z

Sam888: /* Cloudflare */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks


====Security rules====
Custom rules 5/5 used @ 2026/06/14
* Gramps Weblate - IP Source Address equals 116.203.108.97

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:39:55Z

Sam888: /* Cloudflare */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Using [https://www.cloudflare.com/plans/free/ Free plan] that provides:
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks

'''Add details of existing rules and limits'''

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T23:38:37Z

Sam888: /* Volunteer Website Administrator */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)

===Cloudflare===
Provides:
* Content Delivery Network (CDN): Accelerates website loading times by caching content globally.
* DDoS Protection: Offers basic protection against distributed denial-of-service attacks

'''Add details of existing rules and limits'''

===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T00:43:44Z

Sam888: /* SourceForge.net - Storage issue for project: gramps */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)
===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up to https://archive.org/details/@webmaster_gramps-project_org in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T00:40:43Z

Sam888: /* SourceForge.net - Storage issue for project: gramps */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)
===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

* Project's total usage size 26.4 GB as at 2026/06/13

* https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD deleted already backed up in 2017 ISO CD's 2026/06/13

====email====
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T00:37:24Z

Sam888: /* SourceForge.net - Storage issue for project: gramps */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)
===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

---------- Forwarded message ---------
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

----

https://gramps-project.org/wiki/index.php/Linux_Genealogy_CD

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-06-13T00:12:40Z

Sam888: /* Things to do */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)
===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==

===SourceForge.net - Storage issue for project: gramps ===

---------- Forwarded message ---------
From: SourceForge.net Support & Ops <sfnet_ops@slashdotmedia.com>
Date: Fri, 12 Jun 2026 at 07:02
Subject: Storage issue for project: gramps
To:

Hello,

We are contacting you because you are listed as an Admin for https://sourceforge.net/projects/gramps/

This project is using a large amount of storage.

We need your help removing a lot of your old releases.
Please remove as much as you can of your old releases and unused files within 14 days.

You can use this tool to help you identify the files that aren't getting many downloads and take up a lot of space.
https://sourceforge.net/p/gramps/admin/files/large_files

We are letting you know so you can choose which files to remove.
Please be aware that if we don't see any difference after 14 days, we will have to remove all the files and folders with 0 or a few monthly downloads ourselves.

Thank you for your cooperation

Sincerely,

SourceForge Support

===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

Linux Genealogy CD

2026-06-13T00:04:56Z

Sam888: /* Previous release history */ Sourceforge old file clean up email maintenance point links to archive.org account for downloads

{{languages|Linux Genealogy CD}}
{{man note|You may find current Gramps downloads|On the following page [[Download]]. {{man warn|This page list unsupported historical releases of the Linux Genealogy CD}}}}
[[File:cdlabel_web_l.jpg|right|Linux Genealogy CD Rom label]]
The Linux Genealogy Desktop CD 6.1 (Released: 2010-11-29) (''The CD is available only for the x86 architecture.'')

Includes the following pre-installed genealogy software:
*'''Gramps''' 3.2.5

As well as [http://www.graphviz.org/ GraphViz] the program that draws pretty charts and graphs in Gramps.

This Live CD is based on the Ubuntu 10.10 (The Maverick Meerkat ) Desktop CD.

In addition to the Live Session, this disk also allows permanent installation of Linux and genealogical software on your computer's hard drive. This way you achieve adequate speed and the ability to save your data, and can do real work with your Linux software. Everything is similar to the Live Session, except that this is a permanent setup.

==Download the CD==

The CD can be downloaded from:

* https://archive.org/details/@webmaster_gramps-project_org

===Previous release history===



{| class="wikitable sortable"
|-
!Version
!Release Date
!Gramps version
!Notes
|-
| | [https://archive.org/details/lgenealogy-1.0-live-i386_201712 Linux Genealogy Live CD 1.0] || [https://sourceforge.net/p/gramps/mailman/message/243671/ 2005-10-22] || 2.0.8 || Ubuntu 5.10 (Breezy Badger) features pre-installed GeneWeb, and LifeLines applications
|-
| | [https://archive.org/details/lgenealogy-1.0-live-i386 Linux Genealogy Install CD 1.0] || [https://sourceforge.net/p/gramps/mailman/message/243678/ 2005-10-29] || 2.0.8 || Ubuntu 5.10 (Breezy Badger) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
| | [https://archive.org/details/lgenealogy-2.0-desktop-i386 Linux Genealogy Desktop CD 2.0] || [https://sourceforge.net/p/gramps/mailman/message/10070632/ 2006-06-03] || 2.0.11 || Ubuntu 6.06 (Dapper Drake) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
| | [https://archive.org/details/lgenealogy-3.0-desktop-i386 Linux Genealogy CD 3.0] || [https://sourceforge.net/p/gramps/mailman/message/243733/ 2007-04-29] || 2.2.7 || Ubuntu 7.04 (Feisty Fawn) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
| | [https://archive.org/details/lgenealogy-4.0-desktop-i386 Linux Genealogy CD 4.0] || [https://sourceforge.net/p/gramps/mailman/message/19668479/ 2008-06-26] || 3.0.1 || Ubuntu 8.04 (Hardy Heron) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
| | [https://archive.org/details/lgenealogy-6.1-desktop-i386 Linux Genealogy CD 6.1] || [https://sourceforge.net/p/gramps/mailman/message/26672022/ 2010-11-29] || 3.2.5 || Ubuntu 10.10 (The Maverick Meerkat) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
|}

=== Translations ===

If after installation, your desktop is not fully translated to your selected locale:
# have a look at Menu -> System -> Administration -> Languages support [http://packages.ubuntu.com/en/precise/language-selector]
# or manually [http://packages.ubuntu.com/en/precise/all/translations/ download packages with your language code]. Then under a console:
$ sudo dpkg -i *.deb

=== LibreOffice ===

*[http://www.libreoffice.org/download/ LibreOffice]

== Developers ==

Thanks to Alex Roitman, the details to create the Live CD are now available for future development. If you would like to contribute to this please email the gramps-developers mailing list.

* http://sourceforge.net/projects/gramps-cd/ - Sources for Live CD
* [https://launchpad.net/uck Ubuntu Customization Kit] is a tool that helps you customizing official Ubuntu Live CDs. You can add any package to the live system like, for example, language packs, applications, etc.

=== Ways to go ? ===

* A genealogy tablet ?
** I wouldn't dream of doing genealogy research without a real keyboard and a big monitor.
** A tablet may be useful for presentations (showing off). Figuring out how to install gramps (a subset) on an iPad or a Honeycomb tablet (Jython?) might be a better use of time than spinning a custom system.
** OTOH, making a nice UI for a tablet would be an interesting project. (I can just see a bunch of people I know futzing with Gramps during sacrament meeting. <g>)

There is a [http://wiki.openembedded.org/index.php/Required_software#OpenEmbedded.27s_Software_Requirements script] for [http://wiki.openembedded.org/index.php/Main_Page OpenEmbedded] support or [http://www.buildroot.org/ buildroot], [http://ymorin.is-a-geek.org/projects/crosstool crosstool-NG], [http://www.pengutronix.de/software/ptxdist/index_en.html PTXdist], ...
* Our [[GEPS_013: Gramps Webapp|Web Application]] as a local application.
* Provide more [http://en.wikipedia.org/wiki/Free_and_open_source_software FLOSS] software: [[Other_genealogy_software|programs]], [[Other_genealogy_tools| tools]].

* Consider Lubuntu or Xbuntu as a base instead of the full (fat!) Ubuntu.
* The people I would share this with would want it to include PAF (works with wine) and Family Search Indexing (I still have to try this.)

[[Category:Documentation]]

Linux Genealogy CD

2026-06-12T23:59:58Z

Sam888: /* Download the CD */

{{languages|Linux Genealogy CD}}
{{man note|You may find current Gramps downloads|On the following page [[Download]]. {{man warn|This page list unsupported historical releases of the Linux Genealogy CD}}}}
[[File:cdlabel_web_l.jpg|right|Linux Genealogy CD Rom label]]
The Linux Genealogy Desktop CD 6.1 (Released: 2010-11-29) (''The CD is available only for the x86 architecture.'')

Includes the following pre-installed genealogy software:
*'''Gramps''' 3.2.5

As well as [http://www.graphviz.org/ GraphViz] the program that draws pretty charts and graphs in Gramps.

This Live CD is based on the Ubuntu 10.10 (The Maverick Meerkat ) Desktop CD.

In addition to the Live Session, this disk also allows permanent installation of Linux and genealogical software on your computer's hard drive. This way you achieve adequate speed and the ability to save your data, and can do real work with your Linux software. Everything is similar to the Live Session, except that this is a permanent setup.

==Download the CD==

The CD can be downloaded from:

* https://archive.org/details/@webmaster_gramps-project_org

===Previous release history===



{| class="wikitable sortable"
|-
!Version
!Release Date
!Gramps version
!Notes
|-
| | [https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-1.0-live-i386.iso/download Linux Genealogy Live CD 1.0] || [https://sourceforge.net/p/gramps/mailman/message/243671/ 2005-10-22] || 2.0.8 || Ubuntu 5.10 (Breezy Badger) features pre-installed GeneWeb, and LifeLines applications
|-
| | [https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-1.0-install-i386.iso/download Linux Genealogy Install CD 1.0] || [https://sourceforge.net/p/gramps/mailman/message/243678/ 2005-10-29] || 2.0.8 || Ubuntu 5.10 (Breezy Badger) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
| | [https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-2.0-desktop-i386.iso/download Linux Genealogy Desktop CD 2.0] || [https://sourceforge.net/p/gramps/mailman/message/10070632/ 2006-06-03] || 2.0.11 || Ubuntu 6.06 (Dapper Drake) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
| | [https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-3.0-desktop-i386.iso/download Linux Genealogy CD 3.0] || [https://sourceforge.net/p/gramps/mailman/message/243733/ 2007-04-29] || 2.2.7 || Ubuntu 7.04 (Feisty Fawn) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
| | [https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-4.0-desktop-i386.iso/download Linux Genealogy CD 4.0] || [https://sourceforge.net/p/gramps/mailman/message/19668479/ 2008-06-26] || 3.0.1 || Ubuntu 8.04 (Hardy Heron) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
| | [https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download Linux Genealogy CD 6.1] || [https://sourceforge.net/p/gramps/mailman/message/26672022/ 2010-11-29] || 3.2.5 || Ubuntu 10.10 (The Maverick Meerkat) features pre-installed GeneWeb, and LifeLines applications (allows permanent installation of Linux)
|-
|}

=== Translations ===

If after installation, your desktop is not fully translated to your selected locale:
# have a look at Menu -> System -> Administration -> Languages support [http://packages.ubuntu.com/en/precise/language-selector]
# or manually [http://packages.ubuntu.com/en/precise/all/translations/ download packages with your language code]. Then under a console:
$ sudo dpkg -i *.deb

=== LibreOffice ===

*[http://www.libreoffice.org/download/ LibreOffice]

== Developers ==

Thanks to Alex Roitman, the details to create the Live CD are now available for future development. If you would like to contribute to this please email the gramps-developers mailing list.

* http://sourceforge.net/projects/gramps-cd/ - Sources for Live CD
* [https://launchpad.net/uck Ubuntu Customization Kit] is a tool that helps you customizing official Ubuntu Live CDs. You can add any package to the live system like, for example, language packs, applications, etc.

=== Ways to go ? ===

* A genealogy tablet ?
** I wouldn't dream of doing genealogy research without a real keyboard and a big monitor.
** A tablet may be useful for presentations (showing off). Figuring out how to install gramps (a subset) on an iPad or a Honeycomb tablet (Jython?) might be a better use of time than spinning a custom system.
** OTOH, making a nice UI for a tablet would be an interesting project. (I can just see a bunch of people I know futzing with Gramps during sacrament meeting. <g>)

There is a [http://wiki.openembedded.org/index.php/Required_software#OpenEmbedded.27s_Software_Requirements script] for [http://wiki.openembedded.org/index.php/Main_Page OpenEmbedded] support or [http://www.buildroot.org/ buildroot], [http://ymorin.is-a-geek.org/projects/crosstool crosstool-NG], [http://www.pengutronix.de/software/ptxdist/index_en.html PTXdist], ...
* Our [[GEPS_013: Gramps Webapp|Web Application]] as a local application.
* Provide more [http://en.wikipedia.org/wiki/Free_and_open_source_software FLOSS] software: [[Other_genealogy_software|programs]], [[Other_genealogy_tools| tools]].

* Consider Lubuntu or Xbuntu as a base instead of the full (fat!) Ubuntu.
* The people I would share this with would want it to include PAF (works with wine) and Family Search Indexing (I still have to try this.)

[[Category:Documentation]]

Website application upgrades

2026-05-27T09:38:32Z

Sam888: /* Upgrade WordPress (blog) */ Updated today to Wordpress version 7.0.0 released 2026-05-20

{{man warn|Notes for the webmaster@gramps-project.org|Used in the maintenance of the Gramps website.}}
= Upgrade Mantis Bug Tracker (bug tracker) =

<code>https://gramps-project.org/bugs/</code>

[https://www.mantisbt.org/ MantisBT] is an open source issue tracker.

[https://gramps-project.org/bugs/my_view_page.php Current installed version] 2.22.1 (released: 2019-09-27)

* Place MantisBT into [https://www.mantisbt.org/docs/master/en-US/Admin_Guide/html/admin.install.upgrade.html readonly mode] using the file <code>mantis_offline.php</code> to prevent users from using the system while the upgrade is in progress.
* Backup gramps_bugs mysql database using phpMyAdmin from the CPanel interface using the SQL format.
** Note that mantis attachments are stored in the <code>/home/gramps/public_html/files</code> folder.
* Download latest version of MantisBT ( https://github.com/mantisbt/mantisbt/releases ) - (Use the ".tar.gz" file.)
* Upload the MantisBT ".tar.gz" file into the Gramps hosting site either using ftp or the CPanel "File Manager".
* Use the CPanel "File Manager" to unarchive into <code>/home/gramps/</code> - it will create a new folder such as "mantisbt-release-2.10.0"
* Rename the new folder from such as "mantisbt-release-2.10.0" to "bugsnew"
* Copy "config_inc.php" from the old folder into the new folder (the "config_inc.php" file is located in the "config" directory.)
* Check any readme type files to make sure there are not any database schema changes required - and follow the directions if there are...
** Then check the install by using: "/mantisbt/admin/check/index.php"
** And then upgrade the installation using: "/mantisbt/admin/install.php"
* Rename the original folder from "bugs" to "bugsold"
* Rename the new folder from "bugsnew" to "bugs"
<hr>
Update the MantisBT plugins by downloading the updated version and install them (check the readme and follow any instructions)
* Source control integration plugin framework for MantisBT, including support for Github ( https://github.com/mantisbt-plugins/source-integration ) 2 part plugin (Get the master branch)[https://mantisbt.org/bugs/view.php?id=21201]
** Source control integration (version 2.3.0)
** Source Github integration (version 2.1.0)
* Google Analytics integration for MantisBT (version 2.0)( https://github.com/mantisbt-plugins/google-analytics )
<hr>
See if it works!
* Place MantisBT into normal mode by removing <code>mantis_offline.php</code>
* Login as a user
** Use the test user (see offline support document)
* Test a few things (Edit note/create feature/issue)
* Look at the bottom left corner of the main overview page where it will display the current upgraded to version number so you know you are looking at the new install (You may need to refresh to get a new copy, as there is probably some caching involved...)
<hr>
If not immediately functional
* Revert by renaming "bugs" to "bugsnew" and "bugsold" to "bugs"
* If any database schema changes had been made restore the original "gramps_bugs.sql" mysql database using phpMyAdmin.
that should put MantisBT back to square one...
<hr>
Otherwise if it worked.
* Remove the "admin" folder (Or else there is a warning each time you login to do this).
* Remove the MantisBT ".tar.gz" file you uploaded.
* Move the "bugsold" folder to <code>/home/gramps/</code> to prevent access.
* After a two weeks, remove the "bugsold" folder.
<hr>
Also check that the following two links work and are not blank:
* Changelog page
* Roadmap.
If they are follow the instructions in the offline support document.
<hr>
'''Backup the website!'''

= Upgrade MediaWiki (wiki) =

<code>https://gramps-project.org/wiki/</code>

[https://www.mediawiki.org/wiki/MediaWiki MediaWiki] is a free software open source wiki package written in PHP, originally for use on Wikipedia.

[https://gramps-project.org/wiki/index.php?title=Special:Version Current installed version] [https://www.mediawiki.org/wiki/MediaWiki_1.31 1.31.3] (released: 2019-07-02) LTS (Supported until [https://www.mediawiki.org/wiki/Version_lifecycle#Versions_and_their_end-of-life June 2021])

The gramps_wiki mysql database is quite a large, and MediaWiki upgrades are generally more likely to have problems when upgrading than other actions on the Gramps website!

* Place MediaWiki into restricted editing mode (See "LocalSettings.php" and uncomment the relevant section)
* Using the Gramps Cpanel interface go to the MySQL section, then select "phpMyAdmin" and remove the often large cache tables of gramps_wiki ( "l10n_cache" and "objectcache" ).
* Backup gramps_wiki mysql database using phpMyAdmin from the CPanel interface using the SQL format.
** If a timeout occurs try using SSH and the mysql command or even phpMyAdmin to clone/copy the existing database.
* Download latest version of MediaWiki ( https://www.mediawiki.org/wiki/Download ) - (Use the ".tar.gz" file.)
* Upload the MediaWiki ".tar.gz" file into the Gramps hosting site either using ftp or the CPanel "File Manager".
* Use the CPanel "File Manager" to unarchive it into <code>/</code> - it will create a new folder such as "mediawiki-1.31.3"

From here, you can use a combination of the Cpanel "File Manager" or ssh, so long as you get it all done!
* Rename the new folder from such as "mediawiki-1.31.3" to "wikinew"
* Copy the "LocalSettings.php" file from "wiki" to "wikinew" folder.
* Copy the entire "images" folder (quite large - nearly 1.9GB) from "wiki" to "wikinew" - you will be replacing an existing folder in wikinew. Again, you could do this with the filemanager or use ssh if you are comfortable with it). Even using ssh it takes quite a while, and I'm pretty sure it puts a load on the server...
* Copy folders from the "extensions" folder in "wiki" into "wikinew". '''Copy only the ones that do not exist there''' (that is, don't overwrite folders in the extensions directory with older versions - only copy across the ones that are not already there). We use the extensions listed below that do not come with the base install as well as a few also listed from the base install that you should not copy over. You need to check and see if there are new versions of these, as sometimes the original versions will not work with the new version of MediaWiki. Installed extensions are listed on the following page: https://gramps-project.org/wiki/index.php?title=Special:Version
** Extension that Gramps wiki uses that come with MediaWiki (do not need to be installed) but are listed in the LocalSettings.php file
*** ParserFunctions - Enhance parser with logical functions
** Thirdparty Extensions
*** Confirm User Accounts – Gives bureaucrats the ability to confirm account requests
*** LabeledSectionTransclusion
*** Variables - Parser functions allowing to work with dynamic variables in an article scoped context
*** Google Analytics Integration
** [https://www.mediawiki.org/wiki/Manual:Skins Mediawiki:Skins](Themes)
*** Default is "Vector" as it has been customised for Gramps ( see https://gramps-project.org/wiki/index.php/MediaWiki:Common.css )
*** MobileFrontEnd
**** "MinervaNeue" mobile Skin (which is the same one used on Wikipedia)

If there are any database schema changes, you may need to run the "update.php" file that is in the MediaWiki maintenance directory.
* Do that by using '''ssh''' (see offline support document) and changing to the "wiki/maintenance" directory and run <code>php update.php</code>
There may be some warnings about deprecated functions and the option to bail out - you should be able to continue to do the schema upgrade...
If it were to fail, you'll need to revert to the original files (by renaming the folders) and probably do a database restore to the unchanged version of the gramps_wiki SQL file.
Just hope it doesn't happen to you!

* Rename the original folder from "wiki" to "wikiold"
* Rename the new folder from "wikinew" to "wiki"

Otherwise if it worked.
* Place MediaWiki into normal mode
* Check the upgraded MediaWiki version details and all extensions are updated:
https://gramps-project.org/wiki/index.php?title=Special:Version
* Remove the MediaWiki ".tar.gz" file you uploaded.
* For the "wikiold" folder add a webprotect in the .Htaccess file to stop access to the old MediaWiki version (especially important if database schema update occurred)
* After a two weeks, remove the "wikiold" folder.

'''Backup the website.'''

= Upgrade WordPress (blog) =

<code>https://gramps-project.org/blog/</code>

[https://wordpress.org/ WordPress] is open source software used to create the blog.

Current installed version 7.0.0 ([https://wordpress.org/download/releases/ released:] 2026-05-20)

* Backup gramps_blog mysql database using phpMyAdmin from the CPanel interface using the SQL format.
* Login to the Gramps blog ( https://gramps-project.org/blog/wp-login.php ) using an admin login.

The Dashboard will indicated to you if there is a newer version available for updating/upgrading.

You can expect pretty good results by just:
* Clicking on the appropriate "Update to x.x.x" button to upgrade the main install.

After the update return to the Dashboard, Upgrades screen and
* Upgrade any plugins (after checking the compatibility notes for each) the following plugins are used on Gramps blog:
** Akismet Anti-Spam
** All-in-One WP Migration and Backup
** APCu Manager
** Autoptimize
** Classic Editor
** Easy HTTPS (SSL) Redirection
** Easy Updates Manager
** Github Embed
** Github Ribbon
** LightStart - Maintenance Mode, Coming Soon and Landing Page Builder
** Manage Notification Emails (Virgial)
** Google Captcha (reCAPTCHA) by BestWebSoft
** Sticky Side Buttons
** WordPress HTTPS
** WP File Manager
** WP-Optimize - Clean, Compress, Cache
** [https://wordpress.org/plugins/redirection/ Redirection]

Themes
* Do not update the Gramps Theme named "Hello Gramps!" as it has been customised by Jason Simanek (Unless you know how)
* Upgrade only the themes that come with WordPress

'''Backup the website.'''

=Announcement of upgrade email template =
* See the source for this wiki page (embedded as a comment).

=Changing to a new Hosting service=
{{stub}}
General summary of steps taken on move to current host.

=See also=
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]

[[Category:Developers/General]]

User:Sam888

2026-05-25T03:16:08Z

Sam888: /* Volunteer Website Administrator */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the Gramps Desktop websites (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)
===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==
===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-05-25T03:14:50Z

Sam888: /* Information */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the website (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)
===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==
===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[6.0 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-05-25T03:13:25Z

Sam888: /* Addons */

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the website (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)
===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==
===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] - [https://github.com/gramps-project/addons-source/pull/109 PR109] - maintained by comunity
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[5.2 Roadmap]]

[[Category:User|S]]

User:Sam888

2026-05-25T03:12:30Z

Sam888: /* Addons */ * Addon:TMGimporter - Taken over and released 2026 by eduralph for Gramps 6.

{{man note|Current Webmaster for the Gramps Project}}
Hi, I generally aim to help the developers who can program; I do alot of non-development work for the Gramps project including: testing and bug triage, website maintenance, writing and updating documentation on the wiki for new releases, building the third party addons as needed.

==Volunteer Website Administrator==
Manage and monitor the website (not Github)

*[[Website application upgrades]] - Wordpress(Blog)/MantisBT(Bug tracker)/Mediawiki(Wiki)
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]
*[[Git merge]]
* https://gramps-project.org/robots.txt
* Migration of Gramps website host from GoDaddy to a2 Hosting (2019/11/08 to 2019/11/11) (Completed)
===Wordpress(Blog)===
* Convert the existing "Hello Gramps!" 2010 theme by Jason Simanek [https://sourceforge.net/p/gramps/mailman/message/24879293/] to use a more modern mobile aware template that comes with WordPress.
* WordPress [https://wordpress.com/plugins/browse/translation Translation plugin] [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165] - research & test.

===MantisBT(Bug tracker)===
* Upgraded failed due to database needing to first be manually converted to UTF-8 collation (which means I'll finally need to manually convert from latin1_swedish_ci collation the bugtracker has been using since original installation around 2006!) 2021/07/28 Update: Almost worked but the database is partially corrupted in a few tables it seems related to [[Bug_triage#Status|Bug triage mention that "Sometime in the past 4495 issues disappeared during a mantisdb upgrade"]] so a few tables may be referring to things that don't exist!

===Mediawiki(Wiki)===
* Upgrade to Mediawiki [https://lists.wikimedia.org/pipermail/mediawiki-announce/2020-December/000268.html 1.35.1 LTS] ( Warning: MediaWiki is not yet compatible with PHP 8. See task [https://phabricator.wikimedia.org/T248925 T248925 ]for more information)
** Upgrade failed due to issue https://phabricator.wikimedia.org/T212428 ! (Possible work [https://phabricator.wikimedia.org/T212428#6669851 around]) (2021-12-08 - T212428 fix was only available in Mediawiki 1.37 and upgrade worked pass issue successfully. But wiki fails with multiple Fatal errors and blank pages, currently testing to narrow down and report issue! Reverted to existing Mediawiki!)
* 2021/12/16 Added suggested settings to LocalSettings.php for security issue https://www.mediawiki.org/wiki/2021-12_security_release/FAQ

* [https://makandracards.com/makandra/594-utf-8ify-an-existing-mysql-database UTF-8ify an existing MySQL database]

* [[MediaWiki:Common.css]]

* look at renaming the user manual to a shorter url see discussion [[Talk:Gramps_5.1_Wiki_Manual]] ( 'User Manual' instead of 'Wiki Manual': As 'User Manual' is a well-known term for the general computer user. / Use redirects either using mediawiki or as rewrite rules in the .htaccess file. )
* revisit links in wiki sidebar see discussion [[MediaWiki_talk:Sidebar]]
* [[Talk:Gramplets]] renaming suggestion.

====Extensions====
=====Existing extensions=====
======Extension:ConfirmAccount======
[[File:Request account-extension-currentconfig.png|right|thumb|150px|Extension:ConfirmAccount : Request account - page 2021/11/15 current config ]]
* [https://www.mediawiki.org/wiki/Extension:ConfirmAccount Extension:ConfirmAccount] - (Configured to required a minimum of six words for "Personal biography (plain text only): " section and a confirmed email address for final account creation)
** The following configure elements of the RequestAccount form ( https://gramps-project.org/wiki/index.php/Special:RequestAccount ):
*** 1. Top section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 2. "User account" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-text
*** 3. "Other information" section of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-ext-text
*** 4. "Other information" section (it is the first entry boxes "title") of "Request account" form: https://gramps-project.org/wiki/index.php/MediaWiki:Requestaccount-notes


* Once the account is created this extension creates a new user talk welcome message; whose configuration is managed at https://gramps-project.org/wiki/index.php/MediaWiki:Confirmaccount-welc

{{-}}

=====Language Related extensions=====
* Investigate making Mediawiki multilingual using '''MediaWiki_Language_Extension_Bundle''' see request {{bug|10978}} and [[User_talk:Avma]]
* [https://www.mediawiki.org/wiki/Directionality_support Directionality_support]
=====Requested Extensions=====
* [[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
* Test using [https://mediawiki.org/wiki/Extension:LinkTarget MediaWiki hotlink targeting extension]. that would allow linking to the lines of code & open in a target browser window (instead redirecting the existing browser window) (This extension is currently not actively maintained! )

===Mailing lists===
===== Sourceforge mailing list =====
Each of the Gramps [https://sourceforge.net/p/gramps/mailman/ Sourceforge mailing list] are backed up regularly to the [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ MBOX format] (Since 2019/11/08)
* gramps-announce
* gramps-bugs
* gramps-devel
* gramps-users

===Forum===

==== Discourse ====
The Gramps Discourse Forum is backed up regularly to the [https://meta.discourse.org/t/create-download-and-restore-a-backup-of-your-discourse-database/122710/1 Discourse XML backup format] (Since 2020-01-02)

* [https://sourceforge.net/p/gramps/mailman/message/36890927/ Announcement trial started 2020-01-02]

===== Discourse Trial =====
Investigate replacing the mailing list on Sourceforge and trial using [https://free.discourse.group/ Discourse] at https://gramps.discourse.group/
* [x] Create DNS A record and [x] redirect from https://discourse.gramps-project.org to https://gramps.discourse.group/
* [x] setup and customise discourse for the gramps project eg: logo, permissions etc
* [x] Invite people to trial?
====== Migration from sourceforge mailing list ======
* [x] Create a [https://bitnami.com/stack/discourse standalone version of Discourse]
* [x] Need to [https://sourceforge.net/p/forge/documentation/Mailing%20List%20Archives/ export] the MBOX for each [https://sourceforge.net/p/gramps/mailman/ sourceforge mailing list]
** [x] gramps-announce
** [x] gramps-bugs
** [x] gramps-devel
** [x] gramps-users
* [-] import the Sourceforge MBOX files ( https://meta.discourse.org/t/importing-mailing-lists-mbox-listserv-google-groups-emails/79773 )
** {{man menu|**Failed** due to Sourceforge (since 2017) obfuscating email addresses in mailing list mbox archive files.}}
* [ ] create a discourse backup file and
* [ ] contact the discourse support team to restore the discourse backup file.

==Things to do==
===Monitor Traffic to websites===
{{stub}}

===Addons===
* [[Addon:TMGimporter]] - Taken over and released 2026 by eduralph for Gramps 6.
** [[User:Sam888/TMG|TMG Notes]] - On hold
* [[Addon:Prerequisites Checker Gramplet]] [https://github.com/gramps-project/addons-source/pull/109 PR109] - On hold
* Direct importers instead of GEDCOM see: [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] - Just Solve the File Format Problem - On hold

===Bug Triage===
Unofficial [[Bug triage|bug triager]].

Cleanup Started: 201409 Completed 20150523 with life in between...

Gramps Bugtracker:
https://gramps-project.org/bugs/



===CI Test===
Improving CI

* https://travis-ci.org/sam-m888/gramps - On hold

;Coverage
* https://app.codacy.com/manual/gramps-project/gramps/dashboard

* [[Testing Gramps]]

=== Gramps User Manual ===

The Gramps [[User manual]] is a mix of the following:
*Reference manual
*User guide
*Tutorials (how to?)

* [https://gramps-project.org/wiki/index.php?title=Category:Cleanup Category:Cleanup]

* <s>{{bug|8888}}</s> / <s>{{bug|9042}}</s> / <s>{{bug|10919}}</s> [Review]Gramps Help button User Manual wiki-links (In progress)

====Update for Gramps 6.0====
Gramps {{man version}} [[User manual translations]]

Ensure that any new functionality is covered by user documentation.

;Update (almost) all images:
*Started: 2025-0x-xx
*Completed:

Remaining xx image links:
*(1 image) https://gramps-project.org/wiki/index.php?title=Gramps_{{man version}}_Wiki_Manual_-_About
** Update About Screen with released version (instead of alpha)

;Update and improve text to match the interface
*Started: 2025-0x-xx
*Completed:

also manually test all user accessible parts of Gramps (done as part of above two)

=====Notes on User manual update=====
Notes on various regressions, paper-cuts and annoyances noticed during the user manual update.

When I have time, issues and feature request will be created for the following if required.

* add mention about [[Template:Backup Omissions]] specifically about books.xml to user manual

<pre>
#################### As at 20200729 #################
************Bugs**************************************
[](Bug# )graphical reports - calendar - information overflows boxes (pdf) (ms-windows tested only)
[](Bug# )Merge (people) dialog does not grow larger when you expand the "Detailed Selection" section out.

%%%%%%%% Help related bugs
[] ??

************Papercuts - Enhancements******************
%%%%%%%% All for Help finding improvement see issue 10919 %%%%%%%%%%%%%
[] context menu's (right click) add an entry for "Help" at the bottom of each?
[] Add help url to context menu entry for "About: XXXXX" (as was done on addon views)
[] Dashboard Category (grampletview) ( gramps/gui/widgets/grampletpane.py : def _button_press( )
[] Also show context menu ###>>> when no database is loaded! <<<###
See https://gramps-project.org/bugs/view.php?id=10594
[] Chart Category views
[] 2 way fan chart
[] fan chart (ancestors)
[] descendant fan chart
[] Each of the "list" & "grouped list" views
[] Relationships Category view
[] Nick Halls new "Combined View" for Relationships Category
[] Families Category view
[] Events View
[] Citations List View
[] Repository List View
[] Media List View
[] Notes List View
[] People Category
[] Tree View - Grouped People
[] Tree View - People List View
[] Places Category
[] Places List View
[] Places Tree View
[] Sources Category
[] Citation Tree View
[] Sources List View
[] Geography views
[] All known places
[] All known places for one Family
[] Have they been able to meet ?
[] All places related to Events
[] All known places for one Person
[] All known places for one person with graphical information (KML files)
[] Every residence or move for a person and any descendants
[] Have these two families been able to meet ?
[] category drop down under navigator? (or change it to a context menu that you click in an empty section of the navigator section?)
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%...........................................................
[](Feature# )for the "filter" gramplets name each one (shown on Title bar when detached) and provide working help link (then update screenshots and link to wiki)
[](feature# )"Add Rule dialog": if you select a filter then select a top level category of filter" the right hand window shows random stuff from previous filters (suggest displaying a blank area only)

[] (Bug#) dashboard - order of default Gramplets is different on ms-windows versus linux? eg: top [surnames|welcome] on win 10 - how do you guarantee order ( have a look at geography view icons on toolbar each time the views order is different, which does not help with keybindings!)

[] On each "autobackup/report/export assistant wizard/make backup xml/import/export view as..." options the "File Name:" location should default to the OS's home/documents & media directory "~" [Linux/Mac OS/MS-Windows (C:\Users\<~username>\Documents) Media> (C:\Users\<username>\Pictures ) ] eg: Gtk.FileChooser.set_current_folder()
see recent issue where user overwrote report_settings.xml with a report on Macosx!

[] add a menu option under "Help" to "Open folder locations"? to aid with helping people for "user directory" etc "Media directory" (see recent difficulty with finding user directory
https://gramps-project.org/bugs/view.php?id=10370

[] text reports - Place Report - use the active selected place by default and then allow people to change (keep it consistent with how other reports are.)

[] Graph report - Family Lines - consider having "People of Interest" tab first so it's obvious that something has to be selected / or bring this report in line with others so that the Active person is already selected at a minimum. ( https://gramps-project.org/bugs/view.php?id=11598 Person had issue with graph report )

[] For each report determine what the optimal page settings are and use them as defaults

[] for each report be able to have separate settings per report for the page settings!

[] text reports- Database Summary Report - is not very useful as it does not name the "Family Tree" the summary is for or a date for reference. and it's missing an actual summary of other information eg citation/repository's it can provide more information

[] text reports - "Records Report" is not very useful as it does not name the "Family Tree" or the date produced

[] for clarity suggest adding the word "List" to the list views (this will make it easier to support people) (see my suggestion previous unmerged PR)

[] Make toolbar icons insensitive (grey them out) when not needed or available to use eg: empty list

[] If the list view is empty, add a greyed out single (non select-able) entry that instructs the user to add to the list?

[] Tool Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Tools#Tool_Selection_dialog

[] Report Selection dialog - needs help button
https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual_-_Reports#Report_Selection_dialog

[] when running a second instance of gramps if you attempt to open a family tree that's open in the first instance the break lock dialog should have an additional button option to open as read only.

[] "Books reports" dialog change the name of the second section from "Current book" to Current book items" (aids in legibility of user manual!)

[] "Family Trees" Manager button (displays "Connect to a recent database" when you hover over it) Change it to "Connect to a recent Family Tree"

[] "Family Trees" Manager - Archive (RCS) the "Revision comment" dialog should be renamed to "Archive version comment" and the label "Version description" should be the same?

[] No Menu option to add/delete/restore a Gramplet is available.

[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.

[] keybinding on Categories only goes 0 to 9(citations) and we now have 13 categories :( So repositories/media/notes have no shortcut (maybe ctl+shift+<number> ? ctl plus / minus? [SM- ok: ctl + n = next category / ctl + p = previous category]

[] age on date gramplett - awkward wording on the resulting "quick view"

[] "Family Tree Manager" for the status column the status icons need tooltips or just use words

[] Sort Events tool has no feedback on completion!

[] report options tabs issues with repeating names (due to tab reorganization!) think of better single word names!

[](feature# )For the "Web Reports" have the report test first that the file path to write to exist instead of attempting to generate the website and then after awhile failing! eg: manually type in a non existent file path and run the report.

@@@@@@@@@@@@@@User manual@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
[] Using a wiki for the user manual has already been shown that it does not make translating the manual any easier! (find a simpler way so as to not waste a translators time) as well as the overhead of maintaining the mediawiki!

[] Note that page 20 ( Gramps_5.1_Wiki_Manual_-_Reports_-_part_1 ) will be merged to ( Gramps_5.1_Wiki_Manual_-_Reports ) later as Gramps code needs to update for all subsequent pages!!)

[] geography view rename:
* "The map" tab to "Map Common"
* rename each of the tabs for the views so they either have the name of the view in full on the tab or the name appears as a text line.

[] @prculley Originally when I created that the "Add>New" menu I had intended for each option to initially switch to that particular list view and then present the editor and once the new item was created for it to be the active highlighted item in the list view, so that users could link the action they have taken with the result instead of having to search for it afterward? Do you know if this is or something similar is possible?

prcully>>(Almost) Anything is possible ;-)... I'm pretty sure that would take some code to do both switch views (do whatever clicking on item on left side does) and then invoke Editor. And then finally change active to new whatever. Probably only four lines of code for each editor.

..........................
Mentioned by others:
* It would also be great if the tag colors showed in the Person editor as well.and all the other editors where tags are shown, including the "Tag selection" list. https://www.reddit.com/r/gramps/comments/hy2xqh/option_to_show_tag_with_colors_in_relationships/

.................................................................................................
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=

which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)

depends_on = ["libwebconnect"]

mentioned in the following
https://sourceforge.net/p/gramps/mailman/message/27070037/
''In your gpr file, you can have a line like:

depends_on = ["libwebconnect"]

which is a list of id's from other gpr files. This example will ensure
that libwebconnect is loaded before your plugin. If it can't be found,
or you have a cycle, then your plugin won't be loaded.

If it is a common function, perhaps libhtml is the right place to put
it, and you can put a depends_on on that.

-Doug''

example output is on terminal only:

Cannot resolve the following plugin dependencies:
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']

[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.

..............Unsorted................................
[] Only documented behavior should be supported. Ensure that clear documentation is a requirement for contributions enhancing Gramps (Part of the PR)

[] '''Configuration Files''' Add advanced appendix that mentions the assorted files eg: Custom filters (custom_filter.xml) and report setting (?.xml) and how they are not being backed up for migration and backup? also ( recent-files-gramps.xml )
see:
* https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports_-_part_1
Report Settings
The settings chosen when generating a report is stored in the users profile, in .gramps/report_options.xml, and will be used as default settings when generating the next report. If there is a need to revert to the default options for any reason, this file can simply be deleted.

############## Website admin ####################################
[] A2 Hosting Server resources seem ok: Appdata images!
https://gramps-project.org/wiki/index.php?title=Category:AppData
(Consider another location eg github! )
(Was: Godaddy Server resources issue that caused code:500 server errors )

############## Addons #################
[] Add on Graphical Report - Descendants Lines -Error writing to Output Stream (turn off document options and make sure report defaults to the documents directory (reported a few times on the mailing list) / also report defaults to png but is able to output svg according to the wiki help page.

[] PedigreeChart help url addon goes to
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Reports#Pedigree_Chart
instead of:
https://gramps-project.org/wiki/index.php?title=PedigreeChart

[] PedigreeChart addon printing for PDF is poor eg look at the cut off title.

.............................................................
[] htree - cherry-pick changes to addon-source master

[] rebase "Timeline pedigreeview" on pedigreeview or visa versa?
.............................................................
[ ] Pluginmanager (prculley) also unlike the built in check for addons this one does not mention you need to restart gramps if you install a "gramps view" although it says it should on the addon wiki support page
..........................................................................
[] we don’t actually use SF for much any more and they’ve been having a lot of issues in the last couple of years maybe we should migrate the lists to Google Groups (jralls)

* SM another options is https://groups.io/
* 2020 We are trialing https://gramps.discourse.group/
..........................................................................
https://gramps-project.org/wiki/index.php?title=Edit_Image_Exif_Metadata
* See: Future of Exiv2? ( https://github.com/Exiv2/exiv2/issues/1018 )
..........................................................................
https://gramps-project.org/wiki/index.php?title=Gramps_5.1_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Attributes

Gramps has two dialogs called "Attribute Editor dialog" that look different but both collect the same info in the top section.

eg: from Source's attribute tab creating a new attribute.
...................................................................
</pre>

====Reports====

====Create new advanced settings appendix====
* https://gramps-project.org/wiki/index.php/Gramps_{{man version}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings

=== Gramps Developer Documents ===

In the sphinx format:
* [https://gramps-project.org/docs/ Gramps Python API]

On wiki:
* [[Gramps Data Model]]

See also:
* [[Internationalization]]
* [[Gramps Glossary]]

=== User Experience Test Plan ===
* [[GEPS 034: Improve usability]]
** [[Usability]]

* [ ] Create a new wiki page that concentrates on the '''new user experience''' (both current & planned). The mailing list suggest it was referred to as the "Aunt Martha" test and mentions them as "user stories". So lets make Aunt Martha's usage of the Gramps program better.
** [[UI_style]] ''Remember that the majority of the users are probably novices without a lot of computer experience. Design things so that your Aunt Martha could use it''
** [[GEPS_015:_Repository_Research_Support#User_Stories]] ''Aunt Martha (AM) is planning a visit to the UK National Archives''
** [[GEPS_023:_Storing_data_from_large_sources#User_story_.28Problem_that_needs_to_be_solved.29]] '' Aunt Martha should be able to continue to use Gramps just as at present''
** [http://gramps.1791082.n4.nabble.com/Multi-user-question-tp1809285p1809287.html Are you seriously suggesting that aunt Martha (or somebody's father) would really put up with something like this? ]
** [https://sourceforge.net/p/gramps/mailman/message/28455089/ The "Aunt Martha" test is the requirement that one's (hypothetical) barely-knows-how-to-turn-on-the-computer Aunt Martha should be able to easily use Gramps to manage her genealogy research. Anything that involves administering a professional-level RDBMS server like MySQL is going to be way too hard for Aunt Martha.'']
** [https://sourceforge.net/p/gramps/mailman/message/5247418/ This makes it kind of hard to email a report to Aunt Martha. It also makes it hard for Aunt Martha, who doesn't want to learn a program to tell you more about her knowledge of family history, to make changes and send it back to you.]
** [https://www.reddit.com/r/gramps/comments/bo4cb9/the_interface_seems_a_bit_overwhelming/enc6m63/ The project used to have an "Aunt Martha" test for features, where you would ask yourself "Could I easily explain how to do this over the phone to my Aunt Martha?" Maybe now I have become "Aunt Martha"...]
** [http://gramps.1791082.n4.nabble.com/extra-css-stylesheets-td1799101.html I was thinking that Aunt Martha will never download the extra stylesheets, even if she loves them, because she is not going to want to code...She still will not do it, because she knows that she is not a programmer and will not take the chance. No matter how easy or explicit the directions are that I would send to her.]
** From gramps reddit [https://www.reddit.com/r/gramps/comments/eesuy3/difficult_to_add_my_children_to_myself_can_it_be/ ...For example after installing I spent just over an hour attempting to add my children to myself and ended stopping after I couldn't figure it out, ...I have decided to move on to another program because if an old woman like myself can't work it out then who can? ]
* [ ] Update the test plan for the current version of Gramps
** [https://github.com/gramps-project/gramps/blob/master/TestPlan.txt /gramps/blob/master/TestPlan.txt] (last updated 2004)

==== Check/Mention ====
* [[Handler List]] - A list of languages that have Localized Handler's for Gramps.
* [[Calendar tools holidays]] - see if these calendars needs updating?

=== Gramps Downloads (since: 2001/04/21) ===

====Downloads Result Table====
For the various Gramps program installers.

{| class="wikitable sortable"
! #
! Download Location
! Gramps Version
! Date Checked
! Download Count
! Comment
|-
| 1 || '''[https://github.com/gramps-project/gramps Github]''' ([https://tooomm.github.io/github-release-stats/?username=gramps-project&repository=gramps]) || 6.0.0 || 2017-06-10 to 2025-04-13 || 815,145 || Official ||
|-
| 2 || '''[https://sourceforge.net/projects/gramps/files/ Sourceforge]''' [https://sourceforge.net/projects/gramps/files/stats/timeline?dates=2001-04-01%20to%202022-08-01&period=monthly]|| 6.0.0 || 2001-04-01 to 2025-04-13 || 1,064,213 || Official - Old site ( Download statistics available since 2001-04-21 (when this project was registered). )||
|-
| 3 || '''[https://portableapps.com/apps/education/gramps_portable Portableapps.com]''' [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Sourceforge] ([https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/stats/timeline?dates=2005-10-01%20to%202022-08-01&period=monthly])|| 6.0.0 || 2005-10-01 to 2025-04-13 || 959,660 || Unofficial ||
|-
| 4 || '''[https://qa.debian.org/popcon.php?package=gramps Debian]''' || 6.0.0 || 2004-01 to 2025-03 || '''Inst''' (251,795) || Debian Popularity contest statistics for Gramps (This only report Statistics for those that Opt-in to the reporting of the statistics. Usually reports the deliberate installation date for Gramps. / '''Inst'''. is the number of people who installed this package (sum of the four categories on the Debian Gramps page) ||
|-
| 5 || '''[https://chocolatey.org/packages/gramps chocolatey.org]''' || 6.0.0 || 2025-03-13 || 9,268 || Repacked Gramps AIO Microsoft-Windows installer. ||
|-
| 6 || '''[https://www.majorgeeks.com/files/details/gramps.html Majorgeeks]''' || 6.0.0 || 2025-03-13 || 12408 || Direct from them Downloads ||
|-
| 7 || '''[https://www.bytesin.com/software/Gramps/ bytesin.com]''' || 6.0.0 || 2025-03-13 || 4,341 || Publisher: Aaron R. Short&Ormus? ||
|-
| 8 || '''[https://www.chip.de/downloads/Gramps_105764449.html chip.de]''' || 6.0.0 || 2025-03-13 || 15,395 || Direct downloads ||
|-
| 9 || '''[https://gramps.softonic.findmysoft.com/ softonic.findmysoft.com]''' || 5.0.1 || 2025-03-13 || 6,935 || Direct downloads ||
|-
| 10 || '''softpedia.com''' || 6.0.0 || 2025-03-13 || 6,760 || [https://www.softpedia.com/get/Others/Miscellaneous/GRAMPS.shtml Gramps AIO] ||
|-
| 11 || '''softpedia.com''' || 5.2.2 || 2025-03-13 || 5,920 || [https://www.softpedia.com/get/PORTABLE-SOFTWARE/Education/Gramps-Portable.shtml Gramps AIO Portable] ||
|-
| 12 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 62 || [https://download.cnet.com/Gramps-for-Linux/3000-2127_4-75312607.html Gramps for Linux] ||
|-
| 13 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 176 || [https://download.cnet.com/Gramps-for-Ubuntu/3000-2127_4-75312612.html Gramps for Unbuntu] ||
|-
| 14 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 31 || [https://download.cnet.com/Gramps-for-Fedora/3000-2127_4-75312611.html Gramps for Fedora] ||
|-
| 15 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 675 || [https://download.cnet.com/GrampsAIO-64-bit/3000-2127_4-75806019.html Gramps AIO (64bit)] ||
|-
| 16 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 3,197 || [https://download.cnet.com/Gramps-AIO-32bit/3000-2127_4-75329870.html Gramps AIO (32bit)] ||
|-
| 17 || [https://download.cnet.com/developer/Gramps%20Project/i-10120741/ '''cnet.com''' - (Gramps-Project)] || 5.0.0 || 2021-06-16 || 131 || [https://download.cnet.com/Gramps/3000-2127_4-77899596.html Gramps for macOS] ||
|-
| 19 || [https://download.cnet.com/developer/PortableApps/i-6275333/ '''cnet.com''' - (PortableApps)] || 5.1.3 || 2021-06-16 || 1,748 || [https://download.cnet.com/Gramps-Portable/3000-2127_4-75329558.html Gramps Portable] ||
|-
| N/A || '''<s>[http://www.download82.com/download/windows/gramps/ download82.com]</s>''' || 5.0.0 || 20XX-0x-0x || 1,169 || Direct downloads / Website gone / historical count only||
|-
| N/A || '''<s>[https://www.computerbild.de/download/Gramps-11696626.html computerbild.de]</s>''' || 5.0.1 || 2015-04-14 - 20XX-0x-0x || 8,656 || Direct downloads / Page gone / historical count only||


|-
! Total || - || - || 2025-05-13 || 3,167,685 || <- Manual count ||
|}

The Gramps Project has broken the multi-million download milestone( Total: 3,167,685 (as at 2025-03-13) ).

Information was gathered from the sources shown that list download statistics from Links to website you can download Gramps from

The shown total downloads is not an indication of the active userbase.

* [ ]Write up a blog post or wiki page or just leave here.
* [ ]create an issue to hold the csv files.
* [ ]create a Graph to plot downloads overtime.
* [ ]Contact sites that host older versions of the Gramps files for downloads and ask them to update to the current version at least.

Here is my attempt at gathering the statistics required to answer how many download to date.

The "[https://www.macmillandictionary.com/dictionary/british/user-base User Base]" - is the number of people who use a particular product or service, especially one available on the Internet

It is very difficult to estimate userbase as you get many different types of users

* One time users who download and install Gramps and find it is not for them.
* Long term users.
* Alot of the downloads will be for users upgrading existing installations

Download Statistics commence from when the Gramps project started 2001/04/21.

A further break down of downloads is possible by (but I won't be doing that):
* Supplied by project (Source code for manual installation)
* Linux/OpenBSD etc
** Supplied by volunteers to the project for download
** Supplied by directly from the distribution website
* Microsoft Windows
** Supplied by volunteers to the project for download
** Legacy version from portableapps.com
* Apple MacOS
** Supplied by volunteers to the project for download

====Addon downloads and popularity====
As a number of people have [https://github.com/gramps-project/addons-source/pull/124#issuecomment-371301127 commented] and or raised the issue directly with me via email here is a summary of what I know:

;Question: Does the Gramps project know which addons are the most popular and are download statistics available?

;Answer: Addon downloads are not tracked and there are no plans to track them due to privacy and technical issues (see below). Even if addon downloads where tracked it would only represent a small percentage of users who check for addons!

;Question: Why?

;Answer: Github counts downloads via its releases section page only for normal downloads of files. But not for the way Gramps addon downloads are done as they are binary files that only sit in a second git repository itself in a directory per grampsXX release called download and not on the addon releases page, this is no different to the way the gramps addons were downloaded from the previous sourceforge website.

Note that we do have an the "Headline News gramplet " addon that does poll the Gramps website and was originally causing an issue making the website slow and at sometimes of day stopping it altogether as it was polling too often (once an hour from everyone who happened to be running Gramps at that moment! This was an unintended way to get DOS'ed https://en.wikipedia.org/wiki/Denial-of-service_attack ) when I took over as website admin I investigated and tracked down and changed the polling period to once a every 24 hours (for current and previous versions of Gramps!), alot of people had installed it on the Dashboard !

=====addon repositories=====
We use two addons repositories the first is for the source code where addon developers can have access

https://github.com/gramps-project/addons-source

the second is for the generated/built addons downloads and is restricted to a small group of people to attempt to avoid any security or malicious code issues, this repository is what the Gramps program is pointed at and checks for updates:

https://github.com/gramps-project/addons

= Information =
* [[Reviews#General|General Gramps Project Information]]
* [[What to do for a release]]
* [[5.2 Roadmap]]

[[Category:User|S]]

Website application upgrades

2026-05-10T03:31:31Z

Sam888: /* Upgrade WordPress (blog) */ reflect we are using the current version

{{man warn|Notes for the webmaster@gramps-project.org|Used in the maintenance of the Gramps website.}}
= Upgrade Mantis Bug Tracker (bug tracker) =

<code>https://gramps-project.org/bugs/</code>

[https://www.mantisbt.org/ MantisBT] is an open source issue tracker.

[https://gramps-project.org/bugs/my_view_page.php Current installed version] 2.22.1 (released: 2019-09-27)

* Place MantisBT into [https://www.mantisbt.org/docs/master/en-US/Admin_Guide/html/admin.install.upgrade.html readonly mode] using the file <code>mantis_offline.php</code> to prevent users from using the system while the upgrade is in progress.
* Backup gramps_bugs mysql database using phpMyAdmin from the CPanel interface using the SQL format.
** Note that mantis attachments are stored in the <code>/home/gramps/public_html/files</code> folder.
* Download latest version of MantisBT ( https://github.com/mantisbt/mantisbt/releases ) - (Use the ".tar.gz" file.)
* Upload the MantisBT ".tar.gz" file into the Gramps hosting site either using ftp or the CPanel "File Manager".
* Use the CPanel "File Manager" to unarchive into <code>/home/gramps/</code> - it will create a new folder such as "mantisbt-release-2.10.0"
* Rename the new folder from such as "mantisbt-release-2.10.0" to "bugsnew"
* Copy "config_inc.php" from the old folder into the new folder (the "config_inc.php" file is located in the "config" directory.)
* Check any readme type files to make sure there are not any database schema changes required - and follow the directions if there are...
** Then check the install by using: "/mantisbt/admin/check/index.php"
** And then upgrade the installation using: "/mantisbt/admin/install.php"
* Rename the original folder from "bugs" to "bugsold"
* Rename the new folder from "bugsnew" to "bugs"
<hr>
Update the MantisBT plugins by downloading the updated version and install them (check the readme and follow any instructions)
* Source control integration plugin framework for MantisBT, including support for Github ( https://github.com/mantisbt-plugins/source-integration ) 2 part plugin (Get the master branch)[https://mantisbt.org/bugs/view.php?id=21201]
** Source control integration (version 2.3.0)
** Source Github integration (version 2.1.0)
* Google Analytics integration for MantisBT (version 2.0)( https://github.com/mantisbt-plugins/google-analytics )
<hr>
See if it works!
* Place MantisBT into normal mode by removing <code>mantis_offline.php</code>
* Login as a user
** Use the test user (see offline support document)
* Test a few things (Edit note/create feature/issue)
* Look at the bottom left corner of the main overview page where it will display the current upgraded to version number so you know you are looking at the new install (You may need to refresh to get a new copy, as there is probably some caching involved...)
<hr>
If not immediately functional
* Revert by renaming "bugs" to "bugsnew" and "bugsold" to "bugs"
* If any database schema changes had been made restore the original "gramps_bugs.sql" mysql database using phpMyAdmin.
that should put MantisBT back to square one...
<hr>
Otherwise if it worked.
* Remove the "admin" folder (Or else there is a warning each time you login to do this).
* Remove the MantisBT ".tar.gz" file you uploaded.
* Move the "bugsold" folder to <code>/home/gramps/</code> to prevent access.
* After a two weeks, remove the "bugsold" folder.
<hr>
Also check that the following two links work and are not blank:
* Changelog page
* Roadmap.
If they are follow the instructions in the offline support document.
<hr>
'''Backup the website!'''

= Upgrade MediaWiki (wiki) =

<code>https://gramps-project.org/wiki/</code>

[https://www.mediawiki.org/wiki/MediaWiki MediaWiki] is a free software open source wiki package written in PHP, originally for use on Wikipedia.

[https://gramps-project.org/wiki/index.php?title=Special:Version Current installed version] [https://www.mediawiki.org/wiki/MediaWiki_1.31 1.31.3] (released: 2019-07-02) LTS (Supported until [https://www.mediawiki.org/wiki/Version_lifecycle#Versions_and_their_end-of-life June 2021])

The gramps_wiki mysql database is quite a large, and MediaWiki upgrades are generally more likely to have problems when upgrading than other actions on the Gramps website!

* Place MediaWiki into restricted editing mode (See "LocalSettings.php" and uncomment the relevant section)
* Using the Gramps Cpanel interface go to the MySQL section, then select "phpMyAdmin" and remove the often large cache tables of gramps_wiki ( "l10n_cache" and "objectcache" ).
* Backup gramps_wiki mysql database using phpMyAdmin from the CPanel interface using the SQL format.
** If a timeout occurs try using SSH and the mysql command or even phpMyAdmin to clone/copy the existing database.
* Download latest version of MediaWiki ( https://www.mediawiki.org/wiki/Download ) - (Use the ".tar.gz" file.)
* Upload the MediaWiki ".tar.gz" file into the Gramps hosting site either using ftp or the CPanel "File Manager".
* Use the CPanel "File Manager" to unarchive it into <code>/</code> - it will create a new folder such as "mediawiki-1.31.3"

From here, you can use a combination of the Cpanel "File Manager" or ssh, so long as you get it all done!
* Rename the new folder from such as "mediawiki-1.31.3" to "wikinew"
* Copy the "LocalSettings.php" file from "wiki" to "wikinew" folder.
* Copy the entire "images" folder (quite large - nearly 1.9GB) from "wiki" to "wikinew" - you will be replacing an existing folder in wikinew. Again, you could do this with the filemanager or use ssh if you are comfortable with it). Even using ssh it takes quite a while, and I'm pretty sure it puts a load on the server...
* Copy folders from the "extensions" folder in "wiki" into "wikinew". '''Copy only the ones that do not exist there''' (that is, don't overwrite folders in the extensions directory with older versions - only copy across the ones that are not already there). We use the extensions listed below that do not come with the base install as well as a few also listed from the base install that you should not copy over. You need to check and see if there are new versions of these, as sometimes the original versions will not work with the new version of MediaWiki. Installed extensions are listed on the following page: https://gramps-project.org/wiki/index.php?title=Special:Version
** Extension that Gramps wiki uses that come with MediaWiki (do not need to be installed) but are listed in the LocalSettings.php file
*** ParserFunctions - Enhance parser with logical functions
** Thirdparty Extensions
*** Confirm User Accounts – Gives bureaucrats the ability to confirm account requests
*** LabeledSectionTransclusion
*** Variables - Parser functions allowing to work with dynamic variables in an article scoped context
*** Google Analytics Integration
** [https://www.mediawiki.org/wiki/Manual:Skins Mediawiki:Skins](Themes)
*** Default is "Vector" as it has been customised for Gramps ( see https://gramps-project.org/wiki/index.php/MediaWiki:Common.css )
*** MobileFrontEnd
**** "MinervaNeue" mobile Skin (which is the same one used on Wikipedia)

If there are any database schema changes, you may need to run the "update.php" file that is in the MediaWiki maintenance directory.
* Do that by using '''ssh''' (see offline support document) and changing to the "wiki/maintenance" directory and run <code>php update.php</code>
There may be some warnings about deprecated functions and the option to bail out - you should be able to continue to do the schema upgrade...
If it were to fail, you'll need to revert to the original files (by renaming the folders) and probably do a database restore to the unchanged version of the gramps_wiki SQL file.
Just hope it doesn't happen to you!

* Rename the original folder from "wiki" to "wikiold"
* Rename the new folder from "wikinew" to "wiki"

Otherwise if it worked.
* Place MediaWiki into normal mode
* Check the upgraded MediaWiki version details and all extensions are updated:
https://gramps-project.org/wiki/index.php?title=Special:Version
* Remove the MediaWiki ".tar.gz" file you uploaded.
* For the "wikiold" folder add a webprotect in the .Htaccess file to stop access to the old MediaWiki version (especially important if database schema update occurred)
* After a two weeks, remove the "wikiold" folder.

'''Backup the website.'''

= Upgrade WordPress (blog) =

<code>https://gramps-project.org/blog/</code>

[https://wordpress.org/ WordPress] is open source software used to create the blog.

Current installed version 6.9.4 ([https://wordpress.org/download/releases/ released:] 2026-03-11)

* Backup gramps_blog mysql database using phpMyAdmin from the CPanel interface using the SQL format.
* Login to the Gramps blog ( https://gramps-project.org/blog/wp-login.php ) using an admin login.

The Dashboard will indicated to you if there is a newer version available for updating/upgrading.

You can expect pretty good results by just:
* Clicking on the appropriate "Update to x.x.x" button to upgrade the main install.

After the update return to the Dashboard, Upgrades screen and
* Upgrade any plugins (after checking the compatibility notes for each) the following plugins are used on Gramps blog:
** Akismet Anti-Spam
** All-in-One WP Migration and Backup
** APCu Manager
** Autoptimize
** Classic Editor
** Easy HTTPS (SSL) Redirection
** Easy Updates Manager
** Github Embed
** Github Ribbon
** LightStart - Maintenance Mode, Coming Soon and Landing Page Builder
** Manage Notification Emails (Virgial)
** Google Captcha (reCAPTCHA) by BestWebSoft
** Sticky Side Buttons
** WordPress HTTPS
** WP File Manager
** WP-Optimize - Clean, Compress, Cache
** [https://wordpress.org/plugins/redirection/ Redirection]

Themes
* Do not update the Gramps Theme named "Hello Gramps!" as it has been customised by Jason Simanek (Unless you know how)
* Upgrade only the themes that come with WordPress

'''Backup the website.'''

=Announcement of upgrade email template =
* See the source for this wiki page (embedded as a comment).

=Changing to a new Hosting service=
{{stub}}
General summary of steps taken on move to current host.

=See also=
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]

[[Category:Developers/General]]

User talk:WladimirVargas

2026-04-29T09:21:35Z

Sam888: Welcome!

'''Welcome to ''Gramps''!'''
We hope you will contribute much and well.
You will probably want to read the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents help pages].
Again, welcome and have fun! [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 09:21, 29 April 2026 (UTC)

Template:Version windows AIO64

2026-04-13T06:58:04Z

Sam888:

6.0.8<noinclude>
[[Category:Developers/Packaging ]]
[[Category:Versions]]
[[Category:Templates]]
</noinclude>

Bug triage

2026-04-09T02:00:34Z

Sam888:

;Help the Gramps project with bug triaging.

Fixing a bug always starts with reproducing it, and many times the developer does not succeed in that. Making that possible is the aim of triage.

The bug/issue tracker for Gramps is located at the following URL: https://gramps-project.org/bugs

{{man note|Interested in volunteering|Read this page and then contact the [https://forum.gramps-project.org/ Gramps developers forum] and ask for [[#MantisBT_permissions|the ability to change bugs]]}}
==Goals of Bug Triage==
===What===

The goal of bug triage is to make it easier for developers to do development by organizing the bug list for them. This means the developers are able to spend less time asking bug reporters what the problem is, confirming if it is still an issue in the latest master branch in [[Brief_introduction_to_Git|Git]].

Bug triage includes the reduction of open tickets, removal of stale/out of date tickets, and grouping of feature requests.

===How===
[[File:Mantisbt-valid-status-states.png|thumb|right|450px|MantisBT valid Status states. 
* "'''new'''" 
* "'''feedback'''" 
* "'''acknowledged'''" 
* "'''confirmed'''" 
* "'''assigned'''" 
* "'''closed'''" 
* "'''resolved'''"]]
Make sure you're using the '''current '''{{version}}''' release of Gramps, using the master branch in [[Brief_introduction_to_Git|Git]] is usually best. From a clean install of Gramps attempt to reproduce the bug that is being reported. If you cannot reproduce the bug, post a comment as such - explaining the steps you took to reproduce the bug. If you encounter a different bug, file a new bug report for that problem if one has not been filed already.

* Read a bit of the [https://www.mantisbt.org/documentation.php documentation of MantisBT] so you know what is possible.

* Be familiar with the supported [[Using_the_bug_tracker#Useful_Mantis_bug_tracker_Syntax_codes|Mantis bug tracker Syntax codes]]

* Make sure you have Gramps installed so you can test bugs and problems. Create a family tree and import the [[example.gramps]] file.
It would be beneficial to also run the master branch version of Gramps so as to test bugs that are in the master branch only.

* At the moment only projects Gramps 5.2, Gramps 6.0 and Gramps master are supported, so any bugs not closed or resolved in older versions must be resolved one way or the other:
** "'''resolved'''" in the meantime
** does not apply anymore, state why and change the status to "'''closed'''"
** version no longer supported ([https://en.wikipedia.org/wiki/End-of-life_%28product%29 EOL] versions), [[How_to_make_a_backup|backup your family trees]] and install and try with the new version
*** See: [[Previous_releases_of_Gramps|Previous releases of Gramps]]
** bug/problem still present, or move the bug to the correct project eg decide if it is a feature request?
** too little information given, "'''feedback'''" wanted from reporter
** several issues in one bug, close it asking users to submit a single ticket per issue (or rename the bug for one issue, and ask to create new ones for the other),
** other issues...

{{man note|ALWAYS|be polite when responding to a bug ticket.}}

* For the supported projects, the bugs must be triaged: Duplicate bugs "'''closed'''", set a better bug title so it is more clear for a developer what the bug is about, add extra information. Most important here is to try to duplicate the bug with the [[example.gramps]] file, as that is what the developer will spend a lot of time trying to do. Fixing a bug always starts with reproducing it, and many times the developer does not succeed in that. Making that possible is the aim of triage. Once a developer sees a bug in front of him, fixing it is often easier.

* Then there is the feature request project. These must be organised somehow. It is best you look at some of those tickets and make a suggestion on how to organize it so that the feature requests remain useful. Also giving better titles is important here, closing duplicates. Don't be afraid to close something saying users must give a better worked out request (but be polite!).

* Don't leave bugs in "'''new'''" state if they're actually no longer '''new'''.

* Bugs that are clearly not spam, and have enough info to start an investigation (even though they might turn out as a problem at submitter's end) should be made "'''acknowledged'''".

* Those that other people are able to reproduce (or reason about their validity) should be "'''confirmed'''".
** If a feature request is valid also move it to "'''confirmed'''". This only confirms it's a possibility and is not a guarantee that the Gramps project will develop and include it in a future release.

* If the bug is blocked waiting for somebody's input, mark it as "'''feedback'''".

* If somebody is actively working on a bug, this is best expressed as "'''assigned'''". If you stop working on a bug, please remove it from '''assigned''' state.
** If a developer has self assigned the issue and raised an associated pull request check that it includes a reference to the MantisBT issue as mentioned in the [[Committing_policies#Create_a_pull_request|Committing policies]] the pull request should be using one of the special keywords mentioned [[Committing_policies#Bug_tracker_integration|Bug tracker integration for Git Pull request.]]

=== Resolving bugs for developers ===
This information is for the developers following up on the submitted issues.

The {{man label|[https://gramps-project.org/bugs/roadmap_page.php Roadmap]}}page of the bug tracker lists the bugs currently prioritized for the next releases. If you are looking for a bug to fix, this is a good place to start. Placement on the roadmap is controlled by the {{man label|"Target Version"}} field for the bug. Special "X.Y.99" phony releases, such as "3.4.99" and "4.0.99", list bugs that we would eventually like to fix for the "X.Y" version, but don't really know the milestone yet. Bugs that really should hold up a release
should be on the roadmap with a real release number, and should only be moved after giving a reason or heads up on the devel list [http://sourceforge.net/mailarchive/message.php?msg_id=31870820]. If you fix a bug scheduled for a later
milestone before a previous one is out, '''please manually adjust the target release field before marking the bug resolved,''' otherwise the roadmap display will be inaccurate [http://sourceforge.net/mailarchive/message.php?msg_id=31870821].

In general, when resolving an issue, it is always a good idea to add a note with the “commit hash” (also called the Git commit “reference” or “SHA”) of the commit that fixed the problem.

When resolving issues in a maintenance branch, one should always set the "{{man label|Fixed in version}}" field to the version of the next release that will be made from that branch. This is done so that the issue properly appears in the {{man label|[https://gramps-project.org/bugs/changelog_page.php Change Log]}} page for that project.

Bugs in maintenance branch projects should not be marked as "'''resolved'''" until the developer has committed the change into the corresponding maintenance branch. Additionally, it is the developers responsibility to make sure the change has been merged into the master branch.

===MantisBT permissions===

If you don't have MantisBT permissions (the ability to change bugs' status from "new" to "feedback", "acknowledged","confirmed", "closed" or "resolved"), then feel free to ask on the [[Contact#Official|Gramps Forum]] developers section for someone to set the status for you (eg: "Could someone set bug #{{bug|1}} to "closed" please?). Once you do this enough, feel free to ask for MantisBT permissions on the same Gramps Forum developers section .

==Status==

See the summary page:
* https://gramps-project.org/bugs/summary_page.php

{{man warn|Note that sometime in the past 4495 issues disappeared during a MantisBT database upgrade|, to which a number of existing issues keep referring to.}}

==Issues==
With MantisBT:
* {{bug|0012273}} "Bugtracker" Make specific permission profile for people who are only triagers

==See also==
* [[How to create a good bug report]]
* [[Known issues]]
* [[Common problems]]

[[Category:Developers/Quality Assurance]]
[[Category:Developers/General]]
[[Category:Troubleshooting]]

User talk:Eduralph

2026-04-01T20:20:38Z

Sam888: Welcome!

Addon:TMGimporter

2026-03-31T08:38:50Z

Sam888: /* Issues */ thank you :)

{{Third-party addon}}
{{Unreleased addon}}
[[File:Tmgimporter-addon-dataset-selection-dialog-51.png|thumb|450px|"Data Set" selection dialog for TMG Importer (WIP)]]
TMG Importer is a Gramps genealogy program addon to Import from the Project backup file (*.SQZ) created by the last version (v9.05.000 released:3 Dec 2014) of "The Master Genealogist (TMG)" genealogy program from Whollygenes discontinued in 2014.

== Usage ==

* Create a new Family Tree.
* Select {{man menu|Family Trees > Import...}} from the menu and then find the location of your TMG Backup file ('''<code>*.SQZ</code>''') select the {{man button|Import}} button.
* If your TMG project contains more than one Data Set the {{man label|TMG Importer}} dialog will be shown for you to choose the Data Set to import then select the {{man button|Import TMG Data Set}} button to start the import.
** Repeat for any additional Data Sets in the TMG Project if required.

=== Before Import From TMG Backup file ===

{{man warn|Before creating the TMG Backup file(<code>*.SQZ</code>) please ensure you do the following steps in TMG}}.

==== Convert Internal Images to External ====
Using John Cardinals '''TMG Utility''' follow the instructions on his website to:
* [http://www.johncardinal.com/tmgutil/exportimages.htm#stepbystep Convert Internal Images to External]

==== Optimize - Validate File Integrity - Optimize ====
From TMG use {{man menu|File > Maintenance > Optimize}} and {{man menu|File > Maintenance > Validate File Integrity}}.
* Optimize: “Deleted records, including people, events, sources, repositories; unused media files in Slideshow; as well as duplicate place records, will be eliminated and the space reclaimed. Duplicate place records will be consolidated so that only one entry remains in the Master Place List.” (TMG Help system, “Optimize”) Also reindexes.
* Validate File Integrity: See TMG Help system, "Validate File Integrity" and "Missing Exhibits".

==== Create your TMG Backup file ====
* Then in TMG use {{man menu|File > Backup...}} to start the TMG {{man label|Backup Wizard}} to create your [http://tmg.reigelridge.com/new-computer-version.htm#backups Backup file]

=== Unsupported formats ===

This addon only supports importing from an TMG Backup (<code>*.SQZ</code>) and not directly from the file system eg: PJC / TMG / VER

== Prerequisites ==
Before '''TMG importer''' can be used you will need the following installed:
* The '''[https://pypi.python.org/pypi/dbf dbf]''' package by Ethan Furman (version 0.98.3 or greater). This reads TMG's Database(*.DBF) files
** From the command line installation for python3: <code>pip install dbf</code> or <code>pip3 install dbf</code>

== See also ==
* [[Import_from_another_genealogy_program#The_Master_Genealogist_.28TMG.29|Import from another genealogy program - The Master Genealogist (TMG)]]

== Issues ==
* Feature Request {{bug|7591}}: ''import from The Master Genealogist (TMG)''
** 2026 - [https://github.com/gramps-project/addons-source/pull/813 Port TMGimporter to Gramps 6], By eduralph

[[Category:Plugins]]
[[Category:Developers/General]]

Addon:FamilyTreeView

2026-01-15T20:01:52Z

Sam888:

{{Third-party addon}}
{{Unreleased addon}}
{{man warn|You may install the addon manually if you are interested in helping to test and report issues.}}
{{man tip|This is a placeholder page|The {{man label|FamilyTreeView}} addon is [https://github.com/ztlxltl/FamilyTreeView/issues currently in development]. Installation instructions [https://github.com/ztlxltl/FamilyTreeView available on GitHub] for manual installation and beta testing.

* [https://gramps.discourse.group/t/new-familytreeview-addon-thread-2/7014/253 Once no more major changes are planned, draft documentation will be created] ztlxltl (developer of this addon) 2026/01/16
}}

[[File:FamilyTreeView-addon-example-60.png|450px|thumb|right|"FamilyTreeView" - addon - In action showing both ancestors and descendant trees]]
'''{{man label|FamilyTreeView}}''' is an interactive {{icon|ance}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Charts_Category|Charts]]}} category view addon that presents a navigable ancestors and descendant tree using the current active person as a starting point. Clicking another person in the family tree will make that person the active person and will redraw the family tree based on them.

== Issues ==
Report issues directly to https://github.com/ztlxltl/FamilyTreeView/issues

Discussion about the addon https://gramps.discourse.group/t/new-familytreeview-addon-thread-2/7014


[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]

Addon:FamilyTreeView

2026-01-15T20:00:27Z

Sam888: /* Issues */

{{Third-party addon}}
{{Unreleased addon}}
{{man warn|You may install the addon manually if you are interested in helping to test and report issues.}}



{{man tip|This is a placeholder page|The {{man label|FamilyTreeView}} addon is [https://github.com/ztlxltl/FamilyTreeView/issues currently in development]. Installation instructions [https://github.com/ztlxltl/FamilyTreeView available on GitHub] for manual installation and beta testing.

* [https://gramps.discourse.group/t/new-familytreeview-addon-thread-2/7014/253 Once no more major changes are planned, draft documentation will be created] ztlxltl (developer of this addon) 2026/01/16
}}

[[File:FamilyTreeView-addon-example-60.png|450px|thumb|right|"FamilyTreeView" - addon - In action showing both ancestors and descendant trees]]
'''{{man label|FamilyTreeView}}''' is an interactive {{icon|ance}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Charts_Category|Charts]]}} category view addon that presents a navigable ancestors and descendant tree using the current active person as a starting point. Clicking another person in the family tree will make that person the active person and will redraw the family tree based on them.

== Issues ==
Report issues directly to https://github.com/ztlxltl/FamilyTreeView/issues

Discussion about the addon https://gramps.discourse.group/t/new-familytreeview-addon-thread-2/7014


[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]

Addon:FamilyTreeView

2026-01-15T19:45:21Z

Sam888:

{{Third-party addon}}
{{Unreleased addon}}
{{man warn|You may install the addon manually if you are interested in helping to test and report issues.}}



{{man tip|This is a placeholder page|The {{man label|FamilyTreeView}} addon is [https://github.com/ztlxltl/FamilyTreeView/issues currently in development]. Installation instructions [https://github.com/ztlxltl/FamilyTreeView available on GitHub] for manual installation and beta testing.

* [https://gramps.discourse.group/t/new-familytreeview-addon-thread-2/7014/253 Once no more major changes are planned, draft documentation will be created] ztlxltl (developer of this addon) 2026/01/16
}}

[[File:FamilyTreeView-addon-example-60.png|450px|thumb|right|"FamilyTreeView" - addon - In action showing both ancestors and descendant trees]]
'''{{man label|FamilyTreeView}}''' is an interactive {{icon|ance}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Charts_Category|Charts]]}} category view addon that presents a navigable ancestors and descendant tree using the current active person as a starting point. Clicking another person in the family tree will make that person the active person and will redraw the family tree based on them.

== Issues ==
Report issues directly to https://github.com/ztlxltl/FamilyTreeView/issues


[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]

Addon:FamilyTreeView

2026-01-15T19:41:18Z

Sam888: Removed protection from "Addon:FamilyTreeView": https://gramps.discourse.group/t/new-familytreeview-addon-thread-2/7014/253

{{Third-party addon}}
{{Unreleased addon}}
{{man warn|You may install the addon manually if you are interested in helping to test and report issues.}}



{{man tip|This is a placeholder page|The {{man label|FamilyTreeView}} addon is [https://github.com/ztlxltl/FamilyTreeView/issues currently in development]. Installation instructions [https://github.com/ztlxltl/FamilyTreeView available on GitHub] for manual installation and beta testing.}}

[[File:FamilyTreeView-addon-example-60.png|450px|thumb|right|"FamilyTreeView" - addon - In action showing both ancestors and descendant trees]]
'''{{man label|FamilyTreeView}}''' is an interactive {{icon|ance}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Charts_Category|Charts]]}} category view addon that presents a navigable ancestors and descendant tree using the current active person as a starting point. Clicking another person in the family tree will make that person the active person and will redraw the family tree based on them.

== Issues ==
Report issues directly to https://github.com/ztlxltl/FamilyTreeView/issues


[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]

Addon:FamilyTreeView

2026-01-14T23:12:13Z

Sam888: Protected "Addon:FamilyTreeView": protected until developer gives ok ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

{{Third-party addon}}
{{Unreleased addon}}
{{man warn|You may install the addon manually if you are interested in helping to test and report issues.}}



{{man tip|This is a placeholder page|The {{man label|FamilyTreeView}} addon is [https://github.com/ztlxltl/FamilyTreeView/issues currently in development]. Installation instructions [https://github.com/ztlxltl/FamilyTreeView available on GitHub] for manual installation and beta testing.}}

[[File:FamilyTreeView-addon-example-60.png|450px|thumb|right|"FamilyTreeView" - addon - In action showing both ancestors and descendant trees]]
'''{{man label|FamilyTreeView}}''' is an interactive {{icon|ance}} {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Categories#Charts_Category|Charts]]}} category view addon that presents a navigable ancestors and descendant tree using the current active person as a starting point. Clicking another person in the family tree will make that person the active person and will redraw the family tree based on them.

== Issues ==
Report issues directly to https://github.com/ztlxltl/FamilyTreeView/issues


[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]

User talk:Ximmrn

2025-12-26T23:58:13Z

Sam888: Welcome!

Website application upgrades

2025-12-12T23:18:57Z

Sam888: /* Upgrade WordPress (blog) */ On December 2, 2025, WordPress 6.9 “Gene” was released to the public.

{{man warn|Notes for the webmaster@gramps-project.org|Used in the maintenance of the Gramps website.}}
= Upgrade Mantis Bug Tracker (bug tracker) =

<code>https://gramps-project.org/bugs/</code>

[https://www.mantisbt.org/ MantisBT] is an open source issue tracker.

[https://gramps-project.org/bugs/my_view_page.php Current installed version] 2.22.1 (released: 2019-09-27)

* Place MantisBT into [https://www.mantisbt.org/docs/master/en-US/Admin_Guide/html/admin.install.upgrade.html readonly mode] using the file <code>mantis_offline.php</code> to prevent users from using the system while the upgrade is in progress.
* Backup gramps_bugs mysql database using phpMyAdmin from the CPanel interface using the SQL format.
** Note that mantis attachments are stored in the <code>/home/gramps/public_html/files</code> folder.
* Download latest version of MantisBT ( https://github.com/mantisbt/mantisbt/releases ) - (Use the ".tar.gz" file.)
* Upload the MantisBT ".tar.gz" file into the Gramps hosting site either using ftp or the CPanel "File Manager".
* Use the CPanel "File Manager" to unarchive into <code>/home/gramps/</code> - it will create a new folder such as "mantisbt-release-2.10.0"
* Rename the new folder from such as "mantisbt-release-2.10.0" to "bugsnew"
* Copy "config_inc.php" from the old folder into the new folder (the "config_inc.php" file is located in the "config" directory.)
* Check any readme type files to make sure there are not any database schema changes required - and follow the directions if there are...
** Then check the install by using: "/mantisbt/admin/check/index.php"
** And then upgrade the installation using: "/mantisbt/admin/install.php"
* Rename the original folder from "bugs" to "bugsold"
* Rename the new folder from "bugsnew" to "bugs"
<hr>
Update the MantisBT plugins by downloading the updated version and install them (check the readme and follow any instructions)
* Source control integration plugin framework for MantisBT, including support for Github ( https://github.com/mantisbt-plugins/source-integration ) 2 part plugin (Get the master branch)[https://mantisbt.org/bugs/view.php?id=21201]
** Source control integration (version 2.3.0)
** Source Github integration (version 2.1.0)
* Google Analytics integration for MantisBT (version 2.0)( https://github.com/mantisbt-plugins/google-analytics )
<hr>
See if it works!
* Place MantisBT into normal mode by removing <code>mantis_offline.php</code>
* Login as a user
** Use the test user (see offline support document)
* Test a few things (Edit note/create feature/issue)
* Look at the bottom left corner of the main overview page where it will display the current upgraded to version number so you know you are looking at the new install (You may need to refresh to get a new copy, as there is probably some caching involved...)
<hr>
If not immediately functional
* Revert by renaming "bugs" to "bugsnew" and "bugsold" to "bugs"
* If any database schema changes had been made restore the original "gramps_bugs.sql" mysql database using phpMyAdmin.
that should put MantisBT back to square one...
<hr>
Otherwise if it worked.
* Remove the "admin" folder (Or else there is a warning each time you login to do this).
* Remove the MantisBT ".tar.gz" file you uploaded.
* Move the "bugsold" folder to <code>/home/gramps/</code> to prevent access.
* After a two weeks, remove the "bugsold" folder.
<hr>
Also check that the following two links work and are not blank:
* Changelog page
* Roadmap.
If they are follow the instructions in the offline support document.
<hr>
'''Backup the website!'''

= Upgrade MediaWiki (wiki) =

<code>https://gramps-project.org/wiki/</code>

[https://www.mediawiki.org/wiki/MediaWiki MediaWiki] is a free software open source wiki package written in PHP, originally for use on Wikipedia.

[https://gramps-project.org/wiki/index.php?title=Special:Version Current installed version] [https://www.mediawiki.org/wiki/MediaWiki_1.31 1.31.3] (released: 2019-07-02) LTS (Supported until [https://www.mediawiki.org/wiki/Version_lifecycle#Versions_and_their_end-of-life June 2021])

The gramps_wiki mysql database is quite a large, and MediaWiki upgrades are generally more likely to have problems when upgrading than other actions on the Gramps website!

* Place MediaWiki into restricted editing mode (See "LocalSettings.php" and uncomment the relevant section)
* Using the Gramps Cpanel interface go to the MySQL section, then select "phpMyAdmin" and remove the often large cache tables of gramps_wiki ( "l10n_cache" and "objectcache" ).
* Backup gramps_wiki mysql database using phpMyAdmin from the CPanel interface using the SQL format.
** If a timeout occurs try using SSH and the mysql command or even phpMyAdmin to clone/copy the existing database.
* Download latest version of MediaWiki ( https://www.mediawiki.org/wiki/Download ) - (Use the ".tar.gz" file.)
* Upload the MediaWiki ".tar.gz" file into the Gramps hosting site either using ftp or the CPanel "File Manager".
* Use the CPanel "File Manager" to unarchive it into <code>/</code> - it will create a new folder such as "mediawiki-1.31.3"

From here, you can use a combination of the Cpanel "File Manager" or ssh, so long as you get it all done!
* Rename the new folder from such as "mediawiki-1.31.3" to "wikinew"
* Copy the "LocalSettings.php" file from "wiki" to "wikinew" folder.
* Copy the entire "images" folder (quite large - nearly 1.9GB) from "wiki" to "wikinew" - you will be replacing an existing folder in wikinew. Again, you could do this with the filemanager or use ssh if you are comfortable with it). Even using ssh it takes quite a while, and I'm pretty sure it puts a load on the server...
* Copy folders from the "extensions" folder in "wiki" into "wikinew". '''Copy only the ones that do not exist there''' (that is, don't overwrite folders in the extensions directory with older versions - only copy across the ones that are not already there). We use the extensions listed below that do not come with the base install as well as a few also listed from the base install that you should not copy over. You need to check and see if there are new versions of these, as sometimes the original versions will not work with the new version of MediaWiki. Installed extensions are listed on the following page: https://gramps-project.org/wiki/index.php?title=Special:Version
** Extension that Gramps wiki uses that come with MediaWiki (do not need to be installed) but are listed in the LocalSettings.php file
*** ParserFunctions - Enhance parser with logical functions
** Thirdparty Extensions
*** Confirm User Accounts – Gives bureaucrats the ability to confirm account requests
*** LabeledSectionTransclusion
*** Variables - Parser functions allowing to work with dynamic variables in an article scoped context
*** Google Analytics Integration
** [https://www.mediawiki.org/wiki/Manual:Skins Mediawiki:Skins](Themes)
*** Default is "Vector" as it has been customised for Gramps ( see https://gramps-project.org/wiki/index.php/MediaWiki:Common.css )
*** MobileFrontEnd
**** "MinervaNeue" mobile Skin (which is the same one used on Wikipedia)

If there are any database schema changes, you may need to run the "update.php" file that is in the MediaWiki maintenance directory.
* Do that by using '''ssh''' (see offline support document) and changing to the "wiki/maintenance" directory and run <code>php update.php</code>
There may be some warnings about deprecated functions and the option to bail out - you should be able to continue to do the schema upgrade...
If it were to fail, you'll need to revert to the original files (by renaming the folders) and probably do a database restore to the unchanged version of the gramps_wiki SQL file.
Just hope it doesn't happen to you!

* Rename the original folder from "wiki" to "wikiold"
* Rename the new folder from "wikinew" to "wiki"

Otherwise if it worked.
* Place MediaWiki into normal mode
* Check the upgraded MediaWiki version details and all extensions are updated:
https://gramps-project.org/wiki/index.php?title=Special:Version
* Remove the MediaWiki ".tar.gz" file you uploaded.
* For the "wikiold" folder add a webprotect in the .Htaccess file to stop access to the old MediaWiki version (especially important if database schema update occurred)
* After a two weeks, remove the "wikiold" folder.

'''Backup the website.'''

= Upgrade WordPress (blog) =

<code>https://gramps-project.org/blog/</code>

[https://wordpress.org/ WordPress] is open source software used to create the blog.

Current installed version 6.9.0 ([https://wordpress.org/download/releases/ released:] 2025-12-02)

* Backup gramps_blog mysql database using phpMyAdmin from the CPanel interface using the SQL format.
* Login to the Gramps blog ( https://gramps-project.org/blog/wp-login.php ) using an admin login.

The Dashboard will indicated to you if there is a newer version available for updating/upgrading.

You can expect pretty good results by just:
* Clicking on the appropriate "Update to x.x.x" button to upgrade the main install.

After the update return to the Dashboard, Upgrades screen and
* Upgrade any plugins (after checking the compatibility notes for each) the following plugins are used on Gramps blog:
** Akismet Anti-Spam
** All-in-One WP Migration and Backup
** APCu Manager
** Autoptimize
** Classic Editor
** Easy HTTPS (SSL) Redirection
** Easy Updates Manager
** Github Embed
** Github Ribbon
** LightStart - Maintenance Mode, Coming Soon and Landing Page Builder
** Manage Notification Emails (Virgial)
** Google Captcha (reCAPTCHA) by BestWebSoft
** Sticky Side Buttons
** WordPress HTTPS
** WP File Manager
** WP-Optimize - Clean, Compress, Cache
** [https://wordpress.org/plugins/redirection/ Redirection]

Themes
* Do not update the Gramps Theme named "Hello Gramps!" as it has been customised by Jason Simanek (Unless you know how)
* Upgrade only the themes that come with WordPress

'''Backup the website.'''

=Announcement of upgrade email template =
* See the source for this wiki page (embedded as a comment).

=Changing to a new Hosting service=
{{stub}}
General summary of steps taken on move to current host.

=See also=
*[[.dtd_and_.rng]]
*[[Rollover for the manual]]

[[Category:Developers/General]]

GEPS 046: FamilySearch Integration

2025-11-22T20:58:20Z

Sam888: test edit

GEP to document discussions about Gramps FamilySearch integration.

== Functionality ==

What functionality would our users like to see?

* '''Auto-import basic information''': If a user has already linked their FamilySearch ID, it would be incredibly helpful to automatically import their core information at the start of their initial research. This would save countless hours and prevent users from having to rebuild everything from scratch. (Jeff - jj0192)

* '''Duplicate detection and merging''': Adding a feature that can identify and merge duplicate FSIDs would streamline the workflow and prevent confusion caused by repeated records. (Jeff - jj0192)

== Integration ==

How integrated should the solution be with the Gramps GUI?

==Feature request==
* {{bug|3377}} Connect and synchronize Gramps with the FamilySearch API.

===Existing addons===
* Jean Michault's PersonFS is a gramplet to interface Gramps with familysearch.com. https://github.com/jmichault/PersonFS

* gramps plugin for syncing with FamilySearch. Uses API keys from Jean Michault's project, and code is rebuilt with added features. Should clear cache with the clear cache button in the gramplet before closing down Gramps, may face issues with children not showing up in the compare window if you do not clear the cache. https://github.com/SourceAirbender/FSG_Sync

== See also ==
* [https://gramps.discourse.group/t/familysearch-integration-with-gramps/8744/66?u=gramps-project FamilySearch Integration with Gramps] Gramps forum
* [https://developers.familysearch.org/main/reference/api-reference-guide FamilySearch API Reference Guide]

[[Category:GEPS|F]]

User:RokeJulianLockhart

2025-11-06T02:07:38Z

Sam888: hi

[[Category:User|R]]

User talk:RokeJulianLockhart

2025-11-06T02:04:23Z

Sam888: Welcome!

Talk:PseudonymTree.gramps

2025-11-04T23:41:23Z

Sam888:

Well, it is proving impossible to upload a Tree that is at all compatible with import to Gramps.

The Gramps file compression format is .gzip and .zip compressed files are 'corrupt'.

Media wiki only accepts .zip and .gz formats. But the upload validator does not recognize the .gzip MIME type (which is the identifier Gramps embeds in the file) as being a .gz file. So uploads fail. (2 years ago, it seems to have failed silently.)

<pre>
File extension ".zip" does not match the detected MIME type of the file (application/gzip).
Source file
Source filename:
Maximum file size: 100 MB

Permitted file types: png, gif, jpg, jpeg, ogg, zip, gz, svg, pdf.
</pre>

:Send me the file and I'll check it out. In the mean time attach file to a feature request on the bugtracker and link to that. [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 05:18, 28 September 2022 (UTC) webmaster@gramps-project.org

<hr />
Thanks! created a bug report with the 7zip created .gz file attached. (Tweaked the Researcher XML block with Notepage++ since Researcher & Owner info is such a pain verify inside Gramps.) Thought this might be better than sending it by eMail too.

{{bug|0012696}}: MediaWiki does not accept Gramps compressed .gzip MIME type for .gz uploads

[[User:Bamaustin|Bamaustin]] ([[User talk:Bamaustin|talk]])

:Hi Gioto Thanks for fixing the download. [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 23:41, 4 November 2025 (UTC)

User talk:Sam888

2025-10-22T04:47:54Z

Sam888: /* Editing User:Sam888#Update_for_Gramps_6.0 section */ Prefer you copy what you need and then remove individual notes as needed from my page

=Reminder to add when you can pretty please :)=
[[User_talk:GulliblePangolin#Add_Wikipedia:Citation_templates]]
[[User:GulliblePangolin|GulliblePangolin]] ([[User talk:GulliblePangolin|talk]]) 02:34, 14 May 2020 (UTC)
:Ok, on my list, as mentioned cannot promise a eta apart from within 6 months, [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 00:16, 16 May 2020 (UTC)

=Mediawiki request:Lua Script=
Hi Sam888, When you have a moment can you consider installing Lua script so we can use the current generation of templates from mediawiki/wikipedia some of the benefits are improved performance and simpler to program the templates. [[User:Daleathan|Daleathan]] ([[User talk:Daleathan|talk]]) 23:37, 29 May 2020 (UTC)
:: Ok I'd like this installed also please. Attempted to bring a template across from wikipedia and found out LUA was not installed here. --[[User:Gioto|Gioto]] ([[User talk:Gioto|talk]]) 22:45, 14 July 2020 (UTC)

Wouldn't a full implementation of Lua script interpreter require a huge commitment to adding Security, monitoring for malware and server overloads? Since it is user programming, it would probably also need a testbed site to minimize the risk of crashing the public site. There DOES seem to be a safer intermediate option where Lua Script can be used like a compiler to generate debugged static templates.

It seems like a more widely leveraged investment would be to add a more modern WYSIWYG page content editor. (Since the [https://www.mediawiki.org/wiki/Editor#Former javascript-based MediaWiki editor] we're currently using was deprecated in January!)

[[User:Bamaustin|Bamaustin]] ([[User talk:Bamaustin|talk]]) 23:46, 14 July 2020 (UTC)

:::I'll investigate if this is possible on our current hosting plan and if Gramp-project really needs to use LUA. (We are currently using MediaWiki 1.31.3 and that editor was removed in MediaWiki 1.32.x ) [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 00:35, 16 July 2020 (UTC)
::::Hi @Sam888 Thanks for the consideration to investigate. @Bamaustin I've no opinion about Lua and the commitment required security wise. Not sure how a replacement editor will help in my case as the template I was bringing over works outside of CSS code. Both your efforts are appreciated --[[User:Gioto|Gioto]] ([[User talk:Gioto|talk]]) 03:12, 16 July 2020 (UTC)

: Hi Sam888, some the reasons why I want LUA are mentioned on my talk page, thanks anyway --[[User:Daleathan|Daleathan]] ([[User talk:Daleathan|talk]]) 09:29, 20 July 2020 (UTC)

=renaming the gramplets page =
Do you have any suggestions on if I should do this change? Thank you for noticing. --[[User:Gioto|Gioto]] ([[User talk:Gioto|talk]]) 08:33, 31 August 2020 (UTC)
: Good Idea. Please hold off doing this until Mediawiki has been upgraded. Just waiting on the release of MediaWiki 1.35.x (LTS) which was meant to be released in August! Testing of Mediawiki has gone well with this version so far. [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 04:31, 1 September 2020 (UTC)

=Synchronizing user manual=
Hi, do you have a simpler method of syncing the user manual? I was considering going page by page and adding in missing English sections to the other languages pages (in English only), like I just did for the about page, or should I not do that? Can I swap the order of the two templates at the top and bottom so that language is 1st then the index template and at the bottom in reverse of that, so the language section is below the language template? [[User:Daleathan|Daleathan]] ([[User talk:Daleathan|talk]]) 06:47, 29 January 2021 (UTC)
eg: change:
* (man index| )
* (languages| )
to
* (languages| )
* (man index| )

:: Hi Dale, thanks for considering I'm pretty sure it would be appreciated. As for a simpler method sorry no, currently and for the foreseeable future it is only a manual process, the person who moved the user manual to the wiki is no longer with the project and the method the project used before was able to be packaged with the program for offline use as well as supporting translation offline quite easily using the [https://www.sphinx-doc.org/en/1.5/intl.html Sphnix system]! I agree that swapping the order of the templates makes sense, but hold off until the 5.2 user manual rollover please .[[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 00:43, 5 February 2021 (UTC)

:::Hi, note that with Gary's offline pdf generator the [https://gramps-project.org/wiki/index.php/Manual_Generation_5.1#Preparing_for_consolidated_manual_creation following section ] mentions the script needs ( All pages should have a Navigation then Language in header area and All pages should have a Navigation then Language in footer area ) so the reverse of what Dale is suggesting. [[User:Patsyblefebre|Patsy B Lefebre]] ([[User talk:Patsyblefebre|talk]]) 08:22, 12 October 2023 (UTC)

= [[Template:Icon/doc]] =

Hi Sam,

Quit a lot of the icons I'm tying to use during translating the user manual, are showing question mars for example; {{icon|tdow}} I'd expect it to show a drop down list icon, or, is there something wrong with my settings?
----
I'd really like to learn how these icon family templates can be repaired & properly added too. A couple years ago, this domain had bandwidth issues that rendering errors when webpages had too many icons inserted. That seems to have been cleared up.

But questions on how to maintain/repair/use the transclusion template for graphics have never been answered. (I think that the person who originally added [[Template:Icon/doc|these templates]] and the [[Gramps_icon_set]] templates may no longer be active.) And I find the parameter passing portion of template writing to be indecipherable. (As you might be able to tell from my failed attempt to build a 'deprecated notice' template.

[[User:Bamaustin|Bamaustin]] ([[User talk:Bamaustin|talk]]) 14:52, 15 July 2021 (UTC)

: I think that the person who originally added [[Template:Icon/doc|these templates]] and the [[Gramps_icon_set]] templates may no longer be active

No I'm active and in our [https://gramps-project.org/wiki/index.php/User_talk:Daleathan previous conversation] on my talk page I mentioned the reason was:
:: the only way to improve the icon template is for the webmaster(That is Sam888 right?) to install Lua scripting and then we can use the current version of the icon template that is written in Lua

So we wait. [[User:Daleathan|Daleathan]] ([[User talk:Daleathan|talk]]) 22:50, 15 July 2021 (UTC)

Can't we still populate the missing items even without migrating to a current version in Lua? It may not be the best approach but, as the old proverb Voltaire quoted: “best is the enemy of the good”

[[User:Bamaustin|Bamaustin]] ([[User talk:Bamaustin|talk]]) 23:03, 15 July 2021 (UTC)

::: I'll attempt to update Media-wiki again this weekend hopefully they have worked out the issues I'm encountering! [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 01:52, 16 July 2021 (UTC)

:::: Did attempt upgrade of Mediawiki but it failed and the suggested [https://phabricator.wikimedia.org/T212428 work arounds] did not work! At this point I'm considering installing a new copy of Mediawiki and manually ( or programmatically ) copying over all the existing content, I'll research this option a bit more and may have to call on volunteers to help with the move! [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 01:03, 23 July 2021 (UTC)

= Multilingual website =
Hi, Have you considered instead of Wordpress for the Blog using Joomla because you can create a multilingual website, without having to install any third party extension?

https://docs.joomla.org/J3.x:Setup_a_Multilingual_Site

[[User:CallMeDave|CallMeDave]] ([[User talk:CallMeDave|talk]]) 09:43, 19 July 2021 (UTC)

:Yes; previously investigated with a view to integrating both the blog and wiki into one and while promising the amount of the effort involved to migrate both to Joomla is significant, as well as not being as simple as Mediawiki for users. Only replacing the blog is a strong possibility but requires a new Gramps site template to be created and all the old blog entries etc to be migrated again a lot of effort. Thanks for the suggestion and link. [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 00:58, 23 July 2021 (UTC)

:: [https://gramps.discourse.group/t/can-we-make-the-project-home-page-more-multilingual-without-excessive-labor/8165 Can we make the project home page more multilingual without excessive labor?] emyoulation (Brian McCullough) 2025-08-16

::: Sam, fyi see [https://weblate.org/en/news/archive/weblate-cdn-translate-static-pages-easily/ these] [https://docs.weblate.org/en/latest/devel/html.html#cdn-addon-config weblate] [https://github.com/WeblateOrg/weblate/issues/1066 links] [[User:Patsyblefebre|Patsy B Lefebre]] ([[User talk:Patsyblefebre|talk]]) 07:03, 16 August 2025 (UTC)

:::: Thanks you [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 22:24, 17 August 2025 (UTC)

=Notification test=
[https://gramps-project.org/bugs/view.php?id=12344 0012344: MediaWiki 'changed page' notifications sometimes mangle links to include 'ftp' to make invalid URL]

=Welcome back=
Hi Sam,
Good to see you're back :)
Can you answer this question please [https://gramps-project.org/wiki/index.php/User_talk:Patsyblefebre /User_manual_translations_check_of_redirects_per_Language#Translation_section_of_forum_does_it_exist.3F Translation section of forum does it exist?]
If not does the forum need one?
[[User:Patsyblefebre|Patsy B Lefebre]] ([[User talk:Patsyblefebre|talk]]) 08:14, 12 October 2023 (UTC)

=FYI: Proposal to use GitHub Issues by Nick Hall=
Have you seen
* [https://sourceforge.net/p/gramps/mailman/message/59113680/ Gramps-devel - Proposal to use GitHub Issues] ?

No one has mentioned the maintenance burden/aspect on you that using Github issues would alleviate?

Happy new year
[[User:Patsyblefebre|Patsy B Lefebre]] ([[User talk:Patsyblefebre|talk]]) 23:39, 4 January 2025 (UTC)

::Thanks missed that! HPNY. [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 02:22, 15 January 2025 (UTC)
:::Your welcome [[User:Patsyblefebre|Patsy B Lefebre]] ([[User talk:Patsyblefebre|talk]]) 07:49, 15 January 2025 (UTC)

=Weblate status widgets=
Weblate changed the url path of the widgets, but updating the path [https://gramps-project.org/wiki/index.php/Template:Translators/Weblate here] on the wiki still does not show the widgets? Can you check please? Thanks [[User:Daleathan|Daleathan]] ([[User talk:Daleathan|talk]]) 21:49, 13 May 2025 (UTC)
:Thanks I'll look at it! [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 03:58, 18 May 2025 (UTC)
::Looks to be working now. [[User:Patsyblefebre|Patsy B Lefebre]] ([[User talk:Patsyblefebre|talk]]) 07:05, 16 August 2025 (UTC)

=Editing User:Sam888#Update_for_Gramps_6.0 section=
Hi Sam, instead of me copying your [[User:Sam888#Update_for_Gramps_6.0]] section is it ok if I edit it as I update the user manual (I'll be careful). Thanks [[User:Gioto|Gioto]] ([[User talk:Gioto|talk]]) 00:44, 22 October 2025 (UTC)
:Prefer you copy what you need and then remove individual notes as needed from my page ( otherwise I'll keep getting notified via email!) Thanks again for the improvements. [[User:Sam888|Sam888]] ([[User talk:Sam888|talk]]) 04:47, 22 October 2025 (UTC)