Gramps 5.2 Wiki Manual

From Gramps
Revision as of 03:01, 27 November 2024 by Gioto (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This is the Wiki Manual for Gramps version 5.2. All users are encouraged to edit this manual to help improve its readability and usability.

Previous Index Next
Gramp-Small-background-wiki-2020.jpg

Research, organize and share your family tree with Gramps.

Gramps is a free software project and community. We strive to produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists. It is a community project, created, developed and governed by genealogists.

Abstract

This Gramps Wiki Manual for version 5.2 is the online user's guide, detailing most aspects of the Gramps application, a database for the collection of genealogical information. As of Thursday, 5 December 2024, the most current Gramps release is the 5.2.3 version. Both Gramps and the accompanying Wiki Manual have been translated into multiple languages.

You can also download the Complete 5.1 Offline Manual (English 20 MiB PDF and additional languages) last updated 27 Aug 2023. For previous Wiki Manuals revisions, see the archival versions made for previous releases of Gramps. (Search the page for "download" to find offline versions.)

The 5.2 Addons Offline Manual is available for review at (English 18 MiB PDF) last updated 10 Jun 2024.

To explore other sources of information about using Gramps, see the Information Portal.

Table of Contents

Preface
Why use Gramps?
Typographical conventions in the Gramps Wiki Manual

A Visual Guide to the Gramps Interface

  1. What's new?
    1. Before you upgrade
    2. Visible changes to the core
      1. Data Model
      2. Primary changes
      3. GUI
      4. Place
      5. Reports, Tools, Gramplets
      6. Import/Export
      7. New Addons
    3. Under the hood changes
      1. Dependencies
    4. Further information
      1. Miscellaneous
      2. Localization
      3. Roadmap
      4. Changelog
  2. Getting started
    1. Overview
      1. Connections
      2. Privacy
      3. GEDCOM
    2. Start Gramps
      1. Linux
      2. MS Windows
      3. macOS
    3. Choosing a Family Tree
    4. Tell me how to start right now!
    5. Obtaining Help
  3. Main Window
    1. Main Window
      1. Window Title Bar
      2. Menubar
        1. Pull-down menus
        2. Pop-up menus
        3. Selector Combo Boxes
      3. Toolbar
      4. Navigator
      5. Display area
      6. Status Bar and Progress Bar
      7. Bottombar and Sidebar
        1. Gramplet Bar
          1. Bottombar
          2. Sidebar
        2. Gramplet Bar Menu
          1. Restore to defaults? dialog
        3. Search Bar
    2. Switching Navigator modes
      1. Category navigator mode (default)
      2. Expander navigator mode
      3. Drop-Down navigator mode
    3. Switching Categories
    4. Switching Views
    5. Filters
  4. Categories
    1. Categories of the Navigator
    2. Dashboard Category
      1. Gramplet Layout
    3. People Category
      1. Tree View - Grouped People
      2. People List View
      3. People Category Bottombar tabs
        1. Details
        2. Gallery
        3. Events
        4. Children
        5. Citations
        6. Notes
        7. Attributes
        8. References
      4. People Category Sidebar tabs
        1. Filter
    4. Relationships Category
      1. Relationships Category view
        1. Active Person
        2. Parents
          1. Select Family selector
          2. Siblings
        3. Family
          1. Reorder Relationships dialog
          2. Children
        4. Configuration
      2. Relationships Category Bottombar tabs
      3. Relationships Category Sidebar tabs
    5. Families Category
      1. Families Category Bottombar tabs
        1. Details
        2. Gallery
        3. Events
        4. Children
        5. Citations
        6. Notes
        7. Attributes
        8. References
      2. Families Category Sidebar tabs
        1. Filter
    6. Charts Category
      1. Pedigree View
        1. Pedigree View Context menus
          1. Pedigree View Person Context menu
          2. Pedigree View Blank Context menu
        2. Configure the active view
      2. Fan Chart View
        1. Configure the active view
      3. Descendant Fan View
        1. Configure the active view
      4. 2-Way Fan View
        1. Configure the active view
      5. Charts Category Bottombar tabs
      6. Charts Category Sidebar tabs
        1. Filter
    7. Events Category
      1. Events View
      2. Events Category Bottombar tabs
        1. Gallery
        2. Citations
        3. Notes
        4. Attributes
        5. References
      3. Events Category Sidebar tabs
        1. Filter
    8. Places Category
      1. ⚙ Configuration Options
      2. Places List View
      3. Places Tree View
      4. Map Service
      5. Places Category Bottombar tabs
        1. Details
        2. Location
        3. Gallery
        4. Events
        5. Citations
        6. Notes
        7. References
      6. Places Category Sidebar tabs
        1. Filter
    9. Geography Category
      1. The different views
        1. All known places
        2. All known places for one Family
        3. Have they been able to meet ?
        4. All places related to Events
        5. All known places for one person
          1. All known places for one person with graphical information (KML files)
        6. Every residence or move for a person and any descendants
        7. Have these two families been able to meet ?
      2. Usage
        1. The configuration
          1. All views
          2. Specific views
        2. Print or save the Map
        3. How to zoom and move around the map ?
          1. Zoom in and Zoom out the map
          2. Move around the map
        4. The mouse actions on the map
          1. button 1 ( left button )
          2. button 2 ( middle button )
          3. button 3 ( right button )
          4. The mouse over a marker
        5. The menu popup
        6. Click on a marker
        7. Adding or Linking to a place
        8. Adding places from KML files
        9. How to change the map provider ?
        10. Can we change the marker's color ?
        11. How to get/remove the crosshair ?
        12. How to lock/unlock the map ?
      3. Prerequisites to see the geography view
      4. Possible problems
      5. Geography Category Bottombar tabs
      6. Geography Category Sidebar tabs
      7. Filter
    10. Sources Category
      1. Citation Tree View
      2. Sources List View
      3. Sources Category Bottombar tabs
        1. Gallery
        2. Notes
        3. References
      4. Sources Category Sidebar tabs
        1. Filter
    11. Citations Category
      1. Citations List View
      2. Citations Category Bottombar tabs
        1. Gallery
        2. Notes
        3. References
      3. Citations Category Sidebar tabs
        1. Filter
    12. Repositories Category
      1. Repository List View
      2. Repository Category Bottombar tabs
        1. Details
        2. Notes
        3. References
      3. Repository Category Sidebar tabs
        1. Filter
    13. Media Category
      1. Media List View
      2. Media Category Bottombar tabs
        1. Preview
        2. Citations
        3. Notes
        4. Attributes
        5. Image Metadata
        6. References
      3. Media Category Sidebar tabs
        1. Filter
    14. Notes Category
      1. Notes List View
      2. Notes Category Bottombar tabs
        1. References
      3. Notes Category Sidebar tabs
        1. Filter
  5. Manage Family Trees
    1. Starting a new Family Tree
      1. Family Trees manager window
        1. Database information dialog
    2. Opening a Family Tree
      1. Load Family Tree button
      2. Connect to a recent database
      3. Read Only Mode
    3. Saving changes to your Family Tree
    4. Opening a GEDCOM or XML database
    5. Deleting a Family Tree
      1. Remove the <XXXXXXXX> Family Tree? dialog
    6. Renaming a Family Tree
    7. Backing up a Family Tree
      1. Backup dialog
    8. Archiving a Family Tree
    9. Extracting a Family Tree Archive
    10. Unlocking a Family Tree
      1. Break the lock on the "Family Tree name" database? dialog
      2. The database is locked dialog
        1. Command Line:Force unlock option
    11. Repairing a damaged Family Tree
    12. Converting a BSDDB Family Tree to SQLite
    13. Importing data
      1. Import Family Tree dialog
      2. GRAMPS V2.x database import
        1. Moving a Gramps 2.2 databases to Gramps 3.x
      3. Gramps XML and XML Package import
      4. Gramps CSV import
      5. GEDCOM import
        1. GEDCOM Encoding dialog
        2. Import Statistics dialog
        3. GEDCOM import report dialog
          1. Reading the report
        4. GEDCOM import limitations
          1. HEADer, SUBMitter and SUBmissioN
          2. INDIvidual
          3. FAM_RECORD
          4. SOURCE_RECORD
          5. REPOSITORY_RECORD
          6. MULTIMEDIA_RECORD
          7. NOTE_RECORD
    14. Exporting data
      1. Export Assistant dialog
        1. Saving your data
        2. Choose the output format
        3. Export options
          1. Filters and privacy
            1. Privacy Filter:
            2. Living Filter:
            3. Person Filter:
            4. Note Filter:
            5. Reference Filter:
          2. File format specific export options
        4. Select save file
        5. Final confirmation
        6. Summary
        7. Comma Separated Values Spreadsheet(CSV) export
      2. GEDCOM export
      3. GeneWeb export
      4. Gramps XML (family tree) export
      5. Gramps XML Package (family tree and media) export
      6. Web Family Tree export
      7. vCalendar export
      8. vCard export
  6. CSV Import and Export
    1. Gramps Spreadsheet Import/Export
    2. Export
    3. Import
      1. People
      2. Marriage
      3. Family
      4. Place
    4. Details
      1. Example CSV with multiple areas
      2. Example CSV from Spreadsheet
  7. Probably Alive
    1. How does Gramps determine if someone is alive?
    2. Probably Alive Proxy
    3. Probably Alive Filter
    4. Calendar Gramplet
  8. Entering and editing data: brief
    1. To add or edit a person
      1. Add a new person
      2. Edit an existing person
    2. To specify a relationship
      1. Specifying a relationship using the Relationship View
      2. Specifying a relationship using the Family List View
    3. To specify parents
    4. To specify children
    5. Adding photos and other media objects
    6. To edit events, sources, places, and repositories
  9. Entering and editing data: detailed
    1. Entering and editing data: detailed - part 1
      1. Editing information about people
        1. Edit Person dialog
        2. Preferred name section
        3. Multiple Surnames
        4. General section
          1. Gender
            1. Unknown gender specified dialog
          2. ID
          3. Tags
          4. Privacy
        5. Preferred image
        6. Edit Person tab pages
          1. Events
            1. Select Event selector
          2. Names
          3. Source Citations
          4. Attributes
          5. Addresses
          6. Notes
            1. Select Note selector
          7. Gallery
            1. Select Media Object selector
          8. Internet
            1. Internet Address Editor
          9. Associations
            1. Person Reference Editor
              1. Select Person selector
          10. LDS
          11. References
      2. Editing information about relationships
        1. Family Editor dialog
          1. Select Father selector
          2. Select Mother selector
        2. Family Editor tab pages
          1. Children
            1. Select Child selector
            2. Child Reference Editor
              1. Source Citations tab
              2. Notes tab
          2. Events
          3. Source Citations
          4. Attributes
          5. Notes
          6. Gallery
          7. LDS
            1. LDS Ordinance Editor
      3. Editing dates
        1. Date selection dialog
        2. Date validity indicators
        3. Date Quality
        4. Date formats and parsing rules
        5. Calendars
          1. Swedish calendar
        6. Dual-dated dates
          1. Alternate new year day
    2. Entering and editing data: detailed - part 2
      1. Editing information about events
        1. New Event dialog
        2. New Event tab pages
          1. Source Citations
          2. Notes
          3. Gallery
          4. Attributes
          5. References
      2. Editing event references
        1. Event Reference Editor dialog
          1. Reference Information
            1. Reference Information tab pages
              1. General
              2. Notes
              3. Attributes
          2. Shared Information
            1. General
            2. Source Citations
            3. Attributes
            4. Notes_3
            5. Gallery
            6. References
      3. Editing information about media objects
        1. New Media dialog
        2. New Media tab pages
          1. Source Citations
          2. Attributes
          3. Notes
          4. References
      4. Editing media object references
        1. Select a media object selector
        2. Media Reference Editor dialog
          1. Top section
            1. Top section tab pages
              1. General
              2. Source Citations
              3. Attributes
              4. Notes
          2. Shared Information
            1. Shared Information tab pages
              1. General
              2. References
              3. Source Citations
              4. Attributes
              5. Notes
      5. Editing information about places
        1. Place Editor dialog
        2. Place editor tab pages
          1. Enclosed By
            1. Select Place selector
            2. Place Reference Editor
          2. Alternative Names
          3. Source Citations
          4. Notes
          5. Gallery
          6. Internet
          7. References
        3. Place Name Editor dialog
        4. Supported longitude/latitude formats (for coordinates)
      6. Editing information about sources
        1. New Source dialog
        2. New Source tab pages
          1. Notes
          2. Gallery
          3. Attributes
          4. Repositories
            1. Select Repository selector
          5. References
      7. Editing source citations
        1. Select Source or Citation selector
        2. New Citation dialog
          1. Citation information
            1. Select Source selector
            2. Citation information section tab pages
          2. Shared source information
      8. Editing information about repositories
        1. New Repository dialog
        2. New Repository tab pages
          1. Addresses
          2. Internet
          3. Notes
          4. References
      9. Editing information about notes
        1. New Note editor dialog
          1. Note tab
          2. References tab
          3. Link Editor
        2. Note markup and preformat in reports
    3. Entering and editing data: detailed - part 3
      1. Name Editor
        1. Name Editor dialog
          1. Type
          2. Given Name(s) Section
          3. Family Names Section
        2. Name Editor tab pages
          1. General
          2. Source Citations
          3. Notes
      2. Attributes
        1. Attribute Editor dialog
        2. Attribute Editor tab pages
          1. Source Citations
          2. Notes
      3. Addresses
        1. Address Editor dialog
        2. Address Editor tab pages
          1. Source Citations
          2. Notes
      4. Merging records
        1. Merge People
        2. Merge Families
        3. Merge Events
        4. Merge Sources
        5. Merge Citations
        6. Merge Places
        7. Merge Media Objects
        8. Merge Repositories
        9. Merge Notes
  10. Navigation
    1. Using the People Category
    2. Using the Relationships Category
    3. Using the Families Category
    4. Using the Charts Category
    5. Using Gramplets
    6. Setting the Home Person
    7. Setting the Active Person
    8. Using history-based tools
    9. Bookmarks
    10. Finding records
      1. Jump to by Gramps ID
    11. Using the Clipboard
      1. Clipboard context menu
    12. Using the Addon Manager...
      1. Addon Manager...
        1. Addons
        2. Settings
          1. Available Gramps Updates for Addons
        3. Projects
    13. Main Menus
      1. Family Trees
      2. Add
      3. Edit
      4. View
      5. Go
      6. Bookmarks
      7. Reports
      8. Tools
      9. Windows
      10. Help
  11. Plugin Manager
    1. Plugin types
    2. Registration and loading
    3. Hide/Unhide
    4. Actions
      1. Registered Plugins
      2. Loaded Plugins
    5. Detailed Info dialog
  12. Gramplets
    1. What is a Gramplet
      1. General Usage and Configuration
      2. Summary of Gramplets
        1. Gramplet List
    2. Gramplets
      1. 2-Way Fan Chart
      2. Age on Date
      3. Age Stats
      4. Ancestors
      5. Attributes
      6. Calendar
      7. Children
      8. Citations
      9. Descendant Fan Chart
      10. Descendants
      11. Details
      12. Events
      13. Events Coordinates
      14. Fan Chart
      15. FAQ
      16. Filter
      17. Gallery
      18. Given Name Cloud
      19. Image Metadata
        1. The interface
          1. Data Fields
          2. Buttons
        2. Prerequisites
        3. Usage scenario
      20. Locations
      21. Notes
      22. Pedigree
      23. Preview
      24. Quick View
      25. Records
      26. References
      27. Relatives
      28. Residence
      29. Session Log
      30. SoundEx
        1. Soundex what is this?
      31. Statistics
      32. Surname Cloud
      33. To Do
      34. Top Surnames
      35. Uncollected Objects
      36. Welcome
      37. What's Next
  13. Reports - Index and Summary.
    1. Generating Reports
      1. Report Settings
      2. Report Format Style
    2. Substitution Values
      1. The Substitution Keys
        1. Other Substitution Keys
        2. Default displayed formats
        3. Deprecated variables
      2. Format Strings
        1. Formatting names
        2. Formatting Dates
        3. Formatting Places
        4. Rules for format strings
      3. Control Variables
      4. Grouping
        1. Rules for groups
        2. Examples
      5. Attributes
      6. Events
        1. Event format strings
        2. Notes for attributes and events
      7. Separators
    3. Books
      1. Manage Books dialog
        1. Book name
          1. Book name toolbar
        2. Available items
        3. Available items selections
          1. Alphabetical Index
          2. Custom Text
          3. Table of contents
          4. Title Page
        4. Current book
          1. Current book toolbar
      2. Generate Book dialog
        1. Paper Options
        2. Document Options
    4. Graphical Reports
      1. Common options
        1. Paper Options
        2. Document Options
      2. Ancestor Tree
        1. Tree Options
        2. Display
        3. Size
        4. Include
      3. Calendar
        1. Report Options
        2. Content Options
        3. Text Options
      4. Descendant Tree
        1. Tree Options
        2. Display
        3. Replace
        4. Size
        5. Include
      5. Family Descendant Tree
        1. Tree Options
        2. Display
        3. Replace
        4. Size
        5. Include
      6. Fan Chart
        1. Report Options
      7. Statistics Charts
        1. Report Options
        2. Charts 1
        3. Charts 2
      8. Timeline Chart
        1. Report Options
      9. Scale and Resize options
        1. Scale tree to fit:
        2. Resize Page to Fit Tree size
        3. inter-box Y scale factor
        4. box shadow scale factor
        5. Know what you want to print on
    5. Graphs
      1. Common Options
        1. Graphviz Layout
        2. Graphviz Options
        3. Note
      2. Family Lines Graph
        1. Report Options
        2. Report Options (2)
        3. People of Interest
        4. Include
        5. Family Colours
        6. Individuals
      3. Hourglass Graph
        1. Report Options
        2. Report Options (2)
        3. Graph Style
      4. Relationship Graph
        1. Report Options
        2. Report Options (2)
        3. Include
        4. Graph Style
        5. Example
    6. Text Reports
      1. Common options
        1. Paper Options
        2. Document Options
      2. Ahnentafel Report
        1. Report Options
      3. Birthday and Anniversary Report
        1. Report Options
        2. Text Options
      4. Complete Individual Report
        1. Report Options
        2. Include
        3. Sections
      5. Database Summary Report
        1. Report Options
      6. Descendant Report
        1. Report Options
      7. Detailed Ancestral Report
        1. Report Options
        2. Content
        3. Include
        4. Missing information
      8. Detailed Descendant Report
        1. Report Options
        2. Content
        3. Include
        4. Missing information
      9. End of Line Report
        1. Report Options
      10. Family Group Report
        1. Report Options
        2. Include
        3. Missing information
      11. Kinship Report
        1. Report Options
      12. Note Link Report
      13. Number of Ancestors Report
        1. Report Options
      14. Place Report
        1. Report Options
      15. Records Report
        1. Report Options
        2. Person Records
        3. Family Records
      16. Tag Report
        1. Report Options
    7. Web Pages
      1. Narrated Web Site
        1. Dialog tabs
          1. Report Options
          2. HTML Options
          3. Display
          4. Page Generation
          5. Extra Pages
          6. Images Generation
          7. Download
          8. Advanced Options
          9. Include
          10. Place Map Options
          11. Other inclusion (CMS, web calendar, PHP)
          12. Translations
          13. Calendar Options
        2. Example Web Site output
          1. Home
          2. Introduction
          3. Individuals
          4. Surnames
          5. Families
          6. Events
          7. Places
          8. Sources
          9. Repositories
          10. Media
          11. Thumbnails
          12. Download
          13. Address Book
          14. Contact
        3. Prerequisites for Narrated Web Site
          1. Possible problems
      2. Web Calendar
        1. Dialog tabs
          1. Report Options
          2. Report Options (2)
          3. Content Options
          4. Advanced Options
          5. Jan - Jun Notes
          6. Jul - Dec Notes
        2. Example Web Site output
    8. Quick Views
      1. All Events
      2. All Family Events
      3. On This Day
      4. Father lineage
      5. Mother lineage
      6. Siblings
      7. Relation to Home Person
      8. Same Given Names
      9. Same Surnames
      10. Person References
      11. Family References
      12. Event References
      13. Place References
      14. Source References
      15. Citation References
      16. Repository References
      17. Media References
      18. Link References
      19. Note References
    9. Quick View Gramplet
    10. Making your own Quick view
  14. Tools
    1. Tool Selection dialog
    2. Analysis and Exploration
      1. Compare Individual Events
    3. Family Tree Processing
      1. Database Owner Information
      2. Extract Event Description
      3. Extract Information from Names
      4. Extract Place Data from a Place Title
      5. Find Possible Duplicate People
        1. Potential Merges
      6. Fix Capitalization of Family Names
      7. Merge citations
      8. Rename Event Types
      9. Reorder Gramps ID
      10. Sort Events
    4. Family Tree Repair
      1. Check and Repair Database
        1. Gramps had a problem the last time it was run - dialog
      2. Rebuild Gender Statistics
      3. Rebuild Reference Maps
      4. Rebuild Secondary Indices
      5. Remove Unused Objects
    5. Utilities
      1. Media Manager
        1. Replace substrings in the path
        2. Convert paths from relative to absolute
        3. Convert paths from absolute to relative
        4. Add images not included in database
      2. Not Related
      3. Relationship Calculator
      4. Verify the Data
        1. Verify the Data tab pages
          1. General
          2. Women
          3. Men
          4. Families
        2. Data Verification Results window
        3. Examples
      5. Find database loop
    6. Debug
      1. Check Localized Date Displayer and Parser
      2. Dump Gender Statistics
      3. Generate Testcases for Persons and Families
      4. Populate Sources and Citations
  15. Settings
    1. Preferences
      1. Data
        1. Display
          1. Display Name Editor
          2. Place Format Editor
        2. Input Options
      2. General
        1. Environment Settings
          1. Enable spell checker
        2. Tip of the Day dialog
      3. Family Tree
        1. Database Settings
        2. Database Location
        3. Backup Management
        4. Family Tree's Media path
          1. Select media directory dialog
          2. Missing Media Objects 'broken link' icon of a box with a red 'x'
      4. Import
        1. Tag Records
        2. Source GEDCOM import
      5. Limits
        1. Calculation limits
      6. Colors
        1. Colors used for boxes in the graphical views
        2. Colors for Male persons
        3. Colors for Female persons
        4. Colors for people who are neither male nor female
        5. Colors for Unknown persons
        6. Colors for Family nodes
        7. Other colors
      7. Genealogical Symbols
        1. Prerequisite to use Genealogical Symbols
          1. Initial setup
          2. Prerequisite
      8. ID Formats
      9. Text
      10. Warnings
      11. Researcher
    2. Other settings
      1. Column Editor
      2. Sorting columns
      3. Setting Home person
      4. Adjusting viewing controls
      5. Export View
        1. Export View as Spreadsheet dialog
      6. Modularity and plugins
      7. Customize report output formats
        1. Document Styles dialog
        2. Style editor dialog
          1. Style editor dialog tabs
            1. Description
            2. Font options
            3. Paragraph options
      8. Context menu
    3. Customizing
      1. Preferences
      2. Pick a Color selector
        1. Color Palette
        2. Color Gradient
      3. File Chooser
        1. Context Menu options
        2. Breadcrumbs and text-entry address bar
        3. Bookmarking file folders
        4. File Formats
        5. See also
      4. Language
        1. Linux
        2. macOS
        3. MS Windows
      5. Add Windows OS Menu Item
      6. Change the windows LANG variables
      7. Language codes
      8. Advanced manipulation of settings
        1. Example gramps.ini file
        2. Advanced backup filename setting
      9. Theme
  16. Filters
    1. Filter vs. Search
    2. Regular Expressions
      1. Groups and Sets
      2. Examples
        1. Common variations of a surname
        2. testing regular expressions
    3. Custom Filters
    4. Which filters in which Category?
    5. Ancestral filters
    6. Child filters
    7. Citation/sources filters
      1. Persons-, and Relationship Category
      2. Families Category
      3. Events Category
      4. Places Category
      5. Media Category
    8. Descendant filters
    9. Event filters
      1. Persons-, and Relationship Category
      2. Families Category
    10. Family filters
    11. Father filters
    12. General filters
      1. Persons-, and Relationship Category
      2. Families Category
      3. Events Category
      4. Places Category
      5. Sources Category
      6. Citations Category
      7. Repositories Category
      8. Media Category
      9. Notes Category
    13. Mother filters
    14. Position filters
    15. Source filters
    16. Relationship filters
    17. Tagging
      1. Concept
      2. Differences with markers
      3. Tags and Filters
      4. Operations with tags
        1. Filtering
        2. Tagging a selection of objects
      5. Tags Column

Appendix A: Frequently Asked Questions
General
What is Gramps?
Where do I get it and how much does it cost?
Do I need to register as a user to use Gramps, I am not a programmer?
Does Gramps exist in other languages?
How do I keep backups?
Does Gramps support Unicode fonts?
Installation
What is needed to install Gramps under Linux, Solaris, or FreeBSD?
Does Gramps work on Windows?
Does Gramps work on the Mac?
Does Gramps work on my mobile device?
Does Gramps work on my Google Chromebook?
What are the Minimum Specs to run Gramps?
How do I upgrade Gramps?
Preferences
Can I change the dates in reports to 'day month year'?
Collaboration-Portability
Is Gramps compatible with other genealogical software?
Can Gramps read files created by other genealogy programs?
Can Gramps write files readable by other genealogy programs?
What standards does Gramps support?
How do I import data from another genealogy program into Gramps?
Can I install Gramps on a Linux Web Server and use it via a web browser?
Reports
Can Gramps print a genealogical tree for my family?
In what formats can Gramps output its reports?
How can I change the default language in reports?
Is Gramps compatible with the Internet?
Can I create custom reports/filters/whatever?
Why are non-Latin characters displayed as garbage in PDF/PS reports?
I would like to contribute to Gramps by writing my favorite report. How do I do that?
Database - Gramps file formats
What is the maximum database size (bytes) Gramps can handle?
How many people can Gramps database handle?
My database is really big. Is there a way around loading all the data into memory?
Can I run Gramps from a database on a NFS share?
What does "portable" mean?
Why is the database format (GRDB) not portable?
Does Gramps have an Example Tree?
Bugs and requests
What do I do if I have found a bug?
Requests
Adding to and editing my database
What is the difference between a residence and an address?
How do I change the order of children?
How do I change the order of spouses?

Appendix B: Keybindings reference
List Views
Common bindings
All List Views bindings
People View bindings
Editors
Editor Tab bindings
Editor bindings
Handy Shortcuts
Access Key Shortcuts
See also

Appendix C: Command line reference
Start Gramps through the Command Line
Linux
MS Windows
macOS
Python options
Available options
Format options
Opening options
Import options
Export options
Action options
report action option
tool action option
book action option
Force unlock option
Configuration (config) option
Safe mode
Defaults
Operation
Examples
Environment variables
GRAMPSHOME
LANG, LANGUAGE, LC_MESSAGES, LC_TIME
GRAMPSI18N
GRAMPSDIR
GRAMPS_RESOURCES

Appendix D: User Directory
POSIX - style systems
macOS
macOS Application Package
MS Windows

Appendix E: Error and Warning Reference
When something goes wrong
Alerts
Are you sure you want to upgrade this Family Tree?
Cannot open database
Low level database corruption detected
Error detected in database
Warnings
Gramps Warnings dialog
Locale warnings
Module not loaded warnings
Show plugin status dialog on plugin load error.
Configuration warnings
Other warnings
Cannot save person
Cannot merge <object>
Duplicate Family warning dialog
Suppress warning when adding parents to a child
Suppress warning when cancelling with changed data
Save Changes? dialog
Suppress warning about missing researcher when exporting to GEDCOM
Undo history warning
Errors
Error Report
Error Reporting Assistant dialog
Report a bug page
Error Details page
System Information page
Further Information page
Bug Report Summary page
Send Bug Report page
Complete page
Other Errors
Report could not be created
Seeing all the error messages
Linux
MS Windows
macOS
Console application

Appendix F: Further References
User References
Programmers References
Translators References

Appendix G: About Gramps
About
Original author
Contributors
Have an issue or idea?
License

Previous Index Next


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: [https://www.gramps-project.org/...]), not via internal links.
Also, only use the known Typographical conventions