Gramps - User contributions [en]

Gramps 5.2 Wiki Manual - User Directory

2024-09-14T13:02:22Z

DaveSchweisguth: Remove stray space

{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix documents the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. That directory, or folder, is stored at different locations due to

* differences in operating systems
* your username, i.e. the account with which you've logged into your computer. Where ''<username>'' is shown below it should be replaced by your username.
* user configuration

__TOC__

== New and old default locations and fallback behavior==
In Gramps 5.2, on every operating system, the default location of the user directory changed. New and old default user directory locations for each OS are given below. If Gramps 5.2 and later detects a user directory in the old default location, it will use that directory and not create one in the new default location. Otherwise, it will create a user directory in the new default location.

== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is {{new|5.2.0}}

/home/''<username>''/.local/share/gramps

In Gramps 5.1 and earlier, the user directory on a POSIX-style environment was

/home/''<username>''/.gramps

This is true for [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris] and [https://wikipedia.org/wiki/Unix Unix].

For brevity, you can use tilde notation. The path above can be simplified to

~''<username>''/.local/share/gramps

or, to avoid referring to the username,

~/.local/share/gramps

You can also use the [http://www.linfo.org/home_directory.html '''$HOME''' environment variable]. Although Gramps will not recognize environment variables in paths internally, you can use them in a terminal or in scripts. Using '''$HOME''', the path above can be simplified to

$HOME/.local/share/gramps

==macOS==
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
The default user directory location for Gramps on macOS, both the [[Mac OS X:Application package]] and [[Build_from_source#Mac_OS_X|built from source]], is (similar to other POSIX systems) {{new|5.2.0}}

/Users/''<username>''/.local/share/gramps

In Gramps 5.1 and earlier, the user directory for the Gramps [[Mac OS X:Application package]] was

/Users/''<username>''/Library/Application Support/gramps

but the user directory for [[Build_from_source#Mac_OS_X|Gramps built from source on macOS]] was (similar to other POSIX systems)

/Users/''<username>''/.gramps

=== Accessing hidden directories in macOS ===
macOS filenames, including directories, starting with "." (period) do not show up in Finder. Access the Gramps user directory in any of these ways:
* In Finder, navigate to the directory which contains the hidden file or directory you want to see and type command-shift-. (period). All of the hidden files and directories in that directory will be shown.
* Click on [https://osxdaily.com/2011/08/31/go-to-folder-useful-mac-os-x-keyboard-shortcut/ {{man menu|Go -> 'Go to Folder...'}}] in the Finder, and type
~/.gramps
: in the resulting macOS {{man label|Go to the Folder}} dialog box.
* Open a terminal window using the Terminal application and type
ln -s ~/.gramps ~/Documents/Gramps
which will make Finder show the directory as a folder in your Documents folder named "Gramps". (You can replace "Gramps" with whatever name you wish, but use a \ before any spaces.)

== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]
The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is {{new|5.2.0}}

C:\Users\''%username%''\AppData\Local\gramps

In Gramps 5.1 and earlier, the user directory for Windows 7 (and newer) was

C:\Users\''%username%''\AppData\Roaming\gramps

Alternately, you can use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA environment variable] to avoid referring to the username. (We've chosen to use the username environment variable in the documentation for Windows rather than '''''<username>''''' used for documenting other OSes.) Although Gramps will not recognize environment variables for paths internally, you can use them within Windows to find Gramps user files. The path above can be simplified to:
%LocalAppData%\gramps

=== Accessing hidden directories in MS Windows ===
On Microsoft Windows, filenames and folder for programs and userdata are [https://wikipedia.org/wiki/Hidden_file_and_hidden_directory hidden] in the ''File Explorer''. To make access to the Gramps user directory easy follow the following advice from Microsoft:
* [https://support.microsoft.com/en-ca/help/14201/windows-show-hidden-files Show hidden files - Windows Help]

Like the '''User Directory''', the location for programs/applications is also hidden from browsing with Windows Explorer.

The default location for an installation on a Windows 7 (and newer) system is
C:\Program Files\GrampsAIO64-5.X.X
{{-}}

== See Also ==
* [[Gramps_5.2_Wiki_Manual_-_Command_Line|Command Line]] Configuration (config) option with [[Gramps_5.2_Wiki_Manual_-_Command_Line#Environment_variables|Environment Variables]]
* [https://winaero.com/how-to-enter-file-location-manually-in-gtk-3-opensave-dialog/ Switching from Breadcrumbs to a location text box] using {{Man key press|Crtl|L}} in GTK file dialogs
* Discourse forum threads :
** [https://gramps.discourse.group/t/how-to-set-the-base-path-from-media-relative-to-grampshome/481/2 how to use Environment Variables in Gramps]
** [https://gramps.discourse.group/t/manually-installing-addons/5696/5 Using Python Eval gramplet to list the Plugins folder path]
** [https://gramps.discourse.group/t/troubleshooting-gramps-paths-and-environmental-variables/5692 Troubleshooting Gramps paths and environmental variables] with the [[Gramps_5.2_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] gramplet

*{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{grampsmanualcopyright}}
[[Category:Documentation|U]]

Gramps 5.2 Wiki Manual - Categories

2024-09-08T22:40:11Z

DaveSchweisguth: /* ⚙ Configuration Options */ Update map cache location

{{man index|Gramps 5.2 Wiki Manual - Main Window|Gramps 5.2 Wiki Manual - Manage Family Trees|5.2}}
{{languages|Gramps 5.2 Wiki Manual - Categories}}
{{#vardefine:chapter|4}}
{{#vardefine:figure|0}}
[https://en.wikipedia.org/wiki/Genealogy#Types_of_information Genealogical information] is very broad and can be extremely detailed. Displaying it poses a challenge that Gramps takes on by dividing and organizing the information into a series of Categories, each with their own Views. Each View displays a portion of the total information, selected according to a particular category. This will become clearer as we explore the different Categories.

== Categories of the Navigator ==
The different Categories of the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Navigator|Navigator]]: The navigator is located at the left of the window and allows selection of the different categories.

[[File:Gramps-sidebar-50.png|left|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Navigator sidebar with Navigator mode "Category" selection drop down list shown]]

*{{man label|{{icon|gram}} '''[[#Dashboard_Category|Dashboard]]'''}}: Displays different general purpose Gramplets, small widgets that can help in your genealogical research.

*{{man label|{{icon|peop}} '''[[#People_Category|People]]'''}}: List of people in the family tree.

*{{man label|{{icon|rela}} '''[[#Relationships_Category|Relationships]]'''}}: Displays the relationships between the Active Person and other people in a textual way. This includes the parents, siblings, spouses, and children of that person.

*{{man label|{{icon|fami}} '''[[#Families_Category|Families]]'''}}: List of families in the family tree.

*{{man label|{{icon|ance}} '''[[#Charts_Category|Charts]]'''}}: Displays graphical trees for the selected person.

*{{man label|{{icon|even}} '''[[#Events_Category|Events]]'''}}: List of events in the family tree.

*{{man label|{{icon|plac}} '''[[#Places_Category|Places]]'''}}: List of places in the family tree.

*{{man label|{{icon|geog}} '''[[#Geography_Category|Geography]]'''}}: Displays place data of your family tree on a map.

*{{man label|{{icon|sour34}} '''[[#Sources_Category|Sources]]'''}}: List of sources in the family tree.

*{{man label|{{icon|cite}} '''[[#Citations_Category|Citations]]'''}}: List of citations in the family tree.

*{{man label|{{icon|repo}} '''[[#Repositories_Category|Repositories]]'''}}: List of repositories in the family tree.

*{{man label|{{icon|medi}} '''[[#Media_Category|Media]]'''}}: List of media objects in the family tree.

*{{man label|{{icon|note}} '''[[#Notes_Category|Notes]]'''}}: List of notes in the family tree.

{{-}}
[[File:Navigator-mode-selection-drop-down-51.png|284px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} [[Gramps_5.2_Wiki_Manual_-_Main_Window#Drop-Down_navigator_mode|Drop-Down navigator mode]] showing People Category view modes]]

The categories can contain several ways of presenting the data. Each specific way is called a View mode.
For example:
* {{icon|peop}} '''People''' ''view category''
** '''{{man label|Grouped People}}''' ''default hierarchical list mode''
** '''{{man label|People}}''' ''alternate flat list mode''
{{-}}
For each category you have a variety of ways to switch between View modes:
# By selecting the relevant icon from the toolbar
# From the menu {{man menu|View > ... }}
# Via the number-based [[Gramps_5.2_Wiki_Manual_-_Keybindings#List_Views|keybindings]] (aka keyboard shortcuts) to ''Change the view mode to correspond to number key {{man key press|0}}/{{man key press|1}}/{{man key press|2}}/../{{man key press|9}} in this view category''
# From the Navigator bar when the Drop-down or Expander features are selected (See [[Gramps_5.2_Wiki_Manual_-_Main_Window#Switching_Navigator_modes|Switching Navigator modes]])
{{-}}
{{man tip|By default, the Navigator is configured to select Views by main Category|New users may find that re-configuring to the Drop-Down option would make selecting the alternate View modes more intuitive. The Drop-down and Expander options create mode selectors in close proximity to the Category icon and those interface options will not change with context.
 
[[File:Navigator-mode-selection-dropdownlist-50.png|center|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Navigator mode selection drop down list. See [[Gramps_5.2_Wiki_Manual_-_Main_Window#Switching_Navigator_modes|Switching Navigator modes]] ]]

}}

{{-}}
The following sections provide a brief description of each category and the view modes within.

== Dashboard Category ==
[[File:DashboardCategory-DashboardView-default-gramplets-52.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dashboard Category (Default View)]]
[[File:HelloWorldGramplet-example-shown-embeded-on-DashboardCategory-52.png|right|thumb|450px|Hello World Gramplet - example (shown embedded on Dashboard Category View / Context menu "Add a gramplet" also shown)]]
This contains the {{icon|gram}} '''Dashboard''', which shows a number of widgets, called [[Gramps_5.2_Wiki_Manual_-_Gramplets#What_is_a_Gramplet|Gramplets]], that can help you in your research.

Two Gramplets are shown by default on start-up (the [[Gramps_5.2_Wiki_Manual_-_Gramplets#Top_Surnames|Top Surname]] and [[Gramps_5.2_Wiki_Manual_-_Gramplets#Welcome|Welcome to Gramps!]] Gramplets) in two column configuration. (The number of columns can be changed with the [[#Gramplet_Layout|Gramplet layout]] "Configure" controls provided in the toolbar and view menu.) The Sidebar and Bottombar are not available on the Dashboard.

You can change the Gramplets on the Dashboard by using the context menu (right-clicking) on an empty area of the Dashboard View. This will show a pop-up menu to "{{man menu|Add a gramplet}}", populated with a list of the possible Gramplets you may add and use with this particular view. (Some Gramplets are only available in particular category views.) It is better to have a Family Tree open when changing out Gramplets. The added feedback of some tree data in the Gramplets will help make choices about configuring the layout.

*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Age_on_Date|Age on Date]]}} Gramplet - list the people alive and their ages on a particular date
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Age_Stats|Age Stats]]}} Gramplet - list age span statistics in a number of graphs
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Calendar|Calendar]]}} Gramplet - see people's events on a particular date, or in a month in the past
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#FAQ|FAQ]]}} - Frequently asked questions about Gramps.
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Given_Name_Cloud|Given Name Cloud]]}} Gramplet - most popular given names
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Quick_View|Quick View]]}} - run a Quick View on the current person
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Records|Records Gramplet]]}} - see world's records of your data
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Session_Log|Session Log]]}} Gramplet - keep track of what you have done, and what records you have visited
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#SoundEx|SoundEx Gramplet]]}} generates [[Gramps_5.2_Wiki_Manual_-_Gramplets#Soundex|SoundEx codes]] for the names of people in the database.
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Statistics|Statistics]]}} Gramplet - see stats on the database
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Surname_Cloud|Surname Cloud]]}} Gramplet - most popular surnames as a "text cloud"
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#To_Do|To Do]]}} Gramplet - a notepad to keep tabs on your research
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Top_Surnames|Top Surnames]]}} Gramplet - top 10 most popular surnames ''(default)''
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#Welcome|Welcome]]}} Gramplet - a Gramps welcome message ''(default)''
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Gramplets#What.27s_Next|What's Next]]}} Gramplet - what needs to be done next

In addition, there are a number of Third party Gramplets that you can easily install and use. These include:
*{{man label|[[Addon:HeadlineNewsGramplet|Headline News Gramplet]]}} - current, breaking news from Gramps
*{{man label|[[Addon:DataEntryGramplet|Data Entry Gramplet]]}} - edit active person's name, birth date and place, death date and place, and add people
*{{man label|[[Addon:Python_Shell_Gramplet|Python Gramplet]]}} - a Python shell
*{{man label|[[Addon:NoteGramplet|Note Gramplet]]}} - see and edit active person's primary Person Note

and many others. See [[Third-party Addons]] for more details.

For more detailed information on using the installed Gramplets, see [[Gramps 5.2 Wiki Manual - Gramplets|Gramplets]].

The {{man button|Add a gramplet}} drop-down menu is also available from the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Gramplet_Bar_Menu|Gramplet Bar Menu]] available on the Bottombar and Sidebar of other Category views.
{{-}}
=== Gramplet Layout ===
[[File:ConfigureTheActiveView-icon-on-toolbar-51.png|right|thumb|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man button|Configure the active view}} button]]

You can change the {{man label|Number of Columns:}} for the Dashboard on the Gramplet Layout tab or change the options for the other displayed Gramplets on the related tabs, click the [[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button. Alternatively, you can choose {{man menu|Configure...}} from the {{man menu|View}} menu.
{{-}}

== People Category ==

In the {{man label|People Category}} the {{man label|[[#People_List_View|People List view]]}} or {{man label|[[#Tree_View_-_Grouped_People|Grouped People]]}}(default) views display a list of all people in the family tree without their connections. From this view, you may add, edit, remove, or merge people. Each view (List or Grouped) display several columns of information about each person.

By default, the view displays the <code>Name</code>, <code>ID</code>, <code>Gender</code>, <code>Birth Date</code> and <code>Death Date</code> columns for each Person. Additional columns for <code>Birth Place</code>, <code>Death Place</code>, <code>Spouse</code>, <code>Number of Parents</code> (in the [[Gramps_5.2_Wiki_Manual_-_Categories#Reorder_Relationships_dialog|topmost or Primary family]]), <code>Number of Marriages</code>, <code>Number of Children</code>, <code>Number of To Do Notes</code>, <code>Private</code>, <code>Tags</code> and <code>Last Changed</code> may be displayed. The People view also defaults to showing the [[#People_Category_Sidebar|Sidebar]] tabs and [[#People_Category_Bottombar_tabs|Bottombar]]

The {{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Column_Editor|Column Editor]]}} dialog can be used to show, hide and change the order of the displayed columns. This editor can be accessed by selecting {{man menu|View ➡ Configure...}} from the menu or by clicking the [[File:Gramps-config.png|34px]]{{man button|Configure View...}} button on the toolbar.

See also
* [[Gramps_5.2_Wiki_Manual_-_Navigation#Using_the_People_Category|Using the People Category]]
* [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_people|Editing information about people]]

{{man note|For Information displayed in the columns|Some of the column selection types require that the event being shown has the ''Role'' type of ''Primary'' eg Birth and Death Dates. This is set via the [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Event_Reference_Editor_dialog|Event Reference Editor dialog]]'s ''General'' tab.}}
{{man note|Column counts for <code>Number of xxxxxx</code>|For <code>Number of Marriages</code> only relationships of type ''Married'' are counted. For <code>Number of Children</code> only children with a ''Birth'' relationship are counted. However, for <code>Number of Parents</code> any parent in the [[Gramps_5.2_Wiki_Manual_-_Categories#Reorder_Relationships_dialog|Primary relationship]] (even those with a relationship of 'None') will be included in the parent count.}}
{{-}}
===Tree View - Grouped People===

[[File:People-tree-view-grouped-people-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People Category - Tree View - Grouped People]]

People are grouped according to their family names. To the left of each family name is typically either an arrow {{man button|▶}} or some other type of indicator (eg: ''+''). Clicking it once will reveal the entire list of people sharing that name. Clicking the indicator again will "roll up" the list and show only the family name.

Additional options are available by selecting a person from the list and using the context/pop-up menu shown by right-clicking:
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Home}}
*{{man menu|Set Home Person}}
*{{man menu|Expand all Nodes}}
*{{man menu|Collapse all Nodes}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View}}
**{{man menu|All Events}}
**{{man menu|Father Lineage}}
**{{man menu|Mother Lineage}}
**{{man menu|Person References}}
**{{man menu|Relation to Home Person}}
**{{man menu|Same Given Names}}
**{{man menu|Same Surnames}}
**{{man menu|Siblings}}

{{man note|Configure the view limitation|For the Group view the first column ({{man label|Name}}) cannot be changed as the view is based on showing grouped surnames.}}
{{-}}

===People List View===
===Tree View - People List View===

[[File:People-tree-view-people-list-view-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People Category - People List View]]

List of all the people in the database, sorted by first column which by default is the {{man label|Name ▴}} column.

Additional options are available by selecting a person from the list and using the context/pop-up menu shown by right-clicking:
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Home}}
*{{man menu|Set Home Person}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View}}
**{{man menu|All Events}}
**{{man menu|Father Lineage}}
**{{man menu|Mother Lineage}}
**{{man menu|Person References}}
**{{man menu|Relation to Home Person}}
**{{man menu|Same Given Names}}
**{{man menu|Same Surnames}}
**{{man menu|Siblings}}
{{-}}

===People Category Bottombar tabs===
Both Tree Views (Grouped People/People List View) have the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs. The configuration is independent between modes.
{{-}}
====Details====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Details|Details]] Gramplet
{{-}}
====Gallery====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Events====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Events|Events]] Gramplet
{{-}}
====Children====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Children|Children]] Gramplet
{{-}}
====Citations====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====Attributes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Attributes|Attributes]] Gramplet
{{-}}
====References====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===People Category Sidebar tabs===

Both Tree Views (Grouped People/People List View) have the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tab by default. The configuration is independent between modes.
{{-}}
====Filter====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Relationships Category ==

[[File:Relationships-category-view-default-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category view]]

The Relationships Category shows the default {{man label|Relationships Category view}} which displays all the relationships of the Active Person (the selected person). Specifically, it shows the parents, siblings, spouses, and children of that person.

