Gramps 3.1 Wiki Manual - Main Window

From Gramps
Revision as of 18:46, 8 July 2009 by Erikdr (talk | contribs) (HTML View (optional))
Jump to: navigation, search
Gnome-important.png Special copyright notice: All edits to this page need to be under two different copyright licenses:

These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: []), not via internal links.
Also, only use the known Typographical conventions

Previous Index Next


Fig. 2.1 GRAMPS Main Window

When you open a database (either existing or new), the following window is displayed:

The main GRAMPS window contains the following elements:

  • Menubar: The menubar is located at the very top of the window (right below the window title) and provides access to all the features of GRAMPS.
  • Toolbar: The toolbar is located right below the menubar. It gives you access to the most frequently used functions of GRAMPS. You can set options that control how it appears by going to Edit ->Preferences . You can also hide it entirely by going to View ->Toolbar.
  • Progress Bar: The Progress Bar is located in the lower left corner of the GRAMPS window. It displays the progress of time consuming operations, such as opening and saving large databases, importing and exporting to other formats, generating web sites, etc. When you are not doing these types of operations, the Progress Bar is not shown.
  • Status Bar: The Status Bar is located to the right of the Progress Bar, on the very bottom of the GRAMPS window. It displays information about current GRAMPS activity and contextual information about the selected items.
  • Display area: The largest area in the center of the GRAMPS window is the display area. What it displays depends on the currently selected View. We'll discuss Views in detail below.

The Different Views

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 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 Views, listed below:

  • Gramplet View: Displays different Gramplets, small widgets that can help in your genealogical research.
  • People View: Displays the list of people in the family tree
  • Relationships View: Shows the relationships between the Active Person and other people. This includes parents, spouses, and children
  • Family List View: Shows the list of families in the family tree
  • Pedigree View: Displays a graphical ancestor tree for the selected person
  • Events View: Displays the list of events in the family tree
  • Sources View: Displays the list of sources in the family tree
  • Places View: Displays the list of places in the family tree
  • Media View: Displays the list of media objects in the family tree
  • Repositories View: Displays the list of repositories in the family tree
  • Notes View: Displays the list of notes in the family tree.

Before we launch into a description of each View, let's first explain how to switch between Views.

Switching Views and Viewing Modes

Fig. 2.2 Sidebar view mode
Fig. 2.3 Tabbed Viewing Mode

As mentioned above there are 11 different Views. In addition, there are two different Viewing Modes. You can tell at a glance which Viewing Mode you are in: If you see icons listed vertically in a sidebar at the left of the window, you are in the Sidebar Viewing Mode.

If instead you see a series of "notebook tabs" (People, Relationships, Family List, Pedigree, Events, Sources, Places, Media, Repositories, Notes and optional Gramplets and HTML) that run horizontally across the window, then you are in the Tabbed Viewing Mode. You can switch from one Viewing Mode to another by selecting View ->Sidebar from the Sidebar menu item.

If you're in the Sidebar Viewing Mode, you can select the View you want by clicking one of the sidebar icons.

If you're in the Tabbed Viewing Mode, you can select the View you want by clicking the corresponding notebook tab.

Gramplets View

Fig.2.4 Gramplets view

The Gramplets view shows a number of widgets, called Gramplets, that can help you in your research. Two Gramplets are shown on start-up (the Welcome and Top Surname Gramplets), but by right-clicking on the view, a popup comes up with the possibility of adding other Gramplets.

  • Age on Date Gramplet - see the people alive and their ages on a particular date
  • Age Stats Gramplet - see age span graphs
  • Attributes Gramplets - see active person's attributes
  • Calendar Gramplet - see people's events on a particular date, or in a month in the past
  • Descendants Gramplet - see the active person's descendants
  • Fan Chart Gramplet - see the active person's pedigree, in a circular fan chart
  • Given Name Cloud Gramplet - most popular given names
  • Pedigree Gramplet - see a complete pedigree in compressed text
  • Quick View - run a Quick View on the current person
  • Records Gramplet - see world's records of your data
  • Relatives Gramplet - see the relatives of the active person
  • Session Log Gramplet - keep track of what you have done, and what records you have visted
  • Statistics Gramplet - see stats on the database
  • Surname Cloud Gramplet - most popular surnames as a "text cloud"
  • TODO Gramplet - a notepad to keep tabs on your research
  • Top Surnames Gramplet - top 10 most popular surnames
  • Welcome Gramplet - a GRAMPS welcome message
  • What's Next Gramplet - what needs to be done next

In addition, there are a number of additional Gramplets that you can easily install and use. These include:

  • Headline News Gramplet - current, breaking news from GRAMPS
  • Data Entry Gramplet - edit active person's name, birth date and place, death date and place, and add people
  • Python Gramplet - a Python shell
  • FAQ Gramplet - frequently asked questions
  • Note Gramplet - see and edit active person's primary Person Note

and many others. See Third-party Plugins for more details.

For more detailed information on using the installed Gramplets, see Gramplets.

People View

Fig. 2.5 Column Editor Dialog

The People View lists the people stored in the database. You'll note that people are grouped according to their family names. To the left of each family name is typically either an arrow or some other type of indicator. 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.

By default, the People View, displays several columns of information about each person. You can add or remove columns to and from the display by calling up the Column Editor dialog (Edit ->Column Editor) and checking or unchecking the boxes listed. You can also change the position of a column in People View by clicking and dragging it to a new position in the Editor (drag and drop). Once you have made the changes you want, click OK to exit the Editor and see your changes in the People View.

Column Editor

The Column Editor is available in all Views and works the same way in each.

Fig. 2.6 Filter Controls Displayed


Genealogical databases can contain information on many people, families, places, and objects. It's therefore possible for a View to contain a long list of data that's difficult to work with. GRAMPS gives you two different means for controlling this condition by allowing you to filter a list to a more manageable size.

These methods are Search and Filtering.

A search will search the text displayed in list, whereas filters display people whose data match the criteria of the filter. Search is a simple but fast method of searching the columns displayed on the screen. Typing the characters into the Search box and clicking the Find button will display only lines that match the text.

Alternatively, you can enable the Filter sidebar, which will be displayed on the right hand side of the display. When the filter sidebar is displayed, the Search bar is not displayed. The Filter side bar allows you to interactively build a set of filter rules that can be applied to the display. The filter is applied based on the rules and the data, not on the screen display.

Searching vs. Filtering

Searching only searches for exact text matches. If the date displayed is "Jan 1, 2000", a search of "1/1/2000" will fail, but a filter of "1/1/2000" will match.

When GRAMPS opens a database, no filtering is in effect. In People View, for example, all people in the database are listed by default.

Relationships View

The Relationships View displays all the relationships of the Active Person (the selected person). Specifically, it shows his or her parents, siblings, spouses, and children.

The Relationships View 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 hypertext link, similar to a web page.

Fig. 2.7 Relationships View

The Relationships View displays the following sections:

  • Active Person: At the top of the screen, name, ID, birth, and death information, calculated age of the Active Person is displayed. If a photo of the person is available, it is shown on the right hand side. Next to the person's name is a symbol indicating gender, and an Edit button. Clicking the Edit button will allow you to edit all of the person's individual information in an Edit Person dialog.
  • Parents: The next section, 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 can control how much information is displayed by using the View menu. The view menu allows you to show or hide details (the birth and death information) and to show or hide siblings. Next to each person listed is an Edit button, which will allow you to edit all the details of that particular person.

You may add a new set of parents by either selecting the Add Parents or the Share Parents . The Add Parents button will create a new family with the Active Person listed as a child. The Share Parents button will allow you to choose from a list of existing families, and then add the person as a child to that family.

You may edit an existing parents by selecting the Edit button next to the parents. If you select the Delete 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.


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 warning dialog. If you get this dialog, you should probably Cancel the edit, and then use the Select button to select the existing family.

  • Family: Similar to the Parents section is the Family section, which displays families where the Active Person is a parent. Because it is possible to have multiple families, it is possible to have multiple Family sections. Each family section displays the spouse and any children.

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.

Fig. 2.8 Relation reordering

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

Selecting the Edit button next to the spouse will allow you to edit the displayed family. Clicking the Delete button will remove the person from the displayed family.

Remove a person

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.


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.

You can reorder the parents and spouses by selecting the Reorder. 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. Selecting this button will display a dialog that will allow you to reorder the families.