The Relationships Category is designed to allow for quick navigation. You can quickly change the Active Person simply by clicking the name of any person listed on the page. Each name is actually a [http://en.wikipedia.org/wiki/Hyperlink hypertext link], similar to a web page.

The name of the Active Person is in '''bold''' style. Other names are shown either with or without '''''bold and italic''''' emphasis depending on whether certain relationships exist for the named person. For a person listed as a parent or spouse of the Active Person, the name is emphasized if that person has a parent family. For a person listed as a sibling or child of the Active Person, the name is emphasized if that person has children.

Dates are normally in regular style, and in ''italic'' style if the displayed event is a fallback event, i.e., a substitute event for another missing event. That may be christening event for birth event, burial event for death event, etc.
{{-}}
===Relationships Category view===

For the Relationships Category views via the menu or toolbar you may select:
* {{man menu|Edit>Edit...}} or the {{man button|Edit the active person}} icon - opens the {{man label|Person Edit dialog}}
* {{man menu|Edit>Add New Parents...}} or the {{man button|Add a new set of parents}} icon - to create a new family with the Active Person listed as a child.
* {{man menu|Edit>Add Existing Parents...}} or the {{man button|Add person as child to and existing family}} icon - which opens the [[Gramps_5.2_Wiki_Manual_-_Categories#Select_Family_selector|Select Family selector]] allowing you to choose from a list of existing families, and then add the person as a child to that family.
* {{man menu|Edit>Add Partner...}} or the {{man button|Add a new family with person as parent}} icon -
* {{man menu|Edit>Reorder...}} or the {{man button|Change order of parents families}} icon - to open the [[Gramps_5.2_Wiki_Manual_-_Categories#Reorder_Relationships_dialog|Reorder Relationships dialog]]

The following sections are available:
{{-}}
====Active Person====

* At the top of the screen, name, {{man label|ID}}, {{man label|Birth}}, and {{man label|Death}} information, as well as the calculated age of the Active Person is displayed. You may highlight and copy the {{man label|Birth}} and {{man label|Death}} text fields.

* On the right hand side a photo of the person if available, will be shown. This photo shows the first image available in the {{man label|[[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Gallery]]}} tab of this person (if any exist). You can click on the photo to open it in the default picture viewer.

* Next to the person's name is a symbol indicating gender, and an {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button. Clicking the {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button will allow you to edit all of the person's individual information in the {{man label|[[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog.

* See also: [[Gramps_5.2_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Setting the Active Person]]

====Parents====

The Parents section, displays the families in which the person is a child. Since it is possible for a person to have multiple sets of parents, it is possible to have several Parents sections.

You may edit an existing parents by selecting the {{man button|[[File:Gramps-notes.png|13px]]Edit}} button next to the parents. If you select the {{man button|-}} button next to a set of parents, then the Active Person will be removed as a child from the parents. This button does not delete the parents' relationship.

See the {{man label|[[Gramps_5.2_Wiki_Manual_-_Categories#Configuration|Configure Relationships]]}} section to configure what details to show or hide etc...

{{man warn|Warning|If you are not careful, it is possible to create multiple families with the same parents. This is rarely what the user wants to do. If you attempt to add a new family that has the same parents as an existing family, Gramps will issue a {{man label|[[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference#Duplicate_Family_warning_dialog|Duplicate Family]]}} warning dialog. If you get this dialog, you should probably Cancel the edit, and then use the {{man button|Select}} button to select the existing family.}}

=====Select Family selector=====
[[File:SelectFamily-SelectorDialog-example-50.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Family - selector dialog example]]

The {{man label|Select Family}} selector dialog allows you to link to an already existing Family.

The following columns are shown: ID (default sort for list), Father, Mother, Last Change.

You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
* '''ID contains''' (default)
* ''ID does not contain''
* ''Father contains''
* ''Father does not contain''
* ''Mother contains''
* ''Mother does not contain''
* ''Last Change contains''
* ''Last Change does not contain''

Use the {{man button|Clear}} button to clear the search field.

Note on some reports the list is restricted until you select the {{man label|[] Show all}} check box.
{{-}}

=====Siblings=====

The Sibling section shows brothers and sisters of the Active Person plus the Active Person themself.
{{-}}

====Family====

Similar to the Parents section is the Family section, which displays families where the Active Person is a parent. Because it is possible for a Person to have been a partner in multiple families, Gramps allows multiple Family sections to describe that. Each family section displays the spouse and any children. Children who were biological offspring of both partners in one Family might be a stepchild or adopted child for one partner of a subsequently formed family.

{{man note | Spouse |We use the term spouse for sake of simplicity. However, please note that spouse may in fact be a domestic partner, a partner in a civil union, or various other similar relationships between two people. Spouse relationships are ''not'' required to be only between a male and female.}}

You may add a family by selecting the {{man button|Add Spouse}} button in the toolbar. This will create a new family with the Active Person listed as a father or mother.

Selecting the {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button next to the spouse will allow you to edit the displayed family. Clicking the {{man button|-}} button will remove the person from the displayed family.

{{-}}

{{man warn| Removing a person from a family |Removing a person from a family does not delete the family. The person is removed as the father or mother, and any other relationships in the family continue to exist.}}

{{man note | Note |We use the terms father and mother for the sake of simplicity. Even if there are no children in a family, the father and mother terminology is still used. In the case of male/male or female/female relationships, the father and mother labels should be considered to be convenience labels.}}

{{-}}
======Reorder Relationships dialog======
Select the [[file:Stock_reorder.png]]{{man button|Change order of parents families}} button to display the {{man label|[[Gramps_5.2_Wiki_Manual_-_Categories#Reorder_Relationships_dialog|Reorder Relationships]]}} dialog that will allow you to reorder the families. The topmost family is considered the '''Primary family''' and is the family used for charts, graphs and summaries.

{{man note|This option will only be enabled|if more than one set of parents or more than one set of spouses exists for the Active Person.}}

[[File:ReorderRelationships-dialog-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Reorder Relationships - dialog - example]]

When more than one set of parents or more than one set of spouses exists for the Active Person.

Select one of the following:
* the menu {{man menu|Edit > Reorder}}
* or the {{man button|Change order of parents and families}} toolbar icon button
* or the {{man button|Reorder Parents}} icon near the {{man label|Parents:}} label
* or the {{man button|Reorder Families}} icon near the {{man label|Family:}} label
to display the {{man label|Reorder Relationships}} dialog that will allow you to reorder:
* the parents order in the top section {{man label|Parent relationships}} using the up/down arrow buttons.
* or families order in the bottom section {{man label|Family relationships}} using the up/down arrow buttons.
{{-}}

=====Children=====

The Active persons children.
{{-}}

====Configuration====

[[File:ConfigureRelationshipsView-content-tab-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Relationships Category - Content (tab)]]

You can control how much information is displayed.

Use the {{man menu|View ➡ Configure...}} menu or click the [[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]].

The following options are available:
*On the {{man label|Content}} tab
** {{checkbox|1}} {{man label|Show Details}} (checkbox checked by default) show or hide the birth and death information (All except the Active person)
** {{checkbox|1}} {{man label|Show Siblings}} (checkbox checked by default) show or hide siblings.
{{-}}
[[File:ConfigureRelationshipsView-layout-tab-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Relationships Category - Layout (tab)]]

*On the {{man label|Layout}} tab
** {{checkbox|1}} {{man label|Use shading}} (checkbox checked by default)
** {{checkbox|1}} {{man label|Display edit buttons}} (checkbox checked by default) - show or hide the {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button shown next to each person.
** {{checkbox|0}} {{man label|View links as website links}} (checkbox unchecked by default)
{{-}}

===Relationships Category Bottombar tabs===
The {{man label|Relationships Category view}} by default displays no Gramplets in the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tab. You may add them as required.
{{-}}
===Relationships Category Sidebar tabs===
The {{man label|Relationships Category view}} by default displays no Gramplets in the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tab. You may add them as required.
{{-}}

== Families Category ==

{{man warn| {{man button|Remove}} button |Unlike the Relationships Category, clicking the {{man button|Remove}} button in this view will remove the family from the database. All people will remain, but all relationships between the people in the family will be removed.}}

[[File:Families-category-list-view-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Families Category - (List) View]]

In the {{man label|Families Category}} the {{man label|Families List view}} displays a list of all families in the database(see Fig. {{#var:chapter}}.{{#var:figure}}).

From this view, you may use buttons on the toolbar to:
* {{icon|stock_add}} {{man button|[[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Add a new Family]]}}
* {{icon|stock_edit}} {{man button|[[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Family_Editor_dialog|Edit the selected family]]}}
* {{icon|stock_remove}} {{man button|Delete the selected family}}
* [[File:Gramps_Merge48x48_win.png|16px]] {{man button|[[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3#Merge_Families|Merge the selected (2) families]]}} from the list
* [[File:16x16-gramps-tag.png]] {{man button|Tag the selected rows}}

The default display lists the <code>ID, Father, Mother, Relationship and Marriage Date</code>. If you configure the active view you can, hide existing columns, show additional columns like <code>Private, Tags, Last Changed</code>, or rearrange the column order.

Additional options are available by selecting a family from the list and using the context/pop-up menu shown by right-clicking:
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Make Mother Active Person}}
*{{man menu|Make Father Active Person}}
*{{man menu|Quick View}}
**{{man menu|All Family Events}}
**{{man menu|Family References}}

See also
* [[Gramps_5.2_Wiki_Manual_-_Navigation#Using_the_Families_Category|Using the Families Category]]
* [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Editing_information_about_relationships|Editing information about relationships]]

{{man note|Children cannot be displayed on the screen in this list view.|The children can be viewed in the associated ''Children'' tab in the bottombar or sidebar and [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Children|Family Editor's ''Children'']] tab.}}
{{-}}
===Families Category Bottombar tabs===
The {{man label|Families Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs as default.
{{-}}
====Gallery====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Events====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Events|Events]] Gramplet
{{-}}
====Children====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Children|Children]] Gramplet
{{-}}
====Citations====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====Attributes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Attributes|Attributes]] Gramplet
{{-}}
====References====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}

===Families Category Sidebar tabs===

The {{man label|Families Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs as default.
{{-}}
====Filter====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Charts Category ==
The Charts Category shows several graphical representations of the ancestry or descendants of the active person.

By default Gramps shows the {{man button|[[Gramps_5.2_Wiki_Manual_-_Categories#Pedigree_View|Pedigree]]}} View. With the {{man button|[[Gramps_5.2_Wiki_Manual_-_Categories#Fan_Chart_View|Fan Chart]]}} View and {{man button|[[Gramps_5.2_Wiki_Manual_-_Categories#Descendant_Fan_View|Descendant Fan]]}} chart View and {{man button|[[Gramps_5.2_Wiki_Manual_-_Categories#2-Way_Fan_View|2-Way Fan]]}} chart view being selectable from the toolbar or menu via {{man menu|View > '''Name of Chart View'''}}

{{man tip|Want more Chart Views?|Installation of additional downloadable addons contain extra views. See [[Third-party Addons]]}}

=== Pedigree View===

[[File:ChartsCategory-pedigreeview1-horizontal-right-standard-5gen-default-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 1 (Default) Tree direction: Horizontal (→) (horizontal to right)]]

The {{man label|Pedigree}} View shows up to nine generations in the form of a chart, depending on the size of the window you may need to use the scroll bars to see parts of the chart.

Each person is indicated by a box labeled with his or her name, birth information (indicated by an asterisk * sign), death information (indicated by a plus + sign), a black stripe across the top left corner of the box is shown if the person is deceased (or determined by Gramps to be no longer alive) and optionally the primary image will be displayed if available.

Two lines branch from each person box. The top line leads to the person's father and the bottom line leads to the mother. Solid lines represent the biological birth type relationship, while dashed lines represent non-birth relationships such as adoption, step-parenthood, guardianship, etc.

The left arrow {{man button|Jump to child...}} button beside the Active Person is a only selectable if the Active Person has children, clicking this button expands to show a list of the Active Person's children. Selecting one of the children makes that child the Active Person for the chart.

The appearance of the children's names in the menu differentiates the dead ends of the tree from the continuing branches.

Children who have children themselves appear in the menu in the boldface and italic type, while children without children (dead ends) appear in a regular font. If the Active Person has only one child, no menu will be displayed (since there is only one choice) and the child will become the Active Person when the arrow button is clicked.

The right-hand side of the window shows two right arrow buttons. When the top button {{man button|Jump to father}} is clicked, the Father of the Active Person becomes the Active Person. When the bottom button {{man button|Jump to mother}} is clicked, the Mother of the Active Person becomes the Active Person.

{{-}}
[[File:ChartsCategory-PedigreeView-PersonContextMenu-showing-Children-example-50.png|right|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Person context menu showing Children]]

Right-clicking on any person's box in the Pedigree View will bring up the Person "context menu".

Among other useful items, the context menu has sub-menus listing {{man label|Spouses}} , {{man label|Siblings}} , {{man label|Children}} , {{man label|Parents}} and {{man label|Related}} of that person.

"Greyed-out" sub-menus indicate the absence of the data in the appropriate category. Similar to the children menu above, Childrens' and Parents' menus distinguish continuing lines from dead ends.

{{-}}

====⚙ Configuration Options====

[[File:ChartsCategory-PedigreeView-ConfigureCharts-dialog-default-50.png|right|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Pedigree View - Configure the active view - dialog - showing Defaults on Layout tab]]Use the {{man menu|View ➡ Configure...}} menu or click the [[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]].

The {{man label|Layout}} tab has the following option available:
* {{checkbox|1}} {{man label|Show images}} (checked by default)
* {{checkbox|1}} {{man label|Show marriage data}} (checked by default)
* {{checkbox|1}} {{man label|Show unknown people}} (checked by default)
* {{checkbox|0}} {{man label|Show tags}} (unchecked by default)
* {{man label|Tree style:}}
** '''Standard'''(default)
** Compact
** Expanded
* {{man label|Tree direction:}}
** Vertical (↑) [[File:ChartsCategory-pedigreeview2-vertical-up-standard-5gen-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 3 - Tree direction: Vertical (↑) (vertical and up)]]
** Vertical (↓) [[File:ChartsCategory-pedigreeview2-vertical-down-standard-5gen-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 4 - Tree direction: Vertical (↓) (vertical and down)]]
** '''Horizontal (→)'''(default)
** Horizontal (←) [[File:ChartsCategory-pedigreeview2-horizontal-left-standard-5gen-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Pedigree view 2 - Tree direction: Horizontal (←) (horizontal to left)]]
* {{man label|Tree size:}} slider range 2 to 9 generations. Set to <code>5</code>(by default)

{{-}}

=== Fan Chart View ===

[[File:ChartsCategory-fanchartview-halfcircle-7gen-Royals-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Fan Chart View - half circle (Royals92.ged)]]

The {{man label|Fan Chart}} view shows the active persons ancestry as a pie chart. Clicking on a name in the chart will double the section of the pie allocated to that person by collapsing the spouse section. A second click brings the chart back to the original form. Right-click brings up a context menu like in the pedigree view, allowing to navigate to other people.

This view enables to see large ancestries in a more compact manner, and to see very quickly which parts of an ancestry need further research.

You can rotate the view by click and drag outside the fan chart. You can move the view by click and drag inside the inner (white) region.

#The view can be a circle, a halfcircle or a quadrant of a circle. The latter are always attached to the bottom or side of the view
#Children of the center person are shown within the ring at the center
#Drag and drop people to the center to change the active person
#Color options
## Colors of the boxes based on the age of the people
## Colors of the boxes depending on the time period the person lived in
## White, classic, gender based, and user defined colors
# Filtering: use the person filter in the sidebar to quickly obtain insight in the people shown. For example: which people have birth events, who has the attribute ''blue eyes'', ... . Filtered results have bold font, the ones that don’t satisfy the filter are shown transparent
#Show up to 11 generations in the view.
#Print the view from the toolbar. The view as you see it (after rotating, expanding, changing color) can via the {{man button|Print...}} button. The view can be printed or use the Print to File option to save in any of the following formats: SVG (which can be edit further in tools like Inkscape or viewed in browsers like Firefox), PostScript (.ps) or PDF.
#The font used can be selected and automatically adjust to fit within the boxes. On a darker background, the font is white, and vice versa.
{{-}}

====⚙ Configuration Options====

[[File:ChartsCategory-FanChartView-ConfigureCharts-dialog-default-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Fan Chart View - Configure the active view - dialog - showing Defaults Defaults on Layout tab]]Use the {{man menu|View ➡ Configure...}} menu or click the [[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]].

* {{man label|Max generations:}} ''9'' (default)
* {{man label|Text Font:}} ''Sans'' (default)
* {{man label|Background:}}
** Gender colours
** '''Generation based gradient''' (default)
** Age (0-100) based gradient
** Single main (filter) color
** Time period based gradient
** White
** Color scheme classic report
** Color scheme classic view
* {{man label|Start gradient/Main colour:}} ''#ef2929'' (default)
* {{man label|End gradient/2nd colour:}} ''#3d37e9'' (default)
* {{man label|Fan chart type:}}
** '''Full Circle''' (default)
** Half Circle
** Quadrant
* {{checkbox|1}} {{man label|Show names on two lines}}
* {{checkbox|1}} {{man label|Flip name on the left of the fan}}
* {{checkbox|1}} {{man label|Show children ring}}
* {{checkbox|0}} {{man label|Show gramps id}}

====See also====
{{fan_charts}}
{{-}}

=== Descendant Fan View ===
[[File:ChartsCategory-descendantfan-fullcircle-9gen-default-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Descendant Fan Chart View - full circle]]
The '''Descendant Fan''' view interactively displays the active person's descendants in a pie chart format. The Descendant Fan provides a comprehensive and visually appealing way to explore and analyze an individual's descendants within your family tree.

Clicking on a name in the chart collapses the sibling sections of the pie chart, while a second click reverts the chart to its original form. Right-clicking brings up a context menu similar to the pedigree view, allowing navigation to other individuals. The center Active Person's parents are shown within the innermost ring

This view enables users to visualize large descendant trees more compactly and quickly identify areas that require further research.

Key Features:
* Tooltips appear (with the person's Name, birth and death infomation) after a slight delay when indicating a Fan segment
* Drag and drop individuals to the center to change the active person (or [[Gramps_5.2_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Navigate the Active Person]] using the standard methods)
* Clicking on a descendant name in the chart collapses (or expands) the sibling sections
* Rotate the view by clicking and dragging outside the fan chart or inside the inner (white) region
* Drag the center black dot to move the center focus in the main view area
* Move the center focus horizontally by dragging the bottom scrollbar.
* Move the center focus vertically by dragging the righthand scrollbar or scrolling the mouse wheel.
* Surnames appear in bold font
* Display up to 16 generations
* Adjustable font selection with automatic sizing to fit within boxes


The Filter gramplet, configuration options and Dark Variants (of the Themes addon for Preferences) can be used to adjust the way data is rendered.

Use the person filter in the sidebar for quick insights (e.g., individuals with birth events, specific attributes). Filtered results are in full saturation color while the non-matching entry colors are semi-transparent.

==== Printing ====

Print the view from the toolbar, including any rotations, expansions, or color changes. Use the Print to File option to save in various formats:
* SVG (editable in tools like Inkscape or viewable in browsers)
* PostScript (.ps)
* PDF
{{-}}

====⚙ Configuration Options====

[[File:ChartsCategory-DescendantFanChartView-ConfigureCharts-dialog-default-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - Descendant Fan Chart View - Configure the active view - dialog - showing Defaults on Layout tab]]Use the {{man menu|View ➡ Configure...}} menu or click the [[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]].

* {{man label|Max generations:}} ''9'' (default)
* {{man label|Text Font:}} ''Sans'' (default)
* {{man label|Background:}}
** Gender colours
** '''Generation based gradient''' (default)
** Age (0-100) based gradient
** Single main (filter) colour
** Time period based gradient
** White
** Colour scheme classic report
** Colour scheme classic view
* {{man label|Start gradient/Main colour:}} ''#ef2929'' (default)
* {{man label|End gradient/2nd colour:}} ''#3d37e9'' (default)
* {{man label|Fan chart type:}}
** '''Full Circle''' (default)
** Half Circle
** Quadrant
* {{man label|Fan chart distributions:}}
** Homogeneous children distribution
** '''Size proportional to number of descendants''' (default)
* {{checkbox|1}} {{man label|Show names on two lines}}
* {{checkbox|1}} {{man label|Flip name on the left of the fan}}
* {{checkbox|0}} {{man label|Show gramps id}}

====See also====
* [https://gramps-project.org/blog/2012/09/descendant-fanchart/ Descendant Fan View] (blog announcement)
* {{fan_charts}}

{{-}}

=== 2-Way Fan View ===

[[File:ChartsCategory-2wayfan-fullcircle-ances4gen-descen4gen-default-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 2-Way Fan Chart View - 4 Generations of Ancestors (Top) / 4 Generations of Descendants (bottom)]]

Chart consisting of both ascendants and descendants.
The '''2-Way Fan View''' view interactively displays the active person's ancestors and descendants in a pie chart format. The Descendant Fan provides a comprehensive and visually appealing way to explore and analyze an individual's descendants within your family tree.

Clicking on a ancestor name in the chart collapses their spouse section of the pie, while a second click reverts the chart to its original form. Clicking on a descendant name in the chart collapses that person's sibling sections, while a second click reverts the chart to its original form. Right-clicking brings up a context menu similar to the pedigree view, allowing navigation to other individuals. The center Active Person's parents are shown within the innermost ring

This view enables users to visualize large descendant trees more compactly and quickly identify areas that require further research.

Key Features:
* Tooltips appear (with the person's Name, birth and death infomation) after a slight delay when indicating a Fan segment
* Drag and drop individuals to the center to change the active person (or [[Gramps_5.2_Wiki_Manual_-_Navigation#Setting_the_Active_Person|Navigate the Active Person]] using the standard methods)
* Clicking on a descendant name in the chart collapses (or expands) the sibling sections
* Rotate the view by clicking and dragging outside the fan chart or inside the inner (white) region
* Drag the center black dot to move the center focus in the main view area
* Move the center focus horizontally by dragging the bottom scrollbar.
* Move the center focus vertically by dragging the righthand scrollbar or scrolling the mouse wheel.
* Surnames appear in bold font
* Configurable to display up to 11 generations of ancestors
* Configurable to display up to 11 generations of descendants
* Adjustable font selection with automatic sizing to fit within boxes


The Filter gramplet, configuration options and Dark Variants (of the Themes addon for Preferences) can be used to adjust the way data is rendered.

Use the person filter in the sidebar for quick insights (e.g., individuals with birth events, specific attributes). Filtered results are in full saturation color while the non-matching entry colors are semi-transparent.

==== Printing ====

Print the view from the toolbar, including any rotations, expansions, or color changes. Use the Print to File option to save in various formats:
* SVG (editable in tools like Inkscape or viewable in browsers)
* PostScript (.ps)
* PDF
{{-}}
{{-}}

====⚙ Configuration Options====

[[File:ChartsCategory-2-WayFanChartView-ConfigureCharts-dialog-default-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Charts Category - 2-Way Fan Chart View - Configure the active view - dialog - showing Defaults on Layout tab]]Use the {{man menu|View ➡ Configure...}} menu or click the [[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button in the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Toolbar|Toolbar]].

* {{man label|Max ancestor generations:}} ''4'' (default)
* {{man label|Max descendant generations:}} ''4'' (default)
* {{man label|Text Font:}} ''Sans'' (default)
* {{man label|Background:}}
** Gender colours
** '''Generation based gradient''' (default)
** Age (0-100) based gradient
** Single main (filter) colour
** Time period based gradient
** White
** Colour scheme classic report
** Colour scheme classic view
* {{checkbox|1}} {{man label|Add global background coloured gradient}}
* {{man label|Start gradient/Main colour:}} ''#ef2929'' (default)
* {{man label|End gradient/2nd colour:}} ''#3d37e9'' (default)
* {{man label|Colour for duplicates:}} ''#888a85'' (default)
* {{man label|Fan chart distribution:}}
** Homogeneous children distribution
** '''Size proportional to number of descendants''' (default)
* {{checkbox|1}} {{man label|Show names on two lines}}
* {{checkbox|1}} {{man label|Flip name on the left of the fan}}
* {{checkbox|0}} {{man label|Show gramps id}}

====See also====
* [https://github.com/gramps-project/gramps/pull/222 Feature: Gep-030 FanChart2Way]
{{fan_charts}}
{{-}}

===Charts Category Bottombar tabs===

The {{man label|Charts Category}} by default displays no Gramplets in the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tab. You may add them as required.
{{-}}
===Charts Category Sidebar tabs===

The {{man label|Charts Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
Only the {{man label|Fan Chart View}} and {{man label|Descendant Fan View}} have a Filter shown by default.

See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Events Category ==
The {{man label|Events Category}} shows the {{man label|Events View}} that lists the all the events recorded in the Family Tree. Events can be shared between multiple people and multiple families.

See also:
* [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_events|Editing information about events]]
{{-}}
===Events View===
[[File:EventsCategory-EventsListView-example-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Events Category - Events (List) View - example]]

From the {{man label|Events View}} list the following columns are available for display: {{man label|Description}} , {{man label|ID}} , {{man label|Type}} , {{man label|Main Participants}} , {{man label|Date}} , {{man label|Place}} and {{man label|Last Changed}}.

The default view displays the {{man label|Description}} , {{man label|ID}} , {{man label|Type}} , {{man label|Date}} and {{man label|Place}} of the event. The {{man label|Column Editor}} dialog can be used to add, remove and rearrange the displayed columns. This can be accessed from the {{man button|Configure View...}} button on the toolbar.

The list of Events can be sorted in the usual manner, by clicking on the column heading. Clicking once sorts in ascending order, clicking again sorts in descending order.

Additional options are available by selecting an event from the list and using the context/pop-up menu shown by right-clicking:
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View}}
**{{man menu|Event References}}
**{{man menu|On This Day}}

{{man warn|Use meaningful event descriptions|Because events can be shared, you should take the extra time to give each event a unique and meaningful description. This will help you find the correct event when you share events.}}
====⚙ Configuration Options====
As with most list style Views, you can control the layout (which columns will be displayed and their order of display) by clicking the [[File:Gramps-config.png|34px]]{{man button|Configure...}} button, choosing {{Man menu|View ➡ Configure...}} from the View menu, or pressing the ''Configure active view'' [[Gramps_5.2_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

The displayable columns include:
* {{checkbox|1}} {{man label|Type }}
* {{checkbox|1}} {{man label|Main Participants}}
* {{checkbox|1}} {{man label|Date}}
* {{checkbox|1}} {{man label|Place}}
* {{checkbox|1}} {{man label|Description}}
* {{checkbox|1}} {{man label|ID}}
* {{checkbox|0}} {{man label|Private}}
* {{checkbox|0}} {{man label|Tags}}
* {{checkbox|0}} {{man label|Last Changed}}

Drag and drop columns to change their order in the Event list. The view will not be changed unless the {{man button|Apply}} button is clicked. Clicking {{man button|Close}} without first clicking {{man button|Apply}} will abandon the changes.

{{-}}

===Events Category Bottombar tabs===

The {{man label|Events Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Gallery====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Citations====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====Attributes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Attributes|Attributes]] Gramplet
{{-}}
====References====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Events Category Sidebar tabs===

The {{man label|Events Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Places Category ==

The {{man label|Places Category}} holds two views that show [[Gramps_Glossary#place|places]]: either as grouped (hierarchically in a tree) or ungrouped (in a simple flat list). Each view lists the geographical places in which the events of the database took place. These could be places of birth, death, and marriages of people, as well as their home, employment, education addresses, or any other conceivable reference to the geographical location.

[[File:Toolbar-Place-Options_51.png|center|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - Toolbar Place Options]]
The Places View lists the places' {{man label|Name}} , {{man label|Title}} , {{man label|ID}} , {{man label|Type}} , {{man label|Code}} , {{man label|Latitude}} , {{man label|Longitude}} , {{man label|Private}} , {{man label|Tags}} , and {{man label|Last Changed}}. All of these columns can be used for sorting by clicking on a column heading.
{{man tip|When giving a maps coordinates, latitude always precedes longitude|Latitude (north or south) parallels and longitude (east or west) meridians are divided in degrees (°), minutes (’) and seconds (”). There are 60 minutes to a degree and 60 seconds to a minute.
 
See: [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]] See: [[Gramps_5.2_Wiki_Manual_-_Settings#Display_Options|Coordinates format:]] in preferences Display as this option controls the display of Coordinates.
}}

===Places Tree View===
[[File:PlacesCategory-PlaceTreeView-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Tree View - example]]

The Place Tree View groups the places in a hierarchy: country, county, ... etc

You can expand the listing using the {{man button|▶}} arrows.

All the nodes of the tree view mode can be simultaneously collapsed or expanded from the context/pop-up menu shown by selecting a place and right-clicking:
*{{man menu|Expand this Entire Group}}
*{{man menu|Collapse this Entire Group}}
*{{man menu|Expand all Nodes}}
*{{man menu|Collapse all Nodes}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View ▶ Place References}}
*{{man menu|Look up with Map Service}}
{{-}}
====⚙ Configuration Options====
[[File:Menubar-View-overview-example-52.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} View menu for the Places category - Places Tree View]]
You can control the layout (which columns will be displayed and their order of display) by clicking the [[File:Gramps-config.png|34px]]{{man button|Configure...}} button, choosing {{Man menu|View ➡ Configure...}} from the View menu, or pressing the ''Configure active view'' [[Gramps_5.2_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].
{{-}}
[[File:ConfigurePlaceView-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Places Category View - Places Tree View ]]The {{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Column_Editor|Column Editor]]}} dialog may be used to add, remove and rearrange the displayed columns. Changes will only be enacted when the {{man button|Apply}} button is clicked.

Once the View columns are shown, clicking once on the column header sorts in ascending order, clicking again sorts in descending order.

These Configuration options and the current [[Gramps_5.2_Wiki_Manual_-_Filters|filters]] also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_5.2_Wiki_Manual_-_Settings#Export_View|Export View...]]}}
{{-}}

===Places List View===
[[File:PlacesCategory-PlaceListView-example-52.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - Place (List) View - example]]

The Place List View shows all the places in one long list.

Additional options are available by selecting a place from the list and using the context/pop-up menu shown by right-clicking:
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View ▶ Place References}}
*{{man menu|Look up with Map Service}}
{{-}}

===Places Category Bottombar tabs===

The {{man label|Places Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Details====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Details|Details]] Gramplet
{{-}}
====Location====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Locations|Locations]] Gramplet
{{-}}

====Gallery====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Events====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Events|Events]] Gramplet
{{-}}
====Citations====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====References====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Places Category Sidebar tabs===

The {{man label|Places Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

===Map Service===
{{man warn|The Map Service feature requires a set of coordinates (Longitude and Latitude) for each of the Places|If the enclosed Place record does not yet have coordinates information, then Gramps will not request a map service marker for the Place associated with that person or event.
 
See: [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Supported_longitude.2Flatitude_formats|Supported longitude/latitude formats]] See: [[Gramps_5.2_Wiki_Manual_-_Settings#Display_Options|Coordinates format:]] in preferences Display as this option controls the display of Coordinates.
}}

[[File:PlacesCategory-AttemptToSeeSelectedLocation-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - "Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ..." button - example]]

If a place has been highlighted, you may display the place in a web browser by selecting the {{man button|Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, ...}} button or using the right-click context menu to {{man menu|Look up with Map Service}}.

Your default web browser should open, attempting to use either the recorded coordinates (longitude and latitude) or the place name to display the location using the Maps provider web site. Different map services might have different requirements for the location description.

{{-}}
[[File:PlacesCategory-MapServices-list-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Category - "Select a Map Service" button - showing list of options]]

From the {{man button|Select a Map Service}} drop down list you can choose the map service you want to use from the following three options:
* '''{{man label|OpenStreetMap}}'''(default) - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.
* ''{{man label|EniroMaps}}'' - Valid for places within Sweden and Denmark, only if longitude and latitude are available, otherwise uses city and country, or uses description of the place.
* ''{{man label|GoogleMaps}}'' - Uses longitude and latitude coordinates if present, otherwise uses city and country, or uses description of the place.

{{-}}
See also:
* [[Addon:MapService-GoogleEarth|Map Services - Google Earth]] - addon allows you to use Google Earth.

== Geography Category ==

{{man tip|Note|The Geography category is only present if the prerequisite program <code>[[Gramps_5.2_Wiki_Manual_-_Categories#Prerequisites_to_see_the_geography_view|OsmGpsMap]]</code> is present that Gramps can use.}}

[[File:GeographyCategory-GeoPlacesView-AllKnownPlaces-openstreemap-example-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known Places" GeoPlaces View - Geography Category - example using Openstreetmap]]

The {{man label|Geography Category}} shows place event data visually on a map. It contains many Geographic Views, which allows you to see the people and their events placed on a map via an internet map provider (OpenStreetMap, Google maps ...).

The following core Geography Views are available:
* Show [[#All_known_places|all known places]] in your family tree
* Show [[#All_known_places_for_one_Person|all known places connected to the active person]]
* Show [[#All_known_places_for_one_Family|all places connected to the active family]]
* Show [[#All_places_related_to_Events|all places connected to a filtered selection of events]] with a {{man menu|[[#show_all _events|Show all event places]]}} option
* Show [[#Have_they_been_able_to_meet_.3F|if two people have been able to meet]]
* Show [[#Have_these_two_families_been_able_to_meet_.3F|if two families have been able to meet]]
* Show [[#Every_residence_or_move_for_a_person_and_any_descendants|all residences, displacements or moves for one person and their descendants]]
* additional [[5.2_Addons#Addon_List|third-party addon]] Geography views are available

These views are accessible via the buttons on the toolbar. To filter on places or events, activate the filter sidebar via the menu {{man menu|View->Filter Sidebar}}

=== Prerequisites ===
If the Geography icon is not visible in the Navigator sidebar, you probably need to install the [[Gramps_5.2_Wiki_Manual_-_Categories#Prerequisites_to_see_the_geography_view|requisite <code>OsmGpsMap</code> program]].

To have these Geographic views work correctly, you need:

* To have events related to places.
* These places must have coordinates : latitude and longitude.
* If one place has no coordinates, it will never appear on the map.
* If you have an active internet connection, for all moves on the map, all zoom ... all tile maps are saved.
** When you are without an internet connection, all tile maps are cached from the previous session and can be used.
** So, the map can be used without an internet connection and all already visited places can be shown again.
** The only thing to do is for each place or area you want to use without an internet connection is to select them, zoom into these places. You'll be able to use them again without connection.

{{man warn|BE CAREFUL|The {{man label|Geography Category}} views may use many [https://en.wikipedia.org/wiki/Gigabyte Gigabytes] of storage space on your computer. If you use several maps, you need to have this same gigabytes size multiply by the number of map used.}}

==== The different views ====
===== All known places =====

[[File:GeographyCategory-GeoPlacesView-AllKnownPlaces-openstreemap-example-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known Places" GeoPlaces View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view show all places with coordinates in the database.

For performances reason, by default, the view show only the place related to the places history or the filtered places.
If you really want to see all places, you need to select the popup menu from the context menu [[Gramps_5.2_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] and select "show all places".
{{-}}
[[File:GeographyCategory-AllKnownPlaces-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} {{man label|The places marker color}} tab for the "All known Places" GeoPlaces View - Configure the active view]]

;Configure the active view: {{man label|The places marker color}} tab
The configuration menu tab for has the following options:

The {{man label|All known Places}} view is the only Geography view that allows you to change the color used for the place type markers.

The colors are green for the following map renders:
* Openstreetmap
* Maps for free
* Opencyclemap and Public transport.

All other marker renders are red.

Click on the {{man button|Configure the active view}} button on the toolbar.

Then click on the {{man label|The places marker color}} tab. The default color for each Place Type is green "#008b00"
[[File:PickAColor-selector-dialog-52.png|center|thumb|300px]]

For each type of place, you can select and choose a color. Once the '''Pick a Color''' dialog appears, you can drag a color swatch from that dialog to the Configure's {{man label|The places marker color}} swatches. It is not necessary to click the {{man button|Close}} button for each Type then reopen the dialog.

See also:
* [[Gramps_5.2_Wiki_Manual_-_Categories#Can_we_change_the_marker.27s_color_.3F|Can we change the marker color?]]
{{-}}

===== All known places for one Family =====

[[File:GeographyCategory-AllKnownPlacesForOneFamily-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known places for one Family" GeoFamily View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view show all places visited by all family members during their lives.

This view is not connected to filters. It only depend on the active family and the history.
{{-}}
;Configure the active view: {{man label|Specific parameters}} tab
The configuration menu tab for this view has no additional options.
{{-}}

===== Have they been able to meet ? =====

[[File:GeographyCategory-HaveTheyBeenAbleToMeet-default-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Have they been able to meet ?" GeoClose View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view is used to show if two persons were able to meet during their life.

You must select one reference person :
#From the menu popup : Choose the reference person
#From the toolbar

When the reference person is active, you'll see its life way.
For each known place with coordinates, you'll see a circle or an oval depending on the longitude.

The circle radius can be tuned in the configuration view.
This value is defined in tenth of degree.

{{-}}
[[File:GeographyCategory-HaveTheyBeenAbleToMeet-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The selection parameters" tab for the "Have they been able to meet ?" GeoClose View - Configure the active view]]

;Configure the active view: {{man label|The selection parameters}} tab
See the configuration menu tab for additional options.
{{-}}

===== All places related to Events =====
[[File:GeographyCategory-AllPlacesRelatedToEvents-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All places related to Events" GeoEvents View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

For performances reason, the default view initially shows only the places related to the events history or the filtered events.

This view can also be used to show all places related to events. However, it can take some time to show when the tree records many events and many places.


If you really want to see all events, you need to select "show all events" from the [[Gramps_5.2_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] contextual popup menu.
{{-}}
;Configure the active view: {{man label|Specific parameters}} tab
The configuration menu tab for this view has no additional options.
{{-}}

===== All known places for one Person =====
[[File:GeographyCategory-AllKnownPlacesForOnePerson-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "All known places for one Person" GeoPerson View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view show all places visited by one person during that persons life.

This view is not connected to filters. It only depend on the active person and the history.

If you want to use the animate functionality, click on the [[Gramps_5.2_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse. You'll get a popup menu.
From the menu popup, you can select 'animate' to see the life way of the current person:

If the active person has several related events, you can see a virtual move between those markers. The move is related to years or distance and can be modified in the person map preferences. If the distance between to markers is greater than a value in tenth of degree, we show moves depending on distance instead of years. In these case, the number of steps between these two markers can be modified. You can modify the animation speed between steps. The moves start at the first event year until the last event year.
{{-}}
[[File:GeographyCategory-AllKnownPlacesForOnePerson-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The animation parameters" tab for the "All known places for one Person" GeoPerson View - Configure the active view]]

;Configure the active view: {{man label|The animation parameters}} tab
See the configuration menu tab for the following options you can change:
*A slider to set the {{man label|Animation speed in milliseconds(big value means slower:)}} (default: ''100'')
*A slider to set the {{man label|How many steps between two markers when we are on large move?:}} (default: ''20'')
*A slider to set the {{man label|The minimum latitude/longitude to select large move. The value is in tenth of degree.}} (default: ''5'')
{{-}}
====== All known places for one person with graphical information (KML files) ======

[[File:gramps-person-kml.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} One person with 3 KML files]]

If KML files are added as Media objects in the Gallery tab for the various records, this Geography view will show one path or one surface for each KML file.

In the following example, you see 3 layered KML files rendered from different Gallery tabs referenced by this Person:
* a farm limits outline KML in the Birth Event.
* a path KML used to go to school in the Education Event.
* a parish (or municipality) limits outline KLM in the Place Gallery tab for the Baptism Event.

In the case of the Farm limits outline, the KLM was added to the Gallery tab of the Birth Event (rather than being applied to that of the re-useable [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'Farm' type Place]]) because acreage was bought and sold over the years. This outline represented the Farm size at the date of birth.

See [[Gramps_5.2_Wiki_Manual_-_Categories#Adding_places_from_KML_files|Adding places from KML files]]

{{man tip|What is a KML file ?|See the article [https://en.wikipedia.org/wiki/Keyhole_Markup_Language Keyhole Markup Language] From Wikipedia, the free encyclopedia}}
{{-}}

===== Every residence or move for a person and any descendants =====

[[File:GeographyCategory-EveryResidenceOrMoveForAPersonAndAnyDescendants-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Every residence or move for a person and any descendants" GeoMoves View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view is used to show all the places in a person and their descendant's lifetime.

They are displayed by generation.
You can change the delay between the generation display in the view configuration.

This view is not connected to filters. It only depends on the [[Gramps_Glossary#active_person|Active Person]] and their history.
{{-}}
[[File:GeographyCategory-EveryResidenceOrMoveForAPersonAndAnyDescendants-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The parameters for moves" tab for the "Every residence or move for a person and any descendants" GeoMoves View - Configure the active view]]

;Configure the active view: {{man label|The parameters for moves}} tab
See the configuration menu tab for the following options you can change:
*A slider to set {{man label|The maximum number of generations.}} to show. (default: ''20'')
*A slider to set the {{man label|Time in milliseconds between drawing two generations.}} (default: ''500'')
{{-}}

===== Have these two families been able to meet ? =====

[[File:GeographyCategory-HaveTheseTwoFamiliesBeenAbleToMeet-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Have these two families been able to meet ?" GeoFamClose View - Geography Category - example using Openstreetmap - sidebar and bottombar hidden]]

This view is used to show if two families were able to meet during their life.

You must select one reference family :
* From the menu popup : Choose the reference family
* From the toolbar

When the reference family is active, you'll see all its member's life way.
For each known place with coordinates, you'll see a circle or an oval depending on the longitude.

The circle radius can be tuned in the configuration view.
This value is defined in tenth of degree.
{{-}}
[[File:GeographyCategory-HaveTheseTwoFamiliesBeenAbleToMeet-Configure-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "The selection parameters" tab for the "Have these two families been able to meet ?" GeoFamClose View - Configure the active view]]

;Configure the active view: {{man label|The selection parameters}} tab
See the configuration menu tab for additional options.
{{-}}

===Usage===
====⚙ Configuration Options====

[[File:Menubar-View-overview-example-50.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} View menu for the People category View]]
You can control the layout (which columns will be displayed and their order of display) by clicking the [[File:Gramps-config.png|34px]]{{man button|Configure the active view}} button, choosing {{Man menu|View ➡ Configure...}} from the View menu, or pressing the ''Configure active view'' [[Gramps_5.2_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].
=====All views=====
[[File:ConfigureGeography-the-map-tab-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Configure Geography - "The map" tab]]

{{man label|The map}} tab contains options common to all Geography views:
* {{man label|Where to save the tiles of the tiles for offline mode.:}} (the default is <code>~/.cache/gramps/maps</code> on POSIX systems and <code>C:\Users\''<username>''\appdata\local\gramps\maps</code> on Windows {{new|5.2.0}}). If required you can change the directory where map tile files are stored on your computer. {{man menu|Be careful, it can take several gigabytes, and if on a metered internet connection may result in a monetary cost to you.}}.
** {{man button|Select tile cache directory for offline mode}} button
* A slider for {{man label|Zoom used when centering:}} (default: ''12''). The zoom level for when we center the map or when we select one marker. Every time the Geographic View redraws the map, this zoomlevel will be used.
* A slider for {{man label|The maximum number of places to show:}} (default: ''5000''). Reducing this number for faster map drawing but with less life ways.
* {{checkbox|1}} {{man label|Use keypad for shortcuts: Either we choose the + and - from the keypad if we select this or we use the characters from the keyboard.}} - checkbox selected by default.

{{-}}

=====Specific views=====
See the description of the view.

====Print or save the Map====
For each of the Geography Category views via the menu or toolbar you may select:

* Menu {{man menu|Edit > Print...}} or toolbar button {{man button|Print or save the Map}} or keyboard shortcut {{Man key press|Shift|Ctrl|P}}

====How to zoom and move around the map ?====
=====Zoom in and Zoom out the map=====
To zoom, you can use :
* The +/- buttons on the top left of the map
* The scroll mouse.
* The "+" or "-" key on the keypad (default).

You can replace the numeric keypad by the alpha numeric keyboard in the configuration view.

=====Move around the map=====
To move around the map, you can :
* Click on the map, then drag it.
* Use the arrows.

====The mouse actions on the map====

The right button below is for one right handed person.
This will be the left button for one left handed person.

=====button 1 ( left button )=====
You have two usages for the button 1 :
# The marker selection.
# Valid the region selection

=====button 2 ( middle button )=====
[[File:Geography_MiddleButton.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Zoom rectangle drawn with middle button]]
The only usage for the center button is to draw a rectangular region on the map via click and drag.
# when pressed : start the region selection
# when released, end the region selection.
A left-click (button 1) will zoom-in the Geography view to fit the rectangle.
{{-}}

=====button 3 ( right button )=====
Only one usage for this button.
* show the [https://en.wikipedia.org/wiki/Context_menu context menu popup].

=====The mouse over a marker=====
When the mouse is placed over one marker, we display the place name in the status bar.

====The menu popup====
From this context menu, you have the following functions available for views :
*hide or show the crosshair
*lock or unlock the zoom
*change the default map (provider)
*add a place and link a place at the mouse position
*add a place from kml file
*center the map at the mouse position.
*center the map depending on a place from sub menu.
*remove all tiles already uploaded for the current provider
*"show all places" or "show all events" for the "all known places" view or "all places related to events" view.

====Click on a marker====
We have two cases :
# events : For each event, we can edit this event or center the map on this place.
# places : For each place, we can edit this place or center the map on this place.
When centering the map, the zoom used is defined in the geography preferences.

We may have several markers in the click area depending on the zoom.
In this case, We show for each marker all related events and/or places.
We obtain a mix between the two cases described above.

====Adding or Linking to a place====
For this, click on the [[Gramps_5.2_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a popup menu.
In this menu, you can select {{man label|Add place}} or {{man label|Link place}}

When you add a place or try to link a place to the position of the mouse, you'll get a place selection in a region.
You'll see on the map a circle in which you may choose markers place names. You can adjust the circle size with the cursor. Depending on the diameter of this circle, a list is created. If the place has already some filled fields, you'll see these values in a green color row. If you agree, you double click on this row. if you don't agree, you can choose another row.

Another way to set latitude and longitude :
* Download the [[Place completion tool]] via the [[5.2_Addons#Installing_Addons_in_Gramps|Addons manager]]. If you download the data of your country, this tool can add latitude-longitude to all your places.

====Adding places from KML files====

For this, click on the [[Gramps_5.2_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a context popup menu.

In this menu, you can select {{man label|Add place from KML}}

You will get the {{man label|Select a kml file used to add places}} file chooser dialog. Select the file you want to add.

If you have several places in the same KML file, you will get one place editor for each place. Be careful.

====How to change the map provider ?====
{{man warn|Some maps are not free|Please read the map provider ''Terms of Service''}}
{| style="float:right; margin:auto; text-align:center; margin-left: 0px;"
! colspan="3"|[[File:OpenStreetMap_5.15.10.png|256px|thumb|Center|OpenStreetMap]]
|-
|
|-
| [[File:MapsForFree_5.15.10.jpg|128px|thumb|Left|Maps For Free]]|| [[File:OpenCycleMap_5.15.10.png|128px|thumb|Center|OpenCycleMap ]]|| [[File:PublicTransport_5.15.10.png|128px|thumb|Right|Public Transport]]
|-
|
|-
| [[File:GoogleStreet_5.15.10.png|128px|thumb|Center|Google street ]]|| [[File:GoogleSat_5.15.10.jpg|128px|thumb|Center|Google sat ]]|| [[File:GoogleHybrid_5.15.10.jpg|128px|thumb|Center|Google hybrid]]
|-
|
|-
| [[File:Virtualearthstreet_5.15.10.png|128px|thumb|Center|Virtualearth street ]]|| [[File:VirtualearthSat_5.15.10.jpg|128px|thumb|Center|Virtualearth sat]]|| [[File:VirtualearthHybrid_5.15.10.jpg|128px|thumb|Center|Virtualearth hybrid]]
|}
Several map providers are available in Gramps.

Click on the [[Gramps_5.2_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a popup menu.

In the bottom of this menu, you can select a new provider.

The following providers are available :
* '''OpenStreetMap''' (default) : The advantage of [http://www.openstreetmap.org/ OpenStreetMap] is that it is a free project, so you can update the maps yourself with missing information via their website.
* Maps For Free
* OpenCycleMap
* Public Transport
* Google street
* Google sat
* Google hybrid
* Virtualearth street
* Virtualearth sat
* Virtualearth hybrid

[https://www.google.com/intl/en_ALL/help/terms_maps.html Google street],
[https://www.google.com/intl/en_ALL/help/terms_maps.html Google sat],
[https://www.google.com/intl/en_ALL/help/terms_maps.html Google hybrid],
[http://www.microsoft.com/maps/product/terms.html Virtualearth street],
[http://www.microsoft.com/maps/product/terms.html Virtualearth sat], and
[http://www.microsoft.com/maps/product/terms.html Virtualearth hybrid]

Note that Virtualearth is now Bing maps

====Can we change the marker's color ?====

Only the {{man label|[[Gramps_5.2_Wiki_Manual_-_Categories#All_known_places|All known Places]]}} view supports changing the place type markers colors all the other views are hard coded in Gramps.
{{-}}

====How to get/remove the crosshair ?====
It can be useful to have the crosshair visible to see the center of the map.
This functionality is available with the [[Gramps_5.2_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse. you'll get a popup menu.
Select Add or Remove cross hair.
This is useful to add or link places to the correct latitude-longitude coordinates

====How to lock/unlock the map ?====
When we change the map ( person to family, ... ), the zoom is recalculated.
It can be useful in some case to keep the same zoom and position when we change the map provider.
For this, click on the [[Gramps_5.2_Wiki_Manual_-_Categories#button_3_.28_right_button_.29|right button]] of the mouse, you'll get a popup menu.
In this menu, you can select lock or unlock zoom and position.

===Prerequisites to see the geography view===
For Gramps 5.x, you need to install [http://nzjrs.github.io/osm-gps-map/ osmgpsmap] version 1.0 and above and the associated gir package.

For example on ubuntu, you must have:
<code>gir1.2-osmgpsmap-1.0</code> and <code>libosmgpsmap-1.0-0</code>

===Possible problems===
*No view : do you have <code>osmgpsmap</code> installed ? (''<code>gramps -v</code>'' from the command line may help you)
*No tiles : do you have an internet connection active ?
*No tiles for one provider : if other providers are OK, file a bug
*Missing tiles : you have no internet connection and it's the first time you try to show the current place.
*Missing tiles : this can be the same as no tiles for one provider if they modify the access rules (i.e user-agent)
*Other : [[Using_the_bug_tracker|Report a bug]]

===Geography Category Bottombar tabs===

The {{man label|Geography Category}} by default displays no Gramplets in the [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tab. You may add them as required.

{{-}}

===Geography Category Sidebar tabs===

The {{man label|Geography Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.

{{-}}
====Filter====

The filter type may change depending on the view selected.

See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Sources Category ==

The {{man label|Sources Category}} offers two view modes ({{man label|[[#Citation_Tree_View|Citation Tree]]}} View and {{man label|[[#Sources_List_View|Sources List]]}} View (default)) that list the sources of certain information stored in the family tree. The record selection, column configuration and Gramplet selections are independent for each view mode.

Sources can include various documents: birth, death, and marriage certificates; books; films; journals; private diaries - nearly anything that can be described as genealogical evidence. Gramps gives you the option to provide citations of sources for each (Event, Person, Place, Media, Note, et cetera) object you create.

By default, the Sources View mode lists the {{man label|Title}}, {{man label|ID}}, and {{man label|Author}} of the source, as well as any {{man label|Publication}} information that may be associated with it. The list of Sources can be re-sorted by clicking on a different column heading. Clicking the header the first time sorts the rows in ascending order based on that column. Clicking again reverses to descending order.

The {{man label|Column Editor}} tab of the Configure Sources dialog can be used to add, remove and rearrange the displayed columns. Click the [[file:gramps-config.png|x32px]] {{man tooltip|Configure the active view}} toolbar button or select Configure… from the {{man menu|Edit}} menu to open the dialog.

You can select the {{man button| {{icon| stock_add}}}} {{man tooltip|Add a new source}} toolbar button to create a new source or {{man button| {{icon| stock_edit}}}} {{man tooltip|Edit the selected source}} button to edit the sources selected in the list. Either action will invoke the {{man label|[[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New_Source_dialog|Source Editor]]}} dialog.

* See [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_sources|Editing information about sources]]
{{-}}
===Citation Tree View===
[[File:SourcesCategory-CitationTreeView-example-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources Category - Citation Tree - View]]

The {{man label|[[#Citation_Tree_View|Citation Tree]]}} View mode list will also show all the sources. In addition, it allows the user to see the [[#Citations_Category|Citations]] associated with each source by clicking on the [https://en.wikipedia.org/wiki/Disclosure_widget disclosure triangle] node {{man button|▶}}expand or {{man button|▼}}collapse disclosure triangular widget.

All the nodes of the tree view mode can be simultaneously collapsed or expanded from the context/pop-up menu shown by right-clicking:
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Expand all Nodes}}
*{{man menu|Collapse all Nodes}}
*{{man menu|Add…}}
*{{man menu|Add citation…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View ▶ Source or Citation References}}
{{-}}

===Sources List View===

[[File:SourcesCategory-SourcesListView-example-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources Category - (List) View]]

The default, {{man label|Sources View}} mode only shows the Sources as a list and displays the {{man label|Title}}, {{man label|ID}}, and {{man label|Author}} of the source, as well as any {{man label|Publication}} information that may be associated with it. The list of Sources can be re-sorted by clicking on a different column heading. Clicking the header the first time sorts the rows in ascending order based on that column. Clicking again reverses to descending order.

Additional options are available by selecting a source from the list and using the context/pop-up menu shown by right-clicking:
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View ▶ Source References}}
{{-}}

===Sources Category Bottombar tabs===

The {{man label|Sources Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Gallery====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Notes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====References====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Sources Category Sidebar tabs===

The {{man label|Sources Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Citations Category ==

The {{man label|Citations Category}} shows the Citation list View that show the citations for certain information stored in the family tree.

Citations specify which parts of a source are relevant to the information in the database. For example, a Source may be a book, and the citation may be a particular page in the book. Gramps gives you the option to provide a citation for each event you record (births, deaths, marriages, etc.).

{{-}}
===Citations List View===

[[File:CitationsCategory-CitationsListView-example-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Citations Category - Citations (List) View - example]]

The Citations List View shows the {{man label|Volume/Page}} , {{man label|ID}} , and {{man label|Date}} of the citation, as well as any {{man label|Confidence}} in the evidence.

The list of Citations can be sorted by clicking on a column heading.

Clicking once sorts in ascending order, clicking again sorts in descending order. The {{man label|Column Editor}} dialog can be used to add, remove and rearrange the displayed columns.

Additional options are available by selecting a citation from the list and using the context/pop-up menu shown by right-clicking:
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View ▶ Citation References}}
{{-}}

===Citations Category Bottombar tabs===

The {{man label|Citations Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Gallery====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Gallery|Gallery]] Gramplet
{{-}}
====Notes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====References====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Citations Category Sidebar tabs===

The {{man label|Citations Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Repositories Category ==

The {{man label|Repositories Category}} shows the Repository List View. A repository can be thought of as a collection of sources. Each source in the family tree may be a reference to a repository (such as a library) in which it belongs.

{{-}}
===Repository List View===

[[File:RepositoriesCategory-RepositoriesListView-example-52.png|450px|right|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Repositories (list) view - example]]

This view shows a list of all recorded repositories.

Additional options are available by selecting a repository from the list and using the context/pop-up menu shown by right-clicking:
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View ▶ Repository References}}
{{-}}

===Repository Category Bottombar tabs===

The {{man label|Repository Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Details====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Details|Details]] Gramplet
{{-}}
====Notes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====References====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Repository Category Sidebar tabs===

The {{man label|Repository Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Media Category ==

The {{man label|Media Category}} shows the Media List View, which list the Media Objects stored in the family tree.

Media Objects are technically any files that relate somehow to the stored genealogical data.

Most frequently, these are images, audio files, animation files, etc.
{{-}}
===Media List View===

[[File:MediaCategory-MediaListView-example-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media Category - Media (List) View - example]]

The Media List View shows the following columns for the list {{man label|Name}} , {{man label|ID}} , {{man label|Type}}, {{man label|Path}} and {{man label|Date}} of the Media Object.

The {{man label|Column Editor}} dialog may be used to rearrange the displayed columns, which obey usual sorting rules.

Selecting a media item from the list and using the context menu (right-clicking) offers the following options
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|View}} - show the media item using an external program.
*{{man menu|Open Containing Folder}} - which opens to the folder containing the media item.
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View}}
** {{man menu|Media References}}
{{-}}

===Media Category Bottombar tabs===

The {{man label|Media Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====Preview====
In the "Preview" tab you can double click on the media/photo to open it in the default picture viewer.

See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Media_Preview|Media Preview]] Gramplet
{{-}}
====Citations====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Citations|Citations]] Gramplet
{{-}}
====Notes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Notes|Notes]] Gramplet
{{-}}
====Attributes====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Attributes|Attributes]] Gramplet
{{-}}
====Image Metadata====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Image Metadata|Image Metadata]] Gramplet
{{-}}
====References====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Media Category Sidebar tabs===

The {{man label|Media Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet
{{-}}

== Notes Category ==

The {{man label|Notes Category}} View shows a List mode, which inventories the text notes (either pure text or pre-formatted) that can be referenced by the other objects.

See also:
* Using the [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_notes|Note Editor]] to make new annotations or editing information about existing notes
{{-}}
===Notes List View===

[[File:NotesCategory-NotesListView-example-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Notes Category - Notes (List) view]]

The Notes List View shows a list of text notes.

The functionality of the notes View is similar to the other views. The view lists all {{man label|Notes}} stored in the Family Tree.

Using the menu {{man menu|View ->Configure View...}} you open the {{man label|Column Editor}} and you can change the displayed columns. The possibilities are {{man label|Preview}}, {{man label|ID}}, {{man label|Type}}, {{man label|Private}}, {{man label|Tags}} and {{man label|Last Changed}}.

The {{man label|Type}} can be ([[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#note_type|amongst others]]): ''Event Note'', ''Address Note'', ''Source text'', ''Place Note''. (In version 5.2, the built-in {{man label|Type}} list includes: ''Citation'', ''General'', ''HTML code'', ''Link'', ''Report'', ''Research'', ''Source text'', ''To Do'', ''Transcript'', ''Unknown'')

Selecting a Note item from the list and using the context menu (right-clicking) offers the following options
*{{man menu|Back}}
*{{man menu|Forward}}
*{{man menu|Add…}}
*{{man menu|Edit…}}
*{{man menu|Delete}}
*{{man menu|Merge…}}
*{{man menu|Quick View}}
**{{man menu|Link References}}
**{{man menu|Note References}}

Double-clicking on a Note item in the list will bring up the [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#New_Note_editor_dialog|Note editor]] window where you can edit the Note. You can change fonts, font color and background color. A [[Gramps_5.2_Wiki_Manual_-_Settings#Environment_Settings|spelling checker]] is available for ''English'' and your local language.
{{-}}

===Notes Category Bottombar tabs===

The {{man label|Notes Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Bottombar]] tabs.
{{-}}
====References====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#References|References]] Gramplet
{{-}}
===Notes Category Sidebar tabs===

The {{man label|Notes Category}} shows the following [[Gramps_5.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|Sidebar]] tabs.
{{-}}
====Filter====
See [[Gramps_5.2_Wiki_Manual_-_Gramplets#Filter|Filter]] Gramplet

{{-}}
{{man index|Gramps 5.2 Wiki Manual - Main Window|Gramps 5.2 Wiki Manual - Manage Family Trees|5.2}}
{{languages|Gramps 5.2 Wiki Manual - Categories}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

Gramps 5.2 Wiki Manual - Settings

2024-09-08T22:24:26Z

DaveSchweisguth: /* Database Location */ Defer to the user directory page

{{man index|Gramps 5.2 Wiki Manual - Tools|Gramps 5.2 Wiki Manual - Filters|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_Settings}}
{{#vardefine:chapter|15}}
{{#vardefine:figure|0}}
This section deals with various settings you can manage within Gramps.

== Preferences ==
[[File:EditPreferencesTabsOnly-overview-52.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all 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...}}.

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_5.2_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_5.2_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

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

Also ''other'' additional tabs maybe shown from any [[5.2_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== Data ===
[[File:EditPreferences-Data-tab-default-52.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_5.2_Wiki_Manual_-_Settings#Display_Options|Display Options]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Input_Options|Input Options]]}}
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-52.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_5.2_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]}}
*{{man label|Coordinates format:}} This option controls the display of Coordinates. (See [[Gramps_5.2_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", "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_5.2_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=Note|2=Besides this database-wide setting Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_5.2_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}} {{new|5.1}}
*{{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.}} {{new|5.1}}

*{{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_5.2_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}} {{new|5.2.0}}

*{{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. {{new|5.2.0}}

===== Place Format Editor =====
{{man note|See|[[Hierarchical Place Structure]]}}
[[File:EditPreferences-Data-tab-Display-section-PlaceFormatEditor-dialog-default-52.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" section]]

Accessed from the Edit > Data tab [[Gramps_5.2_Wiki_Manual_-_Settings#Display_Options|Display Options]] section "Automate Place Format" option.

This tab contains preferences relevant to how Places should be shown.

*{{man label|Name:}} A unique name for the place format.
*{{man label|Levels:}} 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:}} "None" (default), "Number Street" or "Street Number". Option to concatenate the number and street in order to suppress the comma. For this option to work, the street must have the [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''']] ''Street'' and house number must have the '''Type''' ''Number''.
*{{man label|Language:}} (Empty by Default) A two-digit language code.
*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)

See also:
* [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor dialog]]
* [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name Editor dialog]]
{{-}}
{{stub}}

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

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

[[File:EditPreferences-Data-tab-DisplayOptions-section-DisplayNameEditor-dialog-default-52.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 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
* 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
* Familynick - family nick name
* Rest - non primary surnames
* Rawsurnames- surnames (no prefixes and connectors)
* Surname - surnames (with prefix and connectors)
* Suffix - suffix (Jr., Sr.)
* Nickname - nick name
* Common - nick name, otherwise first of Given
* Prefix - all prefixes (von, de)
* Notpatronymic- all surnames, except pa/matronymic & primary

{{man menu|UPPERCASE versions of these keywords forces uppercase to be displayed.}} Extra parentheses, commas are removed. Other text appears literally.

[[File:NameEditor-format_reference_example-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor - reference person]]

'''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>.

All the fields in the Example 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 & Display controls, Date range controls for using a particular name.

{{stub}}

{{-}}

==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-52.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. The default {{man label|Father's surname}} will use the family name of the father. Selecting {{man label|None}} means that no surname guessing will be attempted. Selecting {{man label|Combination of mother's and father's surname}} will use the father's name followed by the mother's name. Finally, {{man label|[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_5.2_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_5.2_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_culture Category:Names by culture], From Wikipedia, the free encyclopedia}}

*{{man label|Default family relationship:}}
** '''Unknown'''(default)
** Married
** Unmarried
** Civil Union

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

=== General ===
[[File:EditPreferences-General-tab-EnviromentSettings-section-default-52.png|Right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} General Preferences - Enviroment 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_5.2_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 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 spelling checker}}: This checkbox option controls the enabling and disabling of the spelling checker for notes. The '''gtkspell''' package must be loaded for this to have an effect. ( See: [[Troubleshoot Spellcheck]] )

*{{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_5.2_Wiki_Manual_-_Main_Window#Navigator|Navigator]] in the [[Gramps_5.2_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}}

*{{checkbox|0}}{{man label|Show close button in gramplet bar tabs}} ''unchecked''(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:'''150''' 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-WhatsThatFor-52.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog]]

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 ===
{{stub}}
[[File:EditPreferences-FamilyTree-tab-default-52.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_5.2_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Database_Location|Database Location]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}}

See also:
* [[Gramps_5.2_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
* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds support for PostgreSQL databases.

====Database Settings====
*{{man label|Database backend:}} -
** '''[[Gramps_Glossary#sqlite|SQLite]]''' (''default'') - the [[DB-API Database Backend]]
** ... If other database backends addons are installed, they will be added to the list <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>: [[Addon:PostgreSQL|PostgreSQL]] backend

The ''[[Gramps_Glossary#bsddb|BSDDB]]'' - Legacy Database backend was superseded in the Gramps 5.1 version.

====Database Location====
*{{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|Family Tree 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_5.2_Wiki_Manual_-_User_Directory|User Directory]].

====Backup Management====
*{{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 {{new|5.2.0}}
** Every day {{new|5.2.0}}
{{-}}

====Family Tree's Media path====
*{{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_5.2_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_5.2_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_5.2_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_5.2_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_5.2_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}

=====Select media directory dialog=====

{{stub}}

See [[Gramps_5.2_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}

=====Missing Media Objects 'broken link' icon of a box with a red 'x'=====
{{stub}}
[[File:Broken Media Path.png|right|350px|thumb|Fig. {{#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_5.2_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section.
{{-}}

=== Import ===
[[File:EditPreferences-Import-tab-default-52.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:

==== Tag Records ====

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

==== Source GEDCOM import ====

*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_5.2_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.'''

{{-}}

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

Settings used for calculation operations.

See also:
* [[Gramps 5.2 Wiki Manual - Probably Alive]]
* [[Gramps_5.2_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_5.2_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
{{-}}

=== Colors ===
{{stub}}
[[File:EditPreferences-Colors-tab-default-52.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - UK/Australian dialect 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 [[Gramps_5.2_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) or ''Dark colors''
** {{man button|Restore to defaults}} - restores themes default colors.

====Colors for Male persons====
* Background for Alive: [ ] #b8cee6
* Border for Alive: [ ] #1f4986
* Background for Dead: [ ] #b8cee6
* Border for Dead: [ ] #000000

====Colors for Female persons====
* Background for Alive: [ ] #feccf0
* Border for Alive: [ ] #861f69
* Background for Dead: [ ] #feccf0
* Border for Dead: [ ] #000000

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

====Colors for Unknown persons====
* Background for Alive: [ ] #f3dbb6
* Border for Alive: [ ] #8e5801
* Background for Dead: [ ] #f3dbb6
* Border for Dead: [ ] #000000

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

====Other colors====
* 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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences 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 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_5.2_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_5.2_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-52.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_5.2_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}

=== Text ===

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

This tab contains preferences relevant to how missing and private names and records should be shown.

*{{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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]

This tab controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.

*{{checkbox|1}}{{man label|Suppress warning when adding parents to a child.}} Checkbox checked by Default (See [[Gramps_5.2_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_5.2_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_5.2_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 {{new|5.2.0}}
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])

See the [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
{{-}}

=== 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-52.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 [[Gramps_5.2_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information]] tool.
{{-}}

== Other settings ==

Besides {{man label|Preferences}} dialog, there are other settings available in Gramps. For various reasons they have been made more readily accessible, as listed below.
{{-}}
===Column Editor===

{{man tip|1=Column Editor|2=The {{man label|Column 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:ConfigureTheActiveView-icon-on-toolbar-51.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Selecting the {{man button|Configure View...}} button]]

[[File:ColumnEditor-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Column Editor - Dialog - People default]]

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

To use the {{man label|Column Editor }} dialog for the current view, 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_5.2_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 Column Editor], so changing which field is in that position affects default sorting.

[[File:ConfigurePersonView-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Column Editor - Dialog - People example]]The {{man label|Column 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_5.2_Wiki_Manual_-_Filters|filters]] will also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_5.2_Wiki_Manual_-_Settings#Export_View|Export View...]]}} operation. Hidden columns and records will not be exported.
{{-}}

=== Sorting columns ===

[[File:PeopleCategory-PeopleListView-SortedByBirthDateColumn-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 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_5.2_Wiki_Manual_-_Settings#Column_Editor|Column 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-50.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_5.2_Wiki_Manual_-_Settings#General_Gramps_settings|General]] setting in [[Gramps_5.2_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_5.2_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 Pedigree Category. [[File:Gramps Go-Home48x48 win.png|text-bottom]]
====See also====
* [[Gramps_5.2_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 Pedigree and Relationships Views) are displayed in the main window is adjusted through the View menu.

In the different views clicking the {{man menu|[[Gramps_5.2_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_5.2_Wiki_Manual_-_Settings#Column_Editor|column editor]].

===Export View===

[[File:Menubar-FamilyTrees-overview-example-50.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_5.2_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_5.2_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_5.2_Wiki_Manual_-_Filters|filters]] you have applied.
{{-}}
====Export View as Spreadsheet dialog====

[[File:ExportViewAsSpreadsheet-CSV-file-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Export View as Spreadsheet" CSV(default) file-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:
* '''CSV''' (default)
* '''OpenDocument Spreadsheet''' - ODS format.

{{-}}
[[File:ExportViewAsSpreadsheet-exampleODS-Displayed-in-LibreOfficeCalc-50.png|right|thumb|400px|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.

{{-}}

===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 [[5.2_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_5.2_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[5.2 Addons|Third-Party Addons]].
{{-}}

===Customize report output formats===
[[File:TextReports-DocumentOptions-PlainText-output-settings-50.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_5.2_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_5.2_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_5.2_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_5.2_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}

====Style editor dialog====

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|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_5.2_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report]]}} shows the style options for AHN-Entry, AHN-Generation and AHN-Title.

On the right hand side are three tabs associated with each style listed in the left hand column:
{{-}}
======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) (Gramps 4.2.0 Windows 7) ]]

*{{man label|Description}} : The description describes what each paragraph is all about. For example shown here is the style used for the Ahnentafel Report ( AHN-Entry ).
{{-}}

======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}} : Here you can set the {{man label|Type face}} Roman or Swiss, the {{man label|Size}} of the font in pt., 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}} : Here you 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===
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]

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

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

The Display tab of the Preferences allows selection of the Name format used by default throughout Gramps. The Edit button for the {{man label|Name format:}} opens the {{man label|[[Gramps_5.2_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_5.2_Wiki_Manual_-_Settings#Preferences|Preferences]]

The Edit button for a person's preferred and alternative names opens the {{man label|[[Gramps_5.2_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_5.2_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_5.2_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 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.

====Context Menu options====
Right-click on any file or folder in the current directory to open context pop-up menu with the following options:
* Open With File Manager
* Copy Location
* [[Gramps_5.2_Wiki_Manual_-_Settings#Bookmarking_file_folders|Add to Bookmarks]]
* ❏ Show Hidden Files
* ☑ Show Size Column
* ☑ Show Type Column
* ❏ Show Time
* ❏ Sort Folders before Files

Right-click in the navigation sidebar to open context pop-up menu with the following options:
* Open
* Remove
* Rename...
====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_5.2_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]

=== 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-5.2.3^" 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:Microsoft Window Gramps AIO Installer Choose Components-Selection-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]
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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for shortcut example.]]

To make Gramps work in your selected language (See table below for your [[Gramps_5.2_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:
* Using your mouse right button click on the "{{man label|GrampsAIO64 5.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 5.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 5.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-5.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 5.2 Language icons Shortcuts Pack ( for the 18 languages shown in the Language 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"
|
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|}
*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].

===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 2023/09/13 14:17:45

[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0
;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps52', True]]
;;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps52'
;;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=0
;;web-search-url='http://google.com/#&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=0
;;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
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-text=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
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-default'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;default-source=0
;;eprefix='E%04d'
;;family-relation-type=3
;;family-warn=1
;;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/gramps52/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 5.2 :
~/.gramps/gramps52/gramps.ini

See also:
* [[Gramps_5.2_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog]]
* [[Gramps_5.2_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:Themes]]
* [[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 5.2 Wiki Manual - Tools|Gramps 5.2 Wiki Manual - Filters|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_Settings}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

Gramps 5.2 Wiki Manual - User Directory

2024-09-08T22:19:22Z

DaveSchweisguth: Document new and old user directories for each OS, and fallback behavior

{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix documents the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. That directory, or folder, is stored at different locations due to

* differences in operating systems
* your username, i.e. the account with which you've logged into your computer. Where ''<username>'' is shown below it should be replaced by your username.
* user configuration

__TOC__

== New and old default locations and fallback behavior {{new|5.2.0}} ==
In Gramps 5.2, on every operating system, the default location of the user directory changed. New and old default user directory locations for each OS are given below. If Gramps 5.2 and later detects a user directory in the old default location, it will use that directory and not create one in the new default location. Otherwise, it will create a user directory in the new default location.

== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is {{new|5.2.0}}

/home/''<username>''/.local/share/gramps

In Gramps 5.1 and earlier, the user directory on a POSIX-style environment was

/home/''<username>''/.gramps

This is true for [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris] and [https://wikipedia.org/wiki/Unix Unix].

For brevity, you can use tilde notation. The path above can be simplified to

~''<username>''/.local/share/gramps

or, to avoid referring to the username,

~/.local/share/gramps

You can also use the [http://www.linfo.org/home_directory.html '''$HOME''' environment variable]. Although Gramps will not recognize environment variables in paths internally, you can use them in a terminal or in scripts. Using '''$HOME''', the path above can be simplified to

$HOME/.local/share/gramps

==macOS==
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
The default user directory location for Gramps on macOS, both the [[Mac OS X:Application package]] and [[Build_from_source#Mac_OS_X|built from source]], is (similar to other POSIX systems) {{new|5.2.0}}

/Users/''<username>''/.local/share/gramps

In Gramps 5.1 and earlier, the user directory for the Gramps [[Mac OS X:Application package]] was

/Users/''<username>''/Library/Application Support/gramps

but the user directory for [[Build_from_source#Mac_OS_X|Gramps built from source on macOS]] was (similar to other POSIX systems)

/Users/''<username>''/.gramps

=== Accessing hidden directories in macOS ===
macOS filenames, including directories, starting with "." (period) do not show up in Finder. Access the Gramps user directory in any of these ways:
* In Finder, navigate to the directory which contains the hidden file or directory you want to see and type command-shift-. (period). All of the hidden files and directories in that directory will be shown.
* Click on [https://osxdaily.com/2011/08/31/go-to-folder-useful-mac-os-x-keyboard-shortcut/ {{man menu|Go -> 'Go to Folder...'}}] in the Finder, and type
~/.gramps
: in the resulting macOS {{man label|Go to the Folder}} dialog box.
* Open a terminal window using the Terminal application and type
ln -s ~/.gramps ~/Documents/Gramps
which will make Finder show the directory as a folder in your Documents folder named "Gramps". (You can replace "Gramps" with whatever name you wish, but use a \ before any spaces.)

== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]
The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is {{new|5.2.0}}

C:\Users\''%username%''\AppData\Local\gramps

In Gramps 5.1 and earlier, the user directory for Windows 7 (and newer) was

C:\Users\''%username%''\AppData\Roaming\gramps

Alternately, you can use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA environment variable] to avoid referring to the username. (We've chosen to use the username environment variable in the documentation for Windows rather than '''''<username>''''' used for documenting other OSes.) Although Gramps will not recognize environment variables for paths internally, you can use them within Windows to find Gramps user files. The path above can be simplified to:
%LocalAppData%\gramps

=== Accessing hidden directories in MS Windows ===
On Microsoft Windows, filenames and folder for programs and userdata are [https://wikipedia.org/wiki/Hidden_file_and_hidden_directory hidden] in the ''File Explorer''. To make access to the Gramps user directory easy follow the following advice from Microsoft:
* [https://support.microsoft.com/en-ca/help/14201/windows-show-hidden-files Show hidden files - Windows Help]

Like the '''User Directory''', the location for programs/applications is also hidden from browsing with Windows Explorer.

The default location for an installation on a Windows 7 (and newer) system is
C:\Program Files\GrampsAIO64-5.X.X
{{-}}

== See Also ==
* [[Gramps_5.2_Wiki_Manual_-_Command_Line|Command Line]] Configuration (config) option with [[Gramps_5.2_Wiki_Manual_-_Command_Line#Environment_variables|Environment Variables]]
* [https://winaero.com/how-to-enter-file-location-manually-in-gtk-3-opensave-dialog/ Switching from Breadcrumbs to a location text box] using {{Man key press|Crtl|L}} in GTK file dialogs
* Discourse forum threads :
** [https://gramps.discourse.group/t/how-to-set-the-base-path-from-media-relative-to-grampshome/481/2 how to use Environment Variables in Gramps]
** [https://gramps.discourse.group/t/manually-installing-addons/5696/5 Using Python Eval gramplet to list the Plugins folder path]
** [https://gramps.discourse.group/t/troubleshooting-gramps-paths-and-environmental-variables/5692 Troubleshooting Gramps paths and environmental variables] with the [[Gramps_5.2_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] gramplet

*{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{grampsmanualcopyright}}
[[Category:Documentation|U]]

Gramps 5.2 Wiki Manual - User Directory

2024-09-08T21:29:44Z

DaveSchweisguth: /* MS Windows */ As with other OSes, give the user dir location first

{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix documents the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. That directory, or folder, is stored at different locations due to

* differences in operating systems
* your username, i.e. the account with which you've logged into your computer. Where ''<username>'' is shown below it should be replaced by your username.
* user configuration

__TOC__
== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is:

/home/''<username>''/.gramps

This is true for [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris], [https://wikipedia.org/wiki/Unix Unix] and [https://wikipedia.org/wiki/Mac_OS_X Mac OS-X] when using [[Build_from_source#Mac_OS_X|Mac OS X Build from source]].

For brevity, you can use tilde notation. The path above can be simplified to

~''<username>''/.gramps
or, to avoid referring to the username,
~/.gramps

You can also use the [http://www.linfo.org/home_directory.html '''$HOME''' environment variable]. Although Gramps will not recognize environment variables in paths internally, you can use them in a terminal or in scripts. Using '''$HOME''', the path above can be simplified to

$HOME/.gramps

==macOS Application Package==
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
The [[Mac OS X:Application package]] uses a different, more macOS-standard default location for the directory:
/Users/''<username>''/Library/Application Support/gramps

=== Accessing hidden directories in macOS ===
macOS filenames, including directories, starting with "." (period) do not show up in Finder. Access the Gramps user directory in any of these ways:
* In Finder, navigate to the directory which contains the hidden file or directory you want to see and type command-shift-. (period). All of the hidden files and directories in that directory will be shown.
* Click on [https://osxdaily.com/2011/08/31/go-to-folder-useful-mac-os-x-keyboard-shortcut/ {{man menu|Go -> 'Go to Folder...'}}] in the Finder, and type
~/.gramps
: in the resulting macOS {{man label|Go to the Folder}} dialog box.
* Open a terminal window using the Terminal application and type
ln -s ~/.gramps ~/Documents/Gramps
which will make Finder show the directory as a folder in your Documents folder named "Gramps". (You can replace "Gramps" with whatever name you wish, but use a \ before any spaces.)

== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]
The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is
C:\Users\''<username>''\AppData\Local\gramps
{{man note|User Directory relocated {{new|5.2.0}}|'''The User Directory has relocated in version 5.2''' The default '''User Directory''' location for the 5.2 version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Local\gramps</code>  <code> %LocalAppData%\gramps</code> The default '''User Directory''' location for any 5.1.x and earlier version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Roaming\gramps</code>  <code> %AppData%\gramps</code>}}

Alternately, you can use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA environment variable] to avoid referring to the username. (We've chosen to use the username environment variable in the documentation for Windows rather than '''''<username>''''' used for documenting other OSes.) Although Gramps will not recognize environment variables for paths internally, you can use them within Windows to find Gramps user files. The path above can be simplified to:
%LocalAppData%\gramps

=== Accessing hidden directories in MS Windows ===
On Microsoft Windows, filenames and folder for programs and userdata are [https://wikipedia.org/wiki/Hidden_file_and_hidden_directory hidden] in the ''File Explorer''. To make access to the Gramps user directory easy follow the following advice from Microsoft:
* [https://support.microsoft.com/en-ca/help/14201/windows-show-hidden-files Show hidden files - Windows Help]

Like the '''User Directory''', the location for programs/applications is also hidden from browsing with Windows Explorer.

The default location for an installation on a Windows 7 (and newer) system is
C:\Program Files\GrampsAIO64-5.X.X
{{-}}

== See Also ==
* [[Gramps_5.2_Wiki_Manual_-_Command_Line|Command Line]] Configuration (config) option with [[Gramps_5.2_Wiki_Manual_-_Command_Line#Environment_variables|Environment Variables]]
* [https://winaero.com/how-to-enter-file-location-manually-in-gtk-3-opensave-dialog/ Switching from Breadcrumbs to a location text box] using {{Man key press|Crtl|L}} in GTK file dialogs
* Discourse forum threads :
** [https://gramps.discourse.group/t/how-to-set-the-base-path-from-media-relative-to-grampshome/481/2 how to use Environment Variables in Gramps]
** [https://gramps.discourse.group/t/manually-installing-addons/5696/5 Using Python Eval gramplet to list the Plugins folder path]
** [https://gramps.discourse.group/t/troubleshooting-gramps-paths-and-environmental-variables/5692 Troubleshooting Gramps paths and environmental variables] with the [[Gramps_5.2_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] gramplet

*{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{grampsmanualcopyright}}
[[Category:Documentation|U]]

Gramps 5.2 Wiki Manual - User Directory

2024-09-08T21:22:24Z

DaveSchweisguth: /* POSIX - style systems */ Consolidate ways to refer to the user directory. Don't say that tilde notation doesn't work inside Gramps, because it does.

{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix documents the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. That directory, or folder, is stored at different locations due to

* differences in operating systems
* your username, i.e. the account with which you've logged into your computer. Where ''<username>'' is shown below it should be replaced by your username.
* user configuration

__TOC__
== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is:

/home/''<username>''/.gramps

This is true for [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris], [https://wikipedia.org/wiki/Unix Unix] and [https://wikipedia.org/wiki/Mac_OS_X Mac OS-X] when using [[Build_from_source#Mac_OS_X|Mac OS X Build from source]].

For brevity, you can use tilde notation. The path above can be simplified to

~''<username>''/.gramps
or, to avoid referring to the username,
~/.gramps

You can also use the [http://www.linfo.org/home_directory.html '''$HOME''' environment variable]. Although Gramps will not recognize environment variables in paths internally, you can use them in a terminal or in scripts. Using '''$HOME''', the path above can be simplified to

$HOME/.gramps

==macOS Application Package==
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
The [[Mac OS X:Application package]] uses a different, more macOS-standard default location for the directory:
/Users/''<username>''/Library/Application Support/gramps

=== Accessing hidden directories in macOS ===
macOS filenames, including directories, starting with "." (period) do not show up in Finder. Access the Gramps user directory in any of these ways:
* In Finder, navigate to the directory which contains the hidden file or directory you want to see and type command-shift-. (period). All of the hidden files and directories in that directory will be shown.
* Click on [https://osxdaily.com/2011/08/31/go-to-folder-useful-mac-os-x-keyboard-shortcut/ {{man menu|Go -> 'Go to Folder...'}}] in the Finder, and type
~/.gramps
: in the resulting macOS {{man label|Go to the Folder}} dialog box.
* Open a terminal window using the Terminal application and type
ln -s ~/.gramps ~/Documents/Gramps
which will make Finder show the directory as a folder in your Documents folder named "Gramps". (You can replace "Gramps" with whatever name you wish, but use a \ before any spaces.)

== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]On Microsoft Windows, filenames and folder for programs and userdata are [https://wikipedia.org/wiki/Hidden_file_and_hidden_directory hidden] in the ''File Explorer''. To make access to the Gramps user directory easy follow the following advice from Microsoft:
* [https://support.microsoft.com/en-ca/help/14201/windows-show-hidden-files Show hidden files - Windows Help]

The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is
C:\Users\''<username>''\AppData\Local\gramps

Alternately, you can use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA environment variable] to avoid referring to the username. (We've chosen to use the username environment variable in the documentation for Windows rather than '''''<username>''''' used for documenting other OSes.) Although Gramps will not recognize environment variables for paths internally, you can use them within Windows to find Gramps user files. The path above can be simplified to:
%LocalAppData%\gramps
{{man note|User Directory relocated {{new|5.2.0}}|'''The User Directory has relocated in version 5.2''' The default '''User Directory''' location for the 5.2 version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Local\gramps</code>  <code> %LocalAppData%\gramps</code> The default '''User Directory''' location for any 5.1.x and earlier version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Roaming\gramps</code>  <code> %AppData%\gramps</code>}}
<hr />
Like the '''User Directory''', the location for programs/applications is also hidden from browsing with Windows Explorer.

The default location for an installation on a Windows 7 (and newer) system is
C:\Program Files\GrampsAIO64-5.X.X
{{-}}

== See Also ==
* [[Gramps_5.2_Wiki_Manual_-_Command_Line|Command Line]] Configuration (config) option with [[Gramps_5.2_Wiki_Manual_-_Command_Line#Environment_variables|Environment Variables]]
* [https://winaero.com/how-to-enter-file-location-manually-in-gtk-3-opensave-dialog/ Switching from Breadcrumbs to a location text box] using {{Man key press|Crtl|L}} in GTK file dialogs
* Discourse forum threads :
** [https://gramps.discourse.group/t/how-to-set-the-base-path-from-media-relative-to-grampshome/481/2 how to use Environment Variables in Gramps]
** [https://gramps.discourse.group/t/manually-installing-addons/5696/5 Using Python Eval gramplet to list the Plugins folder path]
** [https://gramps.discourse.group/t/troubleshooting-gramps-paths-and-environmental-variables/5692 Troubleshooting Gramps paths and environmental variables] with the [[Gramps_5.2_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] gramplet

*{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{grampsmanualcopyright}}
[[Category:Documentation|U]]

Gramps 5.2 Wiki Manual - User Directory

2024-09-08T20:59:21Z

DaveSchweisguth: In macOS section: Give the directory before OS-usage info, as with POSIX. Document an easier method of seeing hidden files.

{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix documents the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. That directory, or folder, is stored at different locations due to

* differences in operating systems
* your username, i.e. the account with which you've logged into your computer. Where ''<username>'' is shown below it should be replaced by your username.
* user configuration

__TOC__
== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is:

/home/''<username>''/.gramps
which can also be entered as
~''<username>''/.gramps

This is true for [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris], [https://wikipedia.org/wiki/Unix Unix] and [https://wikipedia.org/wiki/Mac_OS_X Mac OS-X] when using [[Build_from_source#Mac_OS_X|Mac OS X Build from source]].

Alternately, you can use a tilde or the [http://www.linfo.org/home_directory.html '''$HOME''' environment variable] to avoid referring to the username. Although Gramps will not recognize a tilde or environment variable in paths internally, you can use them in a terminal or in scripts. The path above can be simplified to either:

~/.gramps
or
$HOME/.gramps

==macOS Application Package==
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
The [[Mac OS X:Application package]] uses a different, more macOS-standard default location for the directory:
/Users/''<username>''/Library/Application Support/gramps

=== Accessing hidden directories in macOS ===
macOS filenames, including directories, starting with "." (period) do not show up in Finder. Access the Gramps user directory in any of these ways:
* In Finder, navigate to the directory which contains the hidden file or directory you want to see and type command-shift-. (period). All of the hidden files and directories in that directory will be shown.
* Click on [https://osxdaily.com/2011/08/31/go-to-folder-useful-mac-os-x-keyboard-shortcut/ {{man menu|Go -> 'Go to Folder...'}}] in the Finder, and type
~/.gramps
: in the resulting macOS {{man label|Go to the Folder}} dialog box.
* Open a terminal window using the Terminal application and type
ln -s ~/.gramps ~/Documents/Gramps
which will make Finder show the directory as a folder in your Documents folder named "Gramps". (You can replace "Gramps" with whatever name you wish, but use a \ before any spaces.)

== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]On Microsoft Windows, filenames and folder for programs and userdata are [https://wikipedia.org/wiki/Hidden_file_and_hidden_directory hidden] in the ''File Explorer''. To make access to the Gramps user directory easy follow the following advice from Microsoft:
* [https://support.microsoft.com/en-ca/help/14201/windows-show-hidden-files Show hidden files - Windows Help]

The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is
C:\Users\''<username>''\AppData\Local\gramps

Alternately, you can use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA environment variable] to avoid referring to the username. (We've chosen to use the username environment variable in the documentation for Windows rather than '''''<username>''''' used for documenting other OSes.) Although Gramps will not recognize environment variables for paths internally, you can use them within Windows to find Gramps user files. The path above can be simplified to:
%LocalAppData%\gramps
{{man note|User Directory relocated {{new|5.2.0}}|'''The User Directory has relocated in version 5.2''' The default '''User Directory''' location for the 5.2 version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Local\gramps</code>  <code> %LocalAppData%\gramps</code> The default '''User Directory''' location for any 5.1.x and earlier version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Roaming\gramps</code>  <code> %AppData%\gramps</code>}}
<hr />
Like the '''User Directory''', the location for programs/applications is also hidden from browsing with Windows Explorer.

The default location for an installation on a Windows 7 (and newer) system is
C:\Program Files\GrampsAIO64-5.X.X
{{-}}

== See Also ==
* [[Gramps_5.2_Wiki_Manual_-_Command_Line|Command Line]] Configuration (config) option with [[Gramps_5.2_Wiki_Manual_-_Command_Line#Environment_variables|Environment Variables]]
* [https://winaero.com/how-to-enter-file-location-manually-in-gtk-3-opensave-dialog/ Switching from Breadcrumbs to a location text box] using {{Man key press|Crtl|L}} in GTK file dialogs
* Discourse forum threads :
** [https://gramps.discourse.group/t/how-to-set-the-base-path-from-media-relative-to-grampshome/481/2 how to use Environment Variables in Gramps]
** [https://gramps.discourse.group/t/manually-installing-addons/5696/5 Using Python Eval gramplet to list the Plugins folder path]
** [https://gramps.discourse.group/t/troubleshooting-gramps-paths-and-environmental-variables/5692 Troubleshooting Gramps paths and environmental variables] with the [[Gramps_5.2_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] gramplet

*{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{grampsmanualcopyright}}
[[Category:Documentation|U]]

Gramps 5.2 Wiki Manual - User Directory

2024-09-08T20:42:38Z

DaveSchweisguth: Don't restrict discussion of username references to Linux, as they apply to all OSes in this section

{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix documents the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. That directory, or folder, is stored at different locations due to

* differences in operating systems
* your username, i.e. the account with which you've logged into your computer. Where ''<username>'' is shown below it should be replaced by your username.
* user configuration

__TOC__
== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is:

/home/''<username>''/.gramps
which can also be entered as
~''<username>''/.gramps

This is true for [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris], [https://wikipedia.org/wiki/Unix Unix] and [https://wikipedia.org/wiki/Mac_OS_X Mac OS-X] when using [[Build_from_source#Mac_OS_X|Mac OS X Build from source]].

Alternately, you can use a tilde or the [http://www.linfo.org/home_directory.html '''$HOME''' environment variable] to avoid referring to the username. Although Gramps will not recognize a tilde or environment variable in paths internally, you can use them in a terminal or in scripts. The path above can be simplified to either:

~/.gramps
or
$HOME/.gramps

=== macOS ===
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
On Apple Macs filenames starting with "." do not show up in Finder. To simplify access to the Gramps user directory, open a terminal window using the Terminal application and type:
ln -s ~/.gramps ~/Documents/Gramps
which will make Finder show the directory as a folder in your Documents folder named "Gramps". (You can replace "Gramps" with whatever name you wish, but use a / before any spaces.) Alternatively you can simply click on [https://osxdaily.com/2011/08/31/go-to-folder-useful-mac-os-x-keyboard-shortcut/ {{man menu|Go -> 'Go to Folder...'}}] in the Finder, and type
~/.gramps
in the resulting macOS {{man label|Go to the Folder}} dialog box.

====macOS Application Package====
The [[Mac OS X:Application package]] uses a different, more macOS-standard default location for the directory:
/Users/''<username>''/Library/Application Support/gramps

== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]On Microsoft Windows, filenames and folder for programs and userdata are [https://wikipedia.org/wiki/Hidden_file_and_hidden_directory hidden] in the ''File Explorer''. To make access to the Gramps user directory easy follow the following advice from Microsoft:
* [https://support.microsoft.com/en-ca/help/14201/windows-show-hidden-files Show hidden files - Windows Help]

The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is
C:\Users\''<username>''\AppData\Local\gramps

Alternately, you can use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA environment variable] to avoid referring to the username. (We've chosen to use the username environment variable in the documentation for Windows rather than '''''<username>''''' used for documenting other OSes.) Although Gramps will not recognize environment variables for paths internally, you can use them within Windows to find Gramps user files. The path above can be simplified to:
%LocalAppData%\gramps
{{man note|User Directory relocated {{new|5.2.0}}|'''The User Directory has relocated in version 5.2''' The default '''User Directory''' location for the 5.2 version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Local\gramps</code>  <code> %LocalAppData%\gramps</code> The default '''User Directory''' location for any 5.1.x and earlier version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Roaming\gramps</code>  <code> %AppData%\gramps</code>}}
<hr />
Like the '''User Directory''', the location for programs/applications is also hidden from browsing with Windows Explorer.

The default location for an installation on a Windows 7 (and newer) system is
C:\Program Files\GrampsAIO64-5.X.X
{{-}}

== See Also ==
* [[Gramps_5.2_Wiki_Manual_-_Command_Line|Command Line]] Configuration (config) option with [[Gramps_5.2_Wiki_Manual_-_Command_Line#Environment_variables|Environment Variables]]
* [https://winaero.com/how-to-enter-file-location-manually-in-gtk-3-opensave-dialog/ Switching from Breadcrumbs to a location text box] using {{Man key press|Crtl|L}} in GTK file dialogs
* Discourse forum threads :
** [https://gramps.discourse.group/t/how-to-set-the-base-path-from-media-relative-to-grampshome/481/2 how to use Environment Variables in Gramps]
** [https://gramps.discourse.group/t/manually-installing-addons/5696/5 Using Python Eval gramplet to list the Plugins folder path]
** [https://gramps.discourse.group/t/troubleshooting-gramps-paths-and-environmental-variables/5692 Troubleshooting Gramps paths and environmental variables] with the [[Gramps_5.2_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] gramplet

*{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{grampsmanualcopyright}}
[[Category:Documentation|U]]

Gramps 5.2 Wiki Manual - User Directory

2024-09-08T20:36:25Z

DaveSchweisguth: Format or spell a couple more <username>s correctly. Remove <code> blocks inside code-styled blocks.

{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix documents the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. That directory, or folder, is stored at different locations due to

* differences in operating systems
* your username, i.e. the account with which you've logged into your computer. Where ''<username>'' is shown below it should be replaced by your username.
* user configuration

__TOC__
== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is:

/home/''<username>''/.gramps
which can also be entered as
~''<username>''/.gramps

This is true for [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris], [https://wikipedia.org/wiki/Unix Unix] and [https://wikipedia.org/wiki/Mac_OS_X Mac OS-X] when using [[Build_from_source#Mac_OS_X|Mac OS X Build from source]].

Alternately, you can use a tilde or the [http://www.linfo.org/home_directory.html '''$HOME''' environment variable] to avoid referring to the username. Although Gramps will not recognize a tilde or environment variable in paths internally, you can use them within Linux to find Gramps user files. The path above can be simplified to either:

~/.gramps
or
$HOME/.gramps

=== macOS ===
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
On Apple Macs filenames starting with "." do not show up in Finder. To simplify access to the Gramps user directory, open a terminal window using the Terminal application and type:
ln -s ~/.gramps ~/Documents/Gramps
which will make Finder show the directory as a folder in your Documents folder named "Gramps". (You can replace "Gramps" with whatever name you wish, but use a / before any spaces.) Alternatively you can simply click on [https://osxdaily.com/2011/08/31/go-to-folder-useful-mac-os-x-keyboard-shortcut/ {{man menu|Go -> 'Go to Folder...'}}] in the Finder, and type
~/.gramps
in the resulting macOS {{man label|Go to the Folder}} dialog box.

====macOS Application Package====
The [[Mac OS X:Application package]] uses a different, more macOS-standard default location for the directory:
/Users/''<username>''/Library/Application Support/gramps

== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]On Microsoft Windows, filenames and folder for programs and userdata are [https://wikipedia.org/wiki/Hidden_file_and_hidden_directory hidden] in the ''File Explorer''. To make access to the Gramps user directory easy follow the following advice from Microsoft:
* [https://support.microsoft.com/en-ca/help/14201/windows-show-hidden-files Show hidden files - Windows Help]

The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is
C:\Users\''<username>''\AppData\Local\gramps

Alternately, you can use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA environment variable] to avoid referring to the username. (We've chosen to use the username environment variable in the documentation for Windows rather than '''''<username>''''' used for documenting other OSes.) Although Gramps will not recognize environment variables for paths internally, you can use them within Windows to find Gramps user files. The path above can be simplified to:
%LocalAppData%\gramps
{{man note|User Directory relocated {{new|5.2.0}}|'''The User Directory has relocated in version 5.2''' The default '''User Directory''' location for the 5.2 version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Local\gramps</code>  <code> %LocalAppData%\gramps</code> The default '''User Directory''' location for any 5.1.x and earlier version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Roaming\gramps</code>  <code> %AppData%\gramps</code>}}
<hr />
Like the '''User Directory''', the location for programs/applications is also hidden from browsing with Windows Explorer.

The default location for an installation on a Windows 7 (and newer) system is
C:\Program Files\GrampsAIO64-5.X.X
{{-}}

== See Also ==
* [[Gramps_5.2_Wiki_Manual_-_Command_Line|Command Line]] Configuration (config) option with [[Gramps_5.2_Wiki_Manual_-_Command_Line#Environment_variables|Environment Variables]]
* [https://winaero.com/how-to-enter-file-location-manually-in-gtk-3-opensave-dialog/ Switching from Breadcrumbs to a location text box] using {{Man key press|Crtl|L}} in GTK file dialogs
* Discourse forum threads :
** [https://gramps.discourse.group/t/how-to-set-the-base-path-from-media-relative-to-grampshome/481/2 how to use Environment Variables in Gramps]
** [https://gramps.discourse.group/t/manually-installing-addons/5696/5 Using Python Eval gramplet to list the Plugins folder path]
** [https://gramps.discourse.group/t/troubleshooting-gramps-paths-and-environmental-variables/5692 Troubleshooting Gramps paths and environmental variables] with the [[Gramps_5.2_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] gramplet

*{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{grampsmanualcopyright}}
[[Category:Documentation|U]]

Gramps 5.2 Wiki Manual - User Directory

2024-09-08T15:40:21Z

DaveSchweisguth: Simplify how username is discussed and referred to. Consolidate some duplication in the first section.

{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{#vardefine:chapter|D}}
{{#vardefine:figure|0}}
This appendix documents the location of the '''Gramps [[Gramps_Glossary#user_directory|User Directory]]'''. That directory, or folder, is stored at different locations due to

* differences in operating systems
* your username, i.e. the account with which you've logged into your computer. Where <code>username</code> is shown below it should be replaced by your username.
* user configuration

__TOC__
== [[Gramps_Glossary#posix|POSIX]] - style systems ==
The default user directory location for Gramps in a [https://wikipedia.org/wiki/Posix POSIX]-style [https://wikipedia.org/wiki/Filesystem_Hierarchy_Standard environment] is:

/home/<code>username</code>/.gramps
which can also be entered as
~<code>username</code>/.gramps

This is true for [https://wikipedia.org/wiki/Bsd BSD], [https://wikipedia.org/wiki/Linux Linux], [https://wikipedia.org/wiki/Solaris_(operating_system) Solaris], [https://wikipedia.org/wiki/Unix Unix] and [https://wikipedia.org/wiki/Mac_OS_X Mac OS-X] when using [[Build_from_source#Mac_OS_X|Mac OS X Build from source]].

Alternately, you can use a tilde or the [http://www.linfo.org/home_directory.html '''$HOME''' environment variable] to avoid referring to the username. Although Gramps will not recognize a tilde or environment variables in paths internally, you can use them within Linux to find Gramps user files. The path above can be simplified to either:

~/.gramps
or
$HOME/.gramps

=== macOS ===
[[File:macos_200x200.png|right|128px|link=Download#macOS]]
On Apple Macs filenames starting with "." do not show up in Finder. To simplify access to the Gramps user directory, open a terminal window using the Terminal application and type:
ln -s ~/.gramps ~/Documents/Gramps
which will make Finder show the directory as a folder in your Documents folder named "Gramps". (You can replace "Gramps" with whatever name you wish, but use a / before any spaces.) Alternatively you can simply click on [https://osxdaily.com/2011/08/31/go-to-folder-useful-mac-os-x-keyboard-shortcut/ {{man menu|Go -> 'Go to Folder...'}}] in the Finder, and type
~/.gramps
in the resulting macOS {{man label|Go to the Folder}} dialog box.

====macOS Application Package====
The [[Mac OS X:Application package]] uses a different, more macOS-standard default location for the directory:
/Users/<code>username</code>/Library/Application Support/gramps

== MS Windows ==
[[File:windows_180x160.png|right|128px|link=Download#MS_Windows]]On Microsoft Windows, filenames and folder for programs and userdata are [https://wikipedia.org/wiki/Hidden_file_and_hidden_directory hidden] in the ''File Explorer''. To make access to the Gramps user directory easy follow the following advice from Microsoft:
* [https://support.microsoft.com/en-ca/help/14201/windows-show-hidden-files Show hidden files - Windows Help]

The default '''User Directory''' location for any Gramps user data on a Windows 7 (and newer) system is
C:\Users\<code>username</code>\AppData\Local\gramps

Alternately, you can use the '''%LocalAppData%''' [https://wikipedia.org/wiki/Environment_variable#APPDATA environment variable] to avoid referring to the username. (We've chosen to use the username environment variable in the documentation for Windows rather than '''''<~username>''''' used for documenting other OSes.) Although Gramps will not recognize environment variables for paths internally, you can use them within Windows to find Gramps user files. The path above can be simplified to:
%LocalAppData%\gramps
{{man note|User Directory relocated {{new|5.2.0}}|'''The User Directory has relocated in version 5.2''' The default '''User Directory''' location for the 5.2 version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Local\gramps</code>  <code> %LocalAppData%\gramps</code> The default '''User Directory''' location for any 5.1.x and earlier version of Gramps user data on a Windows 7 (and newer) system is:  <code> C:\Users\'''''%username%'''''\AppData\Roaming\gramps</code>  <code> %AppData%\gramps</code>}}
<hr />
Like the '''User Directory''', the location for programs/applications is also hidden from browsing with Windows Explorer.

The default location for an installation on a Windows 7 (and newer) system is
C:\Program Files\GrampsAIO64-5.X.X
{{-}}

== See Also ==
* [[Gramps_5.2_Wiki_Manual_-_Command_Line|Command Line]] Configuration (config) option with [[Gramps_5.2_Wiki_Manual_-_Command_Line#Environment_variables|Environment Variables]]
* [https://winaero.com/how-to-enter-file-location-manually-in-gtk-3-opensave-dialog/ Switching from Breadcrumbs to a location text box] using {{Man key press|Crtl|L}} in GTK file dialogs
* Discourse forum threads :
** [https://gramps.discourse.group/t/how-to-set-the-base-path-from-media-relative-to-grampshome/481/2 how to use Environment Variables in Gramps]
** [https://gramps.discourse.group/t/manually-installing-addons/5696/5 Using Python Eval gramplet to list the Plugins folder path]
** [https://gramps.discourse.group/t/troubleshooting-gramps-paths-and-environmental-variables/5692 Troubleshooting Gramps paths and environmental variables] with the [[Gramps_5.2_Wiki_Manual_-_Gramplets#Python_Evaluation|Python Evaluation]] gramplet

*{{man index|Gramps_5.2_Wiki_Manual_-_Command_Line|Gramps 5.2 Wiki Manual - Error and Warning Reference|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_User_Directory}}
{{grampsmanualcopyright}}
[[Category:Documentation|U]]

Gramps 5.2 Wiki Manual - Settings

2024-09-08T15:10:01Z

DaveSchweisguth: /* Database Location */ Add new Linux and macOS-built-from-source locations, remove incorrect macOS-bullt-from-source location

{{man index|Gramps 5.2 Wiki Manual - Tools|Gramps 5.2 Wiki Manual - Filters|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_Settings}}
{{#vardefine:chapter|15}}
{{#vardefine:figure|0}}
This section deals with various settings you can manage within Gramps.

== Preferences ==
[[File:EditPreferencesTabsOnly-overview-52.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all 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...}}.

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_5.2_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_5.2_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

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

Also ''other'' additional tabs maybe shown from any [[5.2_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== Data ===
[[File:EditPreferences-Data-tab-default-52.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_5.2_Wiki_Manual_-_Settings#Display_Options|Display Options]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Input_Options|Input Options]]}}
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-52.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_5.2_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]}}
*{{man label|Coordinates format:}} This option controls the display of Coordinates. (See [[Gramps_5.2_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", "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_5.2_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=Note|2=Besides this database-wide setting Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_5.2_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}} {{new|5.1}}
*{{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.}} {{new|5.1}}

*{{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_5.2_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}} {{new|5.2.0}}

*{{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. {{new|5.2.0}}

===== Place Format Editor =====
{{man note|See|[[Hierarchical Place Structure]]}}
[[File:EditPreferences-Data-tab-Display-section-PlaceFormatEditor-dialog-default-52.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" section]]

Accessed from the Edit > Data tab [[Gramps_5.2_Wiki_Manual_-_Settings#Display_Options|Display Options]] section "Automate Place Format" option.

This tab contains preferences relevant to how Places should be shown.

*{{man label|Name:}} A unique name for the place format.
*{{man label|Levels:}} 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:}} "None" (default), "Number Street" or "Street Number". Option to concatenate the number and street in order to suppress the comma. For this option to work, the street must have the [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''']] ''Street'' and house number must have the '''Type''' ''Number''.
*{{man label|Language:}} (Empty by Default) A two-digit language code.
*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)

See also:
* [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor dialog]]
* [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name Editor dialog]]
{{-}}
{{stub}}

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

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

[[File:EditPreferences-Data-tab-DisplayOptions-section-DisplayNameEditor-dialog-default-52.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 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
* 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
* Familynick - family nick name
* Rest - non primary surnames
* Rawsurnames- surnames (no prefixes and connectors)
* Surname - surnames (with prefix and connectors)
* Suffix - suffix (Jr., Sr.)
* Nickname - nick name
* Common - nick name, otherwise first of Given
* Prefix - all prefixes (von, de)
* Notpatronymic- all surnames, except pa/matronymic & primary

{{man menu|UPPERCASE versions of these keywords forces uppercase to be displayed.}} Extra parentheses, commas are removed. Other text appears literally.

[[File:NameEditor-format_reference_example-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor - reference person]]

'''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>.

All the fields in the Example 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 & Display controls, Date range controls for using a particular name.

{{stub}}

{{-}}

==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-52.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. The default {{man label|Father's surname}} will use the family name of the father. Selecting {{man label|None}} means that no surname guessing will be attempted. Selecting {{man label|Combination of mother's and father's surname}} will use the father's name followed by the mother's name. Finally, {{man label|[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_5.2_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_5.2_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_culture Category:Names by culture], From Wikipedia, the free encyclopedia}}

*{{man label|Default family relationship:}}
** '''Unknown'''(default)
** Married
** Unmarried
** Civil Union

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

=== General ===
[[File:EditPreferences-General-tab-EnviromentSettings-section-default-52.png|Right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} General Preferences - Enviroment 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_5.2_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 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 spelling checker}}: This checkbox option controls the enabling and disabling of the spelling checker for notes. The '''gtkspell''' package must be loaded for this to have an effect. ( See: [[Troubleshoot Spellcheck]] )

*{{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_5.2_Wiki_Manual_-_Main_Window#Navigator|Navigator]] in the [[Gramps_5.2_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}}

*{{checkbox|0}}{{man label|Show close button in gramplet bar tabs}} ''unchecked''(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:'''150''' 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-WhatsThatFor-52.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog]]

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 ===
{{stub}}
[[File:EditPreferences-FamilyTree-tab-default-52.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_5.2_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Database_Location|Database Location]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}}

See also:
* [[Gramps_5.2_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
* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds support for PostgreSQL databases.

====Database Settings====
*{{man label|Database backend:}} -
** '''[[Gramps_Glossary#sqlite|SQLite]]''' (''default'') - the [[DB-API Database Backend]]
** ... If other database backends addons are installed, they will be added to the list <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>: [[Addon:PostgreSQL|PostgreSQL]] backend

The ''[[Gramps_Glossary#bsddb|BSDDB]]'' - Legacy Database backend was superseded in the Gramps 5.1 version.

====Database Location====
*{{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|Family Tree Database path:}} Unless you have a definite reason to change this, stay with the default path. This path will be within the [[Gramps_5.2_Wiki_Manual_-_User_Directory|User Directory]] of the local machine's Operating Systems. The default path where the databases are stored is
:: Linux: <code>/home/</code>'''''<username>'''''<code>/.local/share/gramps/grampsdb</code>'''
:: macOS (both the application package and built from source): <code>/Users/</code>'''''<username>'''''<code>/.local/share/gramps/grampsdb</code>'''
:: Windows: <code>C:\Users\</code>'''''<username>'''''<code>\AppData\Local\gramps\grampsdb</code>'''
: In Gramps 5.1 and earlier, the default path where the databases were stored was
:: Linux: <code>/home/</code>'''''<username>'''''<code>/.gramps/grampsdb</code>'''
:: macOS application package: <code>/Users/</code>'''''<username>'''''<code>/Library/Application Support/gramps/grampsdb</code>'''
:: macOS built from source: <code>/Users/</code>'''''<username>'''''<code>/.gramps/grampsdb</code>'''
:: Windows: <code>C:\Users\</code>'''''<username>'''''<code>\AppData\Roaming\gramps\grampsdb</code>'''
: If Gramps 5.2 and later detects a database directory in the old location, it will use that directory and not create one in the new location.

====Backup Management====
*{{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 {{new|5.2.0}}
** Every day {{new|5.2.0}}
{{-}}

====Family Tree's Media path====
*{{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_5.2_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_5.2_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_5.2_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_5.2_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_5.2_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}

=====Select media directory dialog=====

{{stub}}

See [[Gramps_5.2_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}

=====Missing Media Objects 'broken link' icon of a box with a red 'x'=====
{{stub}}
[[File:Broken Media Path.png|right|350px|thumb|Fig. {{#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_5.2_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section.
{{-}}

=== Import ===
[[File:EditPreferences-Import-tab-default-52.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:

==== Tag Records ====

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

==== Source GEDCOM import ====

*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_5.2_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.'''

{{-}}

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

Settings used for calculation operations.

See also:
* [[Gramps 5.2 Wiki Manual - Probably Alive]]
* [[Gramps_5.2_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_5.2_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
{{-}}

=== Colors ===
{{stub}}
[[File:EditPreferences-Colors-tab-default-52.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - UK/Australian dialect 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 [[Gramps_5.2_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) or ''Dark colors''
** {{man button|Restore to defaults}} - restores themes default colors.

====Colors for Male persons====
* Background for Alive: [ ] #b8cee6
* Border for Alive: [ ] #1f4986
* Background for Dead: [ ] #b8cee6
* Border for Dead: [ ] #000000

====Colors for Female persons====
* Background for Alive: [ ] #feccf0
* Border for Alive: [ ] #861f69
* Background for Dead: [ ] #feccf0
* Border for Dead: [ ] #000000

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

====Colors for Unknown persons====
* Background for Alive: [ ] #f3dbb6
* Border for Alive: [ ] #8e5801
* Background for Dead: [ ] #f3dbb6
* Border for Dead: [ ] #000000

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

====Other colors====
* 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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences 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 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_5.2_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_5.2_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-52.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_5.2_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}

=== Text ===

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

This tab contains preferences relevant to how missing and private names and records should be shown.

*{{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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]

This tab controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.

*{{checkbox|1}}{{man label|Suppress warning when adding parents to a child.}} Checkbox checked by Default (See [[Gramps_5.2_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_5.2_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_5.2_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 {{new|5.2.0}}
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])

See the [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
{{-}}

=== 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-52.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 [[Gramps_5.2_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information]] tool.
{{-}}

== Other settings ==

Besides {{man label|Preferences}} dialog, there are other settings available in Gramps. For various reasons they have been made more readily accessible, as listed below.
{{-}}
===Column Editor===

{{man tip|1=Column Editor|2=The {{man label|Column 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:ConfigureTheActiveView-icon-on-toolbar-51.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Selecting the {{man button|Configure View...}} button]]

[[File:ColumnEditor-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Column Editor - Dialog - People default]]

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

To use the {{man label|Column Editor }} dialog for the current view, 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_5.2_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 Column Editor], so changing which field is in that position affects default sorting.

[[File:ConfigurePersonView-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Column Editor - Dialog - People example]]The {{man label|Column 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_5.2_Wiki_Manual_-_Filters|filters]] will also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_5.2_Wiki_Manual_-_Settings#Export_View|Export View...]]}} operation. Hidden columns and records will not be exported.
{{-}}

=== Sorting columns ===

[[File:PeopleCategory-PeopleListView-SortedByBirthDateColumn-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 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_5.2_Wiki_Manual_-_Settings#Column_Editor|Column 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-50.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_5.2_Wiki_Manual_-_Settings#General_Gramps_settings|General]] setting in [[Gramps_5.2_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_5.2_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 Pedigree Category. [[File:Gramps Go-Home48x48 win.png|text-bottom]]
====See also====
* [[Gramps_5.2_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 Pedigree and Relationships Views) are displayed in the main window is adjusted through the View menu.

In the different views clicking the {{man menu|[[Gramps_5.2_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_5.2_Wiki_Manual_-_Settings#Column_Editor|column editor]].

===Export View===

[[File:Menubar-FamilyTrees-overview-example-50.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_5.2_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_5.2_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_5.2_Wiki_Manual_-_Filters|filters]] you have applied.
{{-}}
====Export View as Spreadsheet dialog====

[[File:ExportViewAsSpreadsheet-CSV-file-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Export View as Spreadsheet" CSV(default) file-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:
* '''CSV''' (default)
* '''OpenDocument Spreadsheet''' - ODS format.

{{-}}
[[File:ExportViewAsSpreadsheet-exampleODS-Displayed-in-LibreOfficeCalc-50.png|right|thumb|400px|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.

{{-}}

===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 [[5.2_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_5.2_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[5.2 Addons|Third-Party Addons]].
{{-}}

===Customize report output formats===
[[File:TextReports-DocumentOptions-PlainText-output-settings-50.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_5.2_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_5.2_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_5.2_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_5.2_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}

====Style editor dialog====

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|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_5.2_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report]]}} shows the style options for AHN-Entry, AHN-Generation and AHN-Title.

On the right hand side are three tabs associated with each style listed in the left hand column:
{{-}}
======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) (Gramps 4.2.0 Windows 7) ]]

*{{man label|Description}} : The description describes what each paragraph is all about. For example shown here is the style used for the Ahnentafel Report ( AHN-Entry ).
{{-}}

======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}} : Here you can set the {{man label|Type face}} Roman or Swiss, the {{man label|Size}} of the font in pt., 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}} : Here you 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===
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]

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

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

The Display tab of the Preferences allows selection of the Name format used by default throughout Gramps. The Edit button for the {{man label|Name format:}} opens the {{man label|[[Gramps_5.2_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_5.2_Wiki_Manual_-_Settings#Preferences|Preferences]]

The Edit button for a person's preferred and alternative names opens the {{man label|[[Gramps_5.2_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_5.2_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_5.2_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 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.

====Context Menu options====
Right-click on any file or folder in the current directory to open context pop-up menu with the following options:
* Open With File Manager
* Copy Location
* [[Gramps_5.2_Wiki_Manual_-_Settings#Bookmarking_file_folders|Add to Bookmarks]]
* ❏ Show Hidden Files
* ☑ Show Size Column
* ☑ Show Type Column
* ❏ Show Time
* ❏ Sort Folders before Files

Right-click in the navigation sidebar to open context pop-up menu with the following options:
* Open
* Remove
* Rename...
====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_5.2_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]

=== 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-5.2.3^" 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:Microsoft Window Gramps AIO Installer Choose Components-Selection-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]
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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for shortcut example.]]

To make Gramps work in your selected language (See table below for your [[Gramps_5.2_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:
* Using your mouse right button click on the "{{man label|GrampsAIO64 5.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 5.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 5.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-5.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 5.2 Language icons Shortcuts Pack ( for the 18 languages shown in the Language 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"
|
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|}
*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].

===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 2023/09/13 14:17:45

[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0
;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps52', True]]
;;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps52'
;;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=0
;;web-search-url='http://google.com/#&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=0
;;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
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-text=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
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-default'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;default-source=0
;;eprefix='E%04d'
;;family-relation-type=3
;;family-warn=1
;;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/gramps52/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 5.2 :
~/.gramps/gramps52/gramps.ini

See also:
* [[Gramps_5.2_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog]]
* [[Gramps_5.2_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:Themes]]
* [[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 5.2 Wiki Manual - Tools|Gramps 5.2 Wiki Manual - Filters|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_Settings}}
{{grampsmanualcopyright}}

[[Category:Documentation]]

User:DaveSchweisguth

2024-09-08T14:53:55Z

DaveSchweisguth:

I live in San Francisco. I've been a programmer since the 1970s and a genealogist since the 1990s. For more, please see [[https://schweisguth.org/~dave/ my personal page]] and [[https://schweisguth.org/~dave/genealogy.html the page about my genealogical research]] to which it links.

User:DaveSchweisguth

2024-09-08T14:50:21Z

DaveSchweisguth: Create

I've been a programmer since the 1970s and a genealogist since the 1990s. For more, please see [[https://schweisguth.org/~dave/ my personal page]] and [[https://schweisguth.org/~dave/genealogy.html the page about my genealogical research]] to which it links.

Gramps 5.2 Wiki Manual - Settings

2024-09-08T13:02:27Z

DaveSchweisguth: /* Database Location */ Documented new location of database in macOS app package and fallback to old locations

{{man index|Gramps 5.2 Wiki Manual - Tools|Gramps 5.2 Wiki Manual - Filters|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_Settings}}
{{#vardefine:chapter|15}}
{{#vardefine:figure|0}}
This section deals with various settings you can manage within Gramps.

== Preferences ==
[[File:EditPreferencesTabsOnly-overview-52.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Overview of all 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...}}.

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_5.2_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_5.2_Wiki_Manual_-_Keybindings#Common_keybindings|keyboard keybinding]].

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

Also ''other'' additional tabs maybe shown from any [[5.2_Addons#Addon_List|addons]] you may have installed.
{{-}}
=== Data ===
[[File:EditPreferences-Data-tab-default-52.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_5.2_Wiki_Manual_-_Settings#Display_Options|Display Options]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Input_Options|Input Options]]}}
{{-}}
==== Display Options ====
[[File:EditPreferences-Data-tab-DisplayOptions-section-default-52.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_5.2_Wiki_Manual_-_Settings#Place_Format_Editor|Place Format Editor]]}}
*{{man label|Coordinates format:}} This option controls the display of Coordinates. (See [[Gramps_5.2_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", "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_5.2_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=Note|2=Besides this database-wide setting Gramps allows you to decide the name display format individually for every single name via the {{man label|[[Gramps_5.2_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}} {{new|5.1}}
*{{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.}} {{new|5.1}}

*{{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_5.2_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}} {{new|5.2.0}}

*{{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. {{new|5.2.0}}

===== Place Format Editor =====
{{man note|See|[[Hierarchical Place Structure]]}}
[[File:EditPreferences-Data-tab-Display-section-PlaceFormatEditor-dialog-default-52.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" section]]

Accessed from the Edit > Data tab [[Gramps_5.2_Wiki_Manual_-_Settings#Display_Options|Display Options]] section "Automate Place Format" option.

This tab contains preferences relevant to how Places should be shown.

*{{man label|Name:}} A unique name for the place format.
*{{man label|Levels:}} 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:}} "None" (default), "Number Street" or "Street Number". Option to concatenate the number and street in order to suppress the comma. For this option to work, the street must have the [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|'''Type''']] ''Street'' and house number must have the '''Type''' ''Number''.
*{{man label|Language:}} (Empty by Default) A two-digit language code.
*{{checkbox|0}} {{man label|Reverse display order}} (checkbox unchecked by default)

See also:
* [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor dialog]]
* [[Gramps_5.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name Editor dialog]]
{{-}}
{{stub}}

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

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

[[File:EditPreferences-Data-tab-DisplayOptions-section-DisplayNameEditor-dialog-default-52.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 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
* 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
* Familynick - family nick name
* Rest - non primary surnames
* Rawsurnames- surnames (no prefixes and connectors)
* Surname - surnames (with prefix and connectors)
* Suffix - suffix (Jr., Sr.)
* Nickname - nick name
* Common - nick name, otherwise first of Given
* Prefix - all prefixes (von, de)
* Notpatronymic- all surnames, except pa/matronymic & primary

{{man menu|UPPERCASE versions of these keywords forces uppercase to be displayed.}} Extra parentheses, commas are removed. Other text appears literally.

[[File:NameEditor-format_reference_example-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Display Name Editor - reference person]]

'''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>.

All the fields in the Example 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 & Display controls, Date range controls for using a particular name.

{{stub}}

{{-}}

==== Input Options ====
[[File:EditPreferences-Data-tab-InputOptions-section-default-52.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. The default {{man label|Father's surname}} will use the family name of the father. Selecting {{man label|None}} means that no surname guessing will be attempted. Selecting {{man label|Combination of mother's and father's surname}} will use the father's name followed by the mother's name. Finally, {{man label|[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_5.2_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_5.2_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_culture Category:Names by culture], From Wikipedia, the free encyclopedia}}

*{{man label|Default family relationship:}}
** '''Unknown'''(default)
** Married
** Unmarried
** Civil Union

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

=== General ===
[[File:EditPreferences-General-tab-EnviromentSettings-section-default-52.png|Right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} General Preferences - Enviroment 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_5.2_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 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 spelling checker}}: This checkbox option controls the enabling and disabling of the spelling checker for notes. The '''gtkspell''' package must be loaded for this to have an effect. ( See: [[Troubleshoot Spellcheck]] )

*{{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_5.2_Wiki_Manual_-_Main_Window#Navigator|Navigator]] in the [[Gramps_5.2_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}}

*{{checkbox|0}}{{man label|Show close button in gramplet bar tabs}} ''unchecked''(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:'''150''' 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-WhatsThatFor-52.png|Right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Tip of the Day dialog]]

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 ===
{{stub}}
[[File:EditPreferences-FamilyTree-tab-default-52.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_5.2_Wiki_Manual_-_Settings#Database_Settings|Database Settings]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Database_Location|Database Location]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Backup_Management|Backup Management]]}}
*{{man label|[[Gramps_5.2_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}}

See also:
* [[Gramps_5.2_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
* Addon [[Addon:PostgreSQL|PostgreSQL]] - this adds support for PostgreSQL databases.

====Database Settings====
*{{man label|Database backend:}} -
** '''[[Gramps_Glossary#sqlite|SQLite]]''' (''default'') - the [[DB-API Database Backend]]
** ... If other database backends addons are installed, they will be added to the list <abbr title="exempli gratia - Latin phrase meaning 'for example'">e.g.</abbr>: [[Addon:PostgreSQL|PostgreSQL]] backend

The ''[[Gramps_Glossary#bsddb|BSDDB]]'' - Legacy Database backend was superseded in the Gramps 5.1 version.

====Database Location====
*{{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|Family Tree Database path:}} Unless you have a definite reason to change this, stay with the default path. This path will be within the [[Gramps_5.2_Wiki_Manual_-_User_Directory|User Directory]] of the local machine's Operating Systems. The default path where the databases are stored is
:: Linux: <code>/home/</code>'''''<username>'''''<code>/.gramps/grampsdb</code>''' (might have changed in this version as did other OSes)
:: macOS application package: <code>/Users/</code>'''''<username>'''''<code>/.local/share/gramps/grampsdb</code>'''
:: macOS built from source: <code>/Users/</code>'''''<username>'''''<code>/.gramps/grampsdb</code>''' (might have changed in this version as did other OSes)
:: Windows: <code>C:\Users\</code>'''''<username>'''''<code>\AppData\Local\gramps\grampsdb</code>'''
: In Gramps 5.1 and earlier, the default path where the databases were stored was
:: Linux, macOS built from source: <code>/home/</code>'''''<username>'''''<code>/.gramps/grampsdb</code>'''
:: macOS application package: <code>/Users/</code>'''''<username>'''''<code>/Library/Application Support/gramps/grampsdb</code>'''
:: macOS built from source: <code>/Users/</code>'''''<username>'''''<code>/.gramps/grampsdb</code>'''
:: Windows: <code>C:\Users\</code>'''''<username>'''''<code>\AppData\Roaming\gramps\grampsdb</code>'''
: If Gramps 5.2 and later detects a database directory in the old location, it will use that directory and not create one in the new location.

====Backup Management====
*{{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 {{new|5.2.0}}
** Every day {{new|5.2.0}}
{{-}}

====Family Tree's Media path====
*{{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_5.2_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_5.2_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_5.2_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_5.2_Wiki_Manual_-_Tools#Convert_paths_from_relative_to_absolute|Convert paths from relative to absolute]]}}
** {{man label|[[Gramps_5.2_Wiki_Manual_-_Tools#Convert_paths_from_absolute_to_relative|Convert paths from absolute to relative]]}}

=====Select media directory dialog=====

{{stub}}

See [[Gramps_5.2_Wiki_Manual_-_Settings#File_Chooser]]
{{-}}

=====Missing Media Objects 'broken link' icon of a box with a red 'x'=====
{{stub}}
[[File:Broken Media Path.png|right|350px|thumb|Fig. {{#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_5.2_Wiki_Manual_-_Settings#Family_Tree.27s_Media_path|Family Tree's Media path]]}} section.
{{-}}

=== Import ===
[[File:EditPreferences-Import-tab-default-52.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:

==== Tag Records ====

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

==== Source GEDCOM import ====

*{{checkbox|0}}{{man label|Add default source on GEDCOM import}}: This checkbox option affects the importing of [[Gramps_5.2_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.'''

{{-}}

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

Settings used for calculation operations.

See also:
* [[Gramps 5.2 Wiki Manual - Probably Alive]]
* [[Gramps_5.2_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_5.2_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
{{-}}

=== Colors ===
{{stub}}
[[File:EditPreferences-Colors-tab-default-52.png|right|thumb|650px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Colors" - tab - UK/Australian dialect 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 [[Gramps_5.2_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) or ''Dark colors''
** {{man button|Restore to defaults}} - restores themes default colors.

====Colors for Male persons====
* Background for Alive: [ ] #b8cee6
* Border for Alive: [ ] #1f4986
* Background for Dead: [ ] #b8cee6
* Border for Dead: [ ] #000000

====Colors for Female persons====
* Background for Alive: [ ] #feccf0
* Border for Alive: [ ] #861f69
* Background for Dead: [ ] #feccf0
* Border for Dead: [ ] #000000

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

====Colors for Unknown persons====
* Background for Alive: [ ] #f3dbb6
* Border for Alive: [ ] #8e5801
* Background for Dead: [ ] #f3dbb6
* Border for Dead: [ ] #000000

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

====Other colors====
* 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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences 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 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_5.2_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_5.2_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-52.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_5.2_Wiki_Manual_-_Tools#Reorder_Gramps_ID|Reorder Gramps ID]] tool to change the format.
{{-}}

=== Text ===

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

This tab contains preferences relevant to how missing and private names and records should be shown.

*{{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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Menu: "Edit>Preferences..." - "Warnings" - tab - defaults]]

This tab controls the display of warning dialogs, allowing the re-enabling of dialogs that have been disabled.

*{{checkbox|1}}{{man label|Suppress warning when adding parents to a child.}} Checkbox checked by Default (See [[Gramps_5.2_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_5.2_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_5.2_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 {{new|5.2.0}}
*{{checkbox|0}}{{man label|Show plugin status dialog on plugin load error.}} Checkbox unchecked by Default (See [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference#Module_not_loaded_warnings|Dialog]])

See the [[Gramps_5.2_Wiki_Manual_-_Error_and_Warning_Reference|Error and Warning Reference]] page for examples.
{{-}}

=== 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-52.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 [[Gramps_5.2_Wiki_Manual_-_Tools#Edit_Database_Owner_Information|Edit Database Owner Information]] tool.
{{-}}

== Other settings ==

Besides {{man label|Preferences}} dialog, there are other settings available in Gramps. For various reasons they have been made more readily accessible, as listed below.
{{-}}
===Column Editor===

{{man tip|1=Column Editor|2=The {{man label|Column 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:ConfigureTheActiveView-icon-on-toolbar-51.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Selecting the {{man button|Configure View...}} button]]

[[File:ColumnEditor-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Column Editor - Dialog - People default]]

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

To use the {{man label|Column Editor }} dialog for the current view, 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_5.2_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 Column Editor], so changing which field is in that position affects default sorting.

[[File:ConfigurePersonView-51.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Column Editor - Dialog - People example]]The {{man label|Column 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_5.2_Wiki_Manual_-_Filters|filters]] will also constrain the data exported via the {{Man menu|Family Trees ➡ [[Gramps_5.2_Wiki_Manual_-_Settings#Export_View|Export View...]]}} operation. Hidden columns and records will not be exported.
{{-}}

=== Sorting columns ===

[[File:PeopleCategory-PeopleListView-SortedByBirthDateColumn-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} 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_5.2_Wiki_Manual_-_Settings#Column_Editor|Column 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-50.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_5.2_Wiki_Manual_-_Settings#General_Gramps_settings|General]] setting in [[Gramps_5.2_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_5.2_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 Pedigree Category. [[File:Gramps Go-Home48x48 win.png|text-bottom]]
====See also====
* [[Gramps_5.2_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 Pedigree and Relationships Views) are displayed in the main window is adjusted through the View menu.

In the different views clicking the {{man menu|[[Gramps_5.2_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_5.2_Wiki_Manual_-_Settings#Column_Editor|column editor]].

===Export View===

[[File:Menubar-FamilyTrees-overview-example-50.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_5.2_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_5.2_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_5.2_Wiki_Manual_-_Filters|filters]] you have applied.
{{-}}
====Export View as Spreadsheet dialog====

[[File:ExportViewAsSpreadsheet-CSV-file-dialog-example-50.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Export View as Spreadsheet" CSV(default) file-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:
* '''CSV''' (default)
* '''OpenDocument Spreadsheet''' - ODS format.

{{-}}
[[File:ExportViewAsSpreadsheet-exampleODS-Displayed-in-LibreOfficeCalc-50.png|right|thumb|400px|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.

{{-}}

===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 [[5.2_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_5.2_Wiki_Manual_-_Plugin_Manager|Plugin Manager]] and [[5.2 Addons|Third-Party Addons]].
{{-}}

===Customize report output formats===
[[File:TextReports-DocumentOptions-PlainText-output-settings-50.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_5.2_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_5.2_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_5.2_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_5.2_Wiki_Manual_-_Settings#Style_editor_dialog|Style editor]]}} dialog.
{{-}}

====Style editor dialog====

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|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_5.2_Wiki_Manual_-_Reports_-_part_6#Ahnentafel_Report|Ahnentafel Report]]}} shows the style options for AHN-Entry, AHN-Generation and AHN-Title.

On the right hand side are three tabs associated with each style listed in the left hand column:
{{-}}
======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) (Gramps 4.2.0 Windows 7) ]]

*{{man label|Description}} : The description describes what each paragraph is all about. For example shown here is the style used for the Ahnentafel Report ( AHN-Entry ).
{{-}}

======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}} : Here you can set the {{man label|Type face}} Roman or Swiss, the {{man label|Size}} of the font in pt., 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}} : Here you 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===
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]

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

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

The Display tab of the Preferences allows selection of the Name format used by default throughout Gramps. The Edit button for the {{man label|Name format:}} opens the {{man label|[[Gramps_5.2_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_5.2_Wiki_Manual_-_Settings#Preferences|Preferences]]

The Edit button for a person's preferred and alternative names opens the {{man label|[[Gramps_5.2_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_5.2_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_5.2_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 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.

====Context Menu options====
Right-click on any file or folder in the current directory to open context pop-up menu with the following options:
* Open With File Manager
* Copy Location
* [[Gramps_5.2_Wiki_Manual_-_Settings#Bookmarking_file_folders|Add to Bookmarks]]
* ❏ Show Hidden Files
* ☑ Show Size Column
* ☑ Show Type Column
* ❏ Show Time
* ❏ Sort Folders before Files

Right-click in the navigation sidebar to open context pop-up menu with the following options:
* Open
* Remove
* Rename...
====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_5.2_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]

=== 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-5.2.3^" 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:Microsoft Window Gramps AIO Installer Choose Components-Selection-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]
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-52.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Edit-Target-GrampsAIO64-Properties for shortcut example.]]

To make Gramps work in your selected language (See table below for your [[Gramps_5.2_Wiki_Manual_-_Settings#Language_codes|language code]]), complete the following:
* Using your mouse right button click on the "{{man label|GrampsAIO64 5.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 5.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 5.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-5.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 5.2 Language icons Shortcuts Pack ( for the 18 languages shown in the Language 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"
|
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|}
*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].

===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 2023/09/13 14:17:45

[behavior]
;;addmedia-image-dir=''
;;addmedia-relative-path=0
;;addons-allow-install=0
;;addons-projects=[['Gramps', 'https://raw.githubusercontent.com/gramps-project/addons/master/gramps52', True]]
;;addons-url='https://raw.githubusercontent.com/gramps-project/addons/master/gramps52'
;;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=0
;;web-search-url='http://google.com/#&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=0
;;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
;;toolbar-addons=1
;;toolbar-clipboard=1
;;toolbar-on=1
;;toolbar-preference=1
;;toolbar-reports=1
;;toolbar-text=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
;;calendar-format-input=0
;;calendar-format-report=0
;;cite-plugin='cite-default'
;;coord-format=0
;;cprefix='C%04d'
;;date-format=0
;;default-source=0
;;eprefix='E%04d'
;;family-relation-type=3
;;family-warn=1
;;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/gramps52/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 5.2 :
~/.gramps/gramps52/gramps.ini

See also:
* [[Gramps_5.2_Wiki_Manual_-_Manage_Family_Trees#Backup_dialog]]
* [[Gramps_5.2_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:Themes]]
* [[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 5.2 Wiki Manual - Tools|Gramps 5.2 Wiki Manual - Filters|5.2}}
{{languages|Gramps_5.2_Wiki_Manual_-_Settings}}
{{grampsmanualcopyright}}

[[Category:Documentation]]