Family View

Fig. 2.9 Family List View

The Family List View displays a list of all families in the database. From this view, you may add, edit, or delete families. The default display lists the ID, Father, Mother, and Relationship. Children cannot be displayed on the screen in this view.

Remove button

Unlike the Relationships View, clicking the 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.

Pedigree View

Fig. 2.10 Pedrigree view

The Pedigree View displays a family tree of the Active Person's ancestors. The Pedigree View shows up to five generations, depending on the size of the window. Each person is indicated by a box labeled with his or her name, birth and death information, and optionally an image if available. Two lines branch from each box. The top one shows the person's father and the bottom one the mother. Solid lines represent birth relations, while dashed lines represent non-birth relations such as adoption, step-parenthood, guardianship, etc.

To the left of the Active Person is a left arrow button. If the Active Person has children, clicking this button expands a list of the Active Person's children. Selecting one of the children makes that child the Active Person.

Fig. 2.11 Children menu

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 is clicked, the Father of the Active Person becomes the Active Person. When the bottom button is clicked, the Mother of the Active Person becomes the Active Person.

Fig. 2.12 Personal context

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

Among other useful items, the context menu has sub-menus listing Spouses , Siblings , Children , and Parents 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.

Events view

New in version 2.2 is the inclusion of an Events View.

Events can be shared between multiple people and multiple families. The Events View lists the all the events recorded in the database.

The default view displays the Description , ID , Type , Date , Place and Cause of the event.

Fig. 2.13 Events view
Meaningful event description

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 if you decide to share events.

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. The Column Editor dialog can be used to add, remove and rearrange the displayed columns.

Sources View

Fig. 2.14 Sources view

Sources View lists the sources of certain information stored in the database.

These can include various documents (birth, death, and marriage certificates, etc.), books, films, journals, private diaries, - nearly anything that can provide genealogical evidence. GRAMPS gives you the option to provide a source for each event you record (births, deaths, marriages, etc.). The Sources View lists the Title , ID , and Author of the source, as well as any Publication information that may be associated with it.

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

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

Places View

Fig. 2.15 Places view

The Places 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. The Places View lists the places' Name , ID , Church Parish , City , County , State , and Country . All of these columns can be used for sorting by clicking on a column heading.

Clicking once sorts in ascending order, clicking again sorts in descending order. The Column Editor dialog may be used to add, remove and rearrange the displayed columns.

If a place has been highlighted, you may select the Google Maps, loading... button to attempt to display the place in a web browser. The map service can be chosen from the drop down list under the black triangle to the right of the map button.

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

This feature is limited, and may not always produce the results you desire.

Media View

Fig. 2.16 Media view

The Media View is a list of Media Objects used in the database.

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

Technically, any file can be stored as a Media Object.

Most frequently, these are images, audio files, animation files, etc. The list box on the bottom lists the Name , ID , Type , and Path of the Media Object.

The Column Editor dialog may be used to rearrange the displayed columns, which obey usual sorting rules. The top part of the GRAMPS window shows a preview (if available) and information about the Media Object.

Repositories View

Fig. 2.17 Repositories view

Version 2.2 adds support for Repositories.

A repository can be thought of as a collection of sources.

Each source in the database can reference a repository (such as a library) in which it belongs. The functionality of the Repositories View is similar to the other views.

Notes View

Fig. 2.18 Notes view

Version 3.1 added support for Notes. A Note is pure text, as stored in the other objects.

The functionality of the notes View is similar to the other views. The view lists all Notes stored in the Family Tree. With the Edit ->Column Editor you can change the displayed columns. The possibilities are Preview, ID, Type and Marker.

The Type can be (amongst others): Event Note, Adress Note,Source text, Place Note

Double-clicking on a Note in the list will bring up a window where you can edit the Note. You can change fonts, font color and backgroundcolor. A spellchecker is available for English and your local language.

HTML View (optional)

Fig. 2.19 GeoView

HTML View (see Grampsbrowser !, blog) or GeoView needs an active internet connection and a HTML kit (webkit or gtkmozembed).

This view is experimental and should provide the ability to display data present on Family Tree by using Maps available on internet.

Previous Index Next