Changes

The Family Tree Manager window allows the you to create a new Family tree, rename an existing Family tree, delete a Family tree, or load a Family tree or check info (rmationinformation) about the Family tree. All the names of your Family trees appear in the list. If a Family tree is open, an icon will appear next to the name in the status column. The Database Type as well an indication of the date and time your family tree was ''Last accessed''' is shown.

* {{man button|Convert}} the selected family tree . This option only available for legacy [[Gramps_Glossary#bsddb|BSDDB ]] databases. See: [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQlite|Converting a BSDDB Family Tree ]] to [[Gramps_Glossary#sqlite|SQlite]]

When Gramps opens a tree, it locks the tree, preventing If you or anyone else opening it at ''could'' open the same time. A second copy Family Tree in two instances of Gramps will be able to open another family treeat once, but the tree already open will appear with the lock icon, indicating you cannot open it. Closing the tree in the first copy of Gramps will make it available to is likely your data would be opened in damaged as the second copytwo overwrite each other's work.

If you could open the same Family Tree in two Gramps at once, it is likely your data would be damaged====See also:====* [[Gramps_5.1_Wiki_Manual_-_Command_Line#Force_unlock_option|Command Line:Force unlock option]]

See also:* [[Gramps_5.1_Wiki_Manual_-_Command_Line#Force_unlock_option|Command Line:Force unlock option]]{{-man warn|Be careful Breaking Locks!|Only do this if you are sure no other copy of Gramps is using the selected Family Tree.}}

In the unlikely event that Gramps crashes, the family tree will be left in a locked state (indicated by a lock icon in the {{man label|Status}} colum next to the Family Trees name) To unlock the Family Tree{{-}}* If Gramps has been set to open a tree automatically on during startup, then you will see the 'Database is locked' dialogue. Click on the {{man button|Close}} button

* If the [[File:ErrorParsingArgumentsGramps_5.1_Wiki_Manual_-_Settings#Family_Tree|Family Tree Preferences]] have been set to open a tree automatically on startup, then you will see the '''Error parsing arguments''' dialog-DatabaseIsLocked-example-50which remarks that the '''Database is locked'''.pngClick on the {{man button|thumbClose}} button then choose {{man menu|right|450px|FigManage Family trees... }} from the {{#var:chapterman menu|Family Trees}}menu.* Otherwise, the {{#vardefineecho:figureman label|{{#expr:{{#var:figureFamily Tree Manager}}+1}}}} Database is locked - Error parsing arguments - dialog - example]]will appear automatically as Gramps starts.

* Otherwise [[File:Break-the -lock-on-the-database-Dialog-example-50.png|thumb|right|450px|Fig. {{man label#var:chapter}}.{{#vardefineecho:figure|Family Tree Manager{{#expr:{{#var:figure}}+1}}}} will appear. Break the lock on the "Sample" database? - Dialog - example ]]Choose the locked family tree and then click the {{man button|Load Family Tree}} button. The {{man label|'''Break the lock on the "'[Family Tree name]" ' database?}} ''' dialog will be shown.

[[File:Break-the-lock-on-Click the-database-Dialog-example-50.png|thumb|right|450px|Fig. {{#var:chapterman button|Break lock}}.button and the {{#vardefineecho:figureman label|{{#expr:{{#var:figure}}+1}}Family Trees (Manager)}} Break window should show that the lock on the "Sample" database? - Dialog - example ]]icon has gone.

{{-}}* {{man menu|Only do this if you are sure no other copy of Gramps is using the selected Family Tree.}} Click the {{man button|Break lock}} button and the {{man label|Family Trees (Manager)}} window should show that the lock icon has gone.* Choose the previously locked family tree and then click the {{man button|Load Family Tree}} button to continue your work.

{{man warntip|From Gramps 5.1.x the default database is SQLite.|Before following the conversion advice in this section , take the time to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|backup your family trees]]}}

If you have an older legacy [[Gramps_Glossary#bsddb|BSDDB ]] format '''Database Type''' shown for any of your family tree's in the ''Family Trees (Manager)'' - Dialog, then selecting a family tree in the''Family Trees (Manager)'' - Dialog will shown show the {{man button|Convert}} button as available.

* [[#Gramps_XML_and_XML_Package_import|Gramps XML]] (<code>.gramps</code> file extension)Gramps native data exchange format in uncompressed text and [https://wikipedia.org/wiki/Gzip gzip] compressed * [[#Gramps_XML_and_XML_Package_import|Gramps XML Package]] (<code>.gpkg</code> file extension)* Gramps [[#Gramps_CSV_import|Gramps CSV Spreadsheet]] - comma separated values (<code>https://wikipedia.csv<org/wiki/code> file extension).tar.gz .tar.gz] archive compressed backup format

* [[#Gramps_CSV_import|CSV Spreadsheet]] - comma separated values (<code>.csv</code> file extension)* [[#GEDCOM_import|GEDCOM]] (<code>.ged</code> file extension)de facto standard file format for data interchange between genealogy programs

* Pro-Gen (<code>.def</code> file extension) - [https://www.pro-gen.nl/gbhome.htm Pro-Gen] is has been very popular in the Netherlands and North-West Germany, . It is often used by people who started decades before today collecting data and storing; this in data as early as 1989. This was a DOS based program (which is still today, has been patched up to work with Win 10.* vCard (<code>.vcf</code> file extension) - [https://wikipedia.org/wiki/VCard Virtual Contact File] is a file format standard for electronic business cards.* JSON Import (<code>.json</code> file extension)- [https://www.json.org/ JavaScript Object Notation] is a lightweight data-interchange format. * SQLite Import (<code>.sql</code> file extension) - [https://www.sqlite.org/fileformat.html SQLite database format]

{{man note|Note that data can only be imported into an existing a prepared Family Tree (database)|So, if migrating from another program, it is best necessary to start by creating first create a new ''empty '' Family Tree and then import before importing the unauthenticated data into it. Then Once the data is imported, clean up any corruptions or incompatibilities. <br />If the intent is to merge use the import for merging outside data into an existing Gramps Tree by importing, it is less risky complex to import data from a pre-cleaned and validated Tree already in Gramps format. <br />Importing is a risky task, always make a backup of your Tree before importing.}}

First create a [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Starting_a_new_Family_Tree|new and empty Family Tree]]. Then select the menu {{man menu|Family Trees ->Import}} or use the [[Gramps_5.1_Wiki_Manual_-_Keybindings#2|keybinding]] {{Man key press|CTRL|I}} to import data or restore a previously saved Gramps Family Tree (from an older version of Gramps or the current version) the '''{{man label|Import Family Tree}}''' dialog will open, asking you to specify the file you wish to import. [[File:WarningUndoHistory_Import-dialog-51.png|thumb|left|182px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Import warning dialog]]As you attempt to import into a Family Tree that is '''''not empty''''', the {{man label|Undo history warning}} dialog will open. This reminds you make a backup before importing. Create a new Family Tree instead, unless you are knowingly attempting to merge data. Gramps uses a [https://developer.gnome.org/gtk3/stable/GtkFileChooser.html GTK File Chooser] for selecting the data file to be exported. The basic options for navigating to a file are familiar and obvious.  The default display option for the filepath is to show each folder level as clickable [https://en.wikipedia.org/wiki/Breadcrumb_navigation breadcrumb navigation]. The path can be typed in an editable text box by pressing the {{Man key press|CTRL|L}} keybinding. The file type extension will normally allow the {{man menu|Automatically detected}} option to expect a particular pattern of data to be converted to the native database format. You can override this by choosing a different '''{{man label|Select file type:}}''' options. The list of files may be filtered by changing from the {{man menu|All files}} option.

If you attempt When planning to use the import into an existing Family Tree repeatedly (for ongoing updates or including genealogy research), you can [https://gramps.discourse.group/t/need-help-doing-a-cross-os-linux-mac-verification/1068/5 customize the dialog] by adding buttons for bookmarked folder paths. Right-click on a folder name and choose {{man labelmenu|Undo history warningAdd to bookmarks}} dialog will open giving you from the opportunity to stop the import and create a new Family Tree, unless you are deliberately attempting to merge datapop-up menu.

{{man warn|Data loss with some formats |It is important to note that there is no direct one-to-one correspondence between all the features of Gramps and those of supported in the basic [[Gramps_Glossary#gedcom|GEDCOM ]] generic genealogy file format or data files of programs like GeneWeb or Pro-Gen. Therefore, unrecognized data chunks may be lost when importing from any of these formats data may be lost. Details of data that may be at greatest risk of being lost from GEDCOM is given [[#GEDCOM_import|outlined below]].}}

{{man note|Reorder {{man label[[Gramps_Glossary#event|Event}}s Events]] generated by other programs|Some programs from which you have imported data may not order the events by date as you expect. They will be in the order they were exported by the other program. Gramps provides help for reordering events according to your preference. See the [[Gramps_5.1_Wiki_Manual_-_Tools#Sort_Events|Sort Events]] tool.}}

Please refer to the [[User_manualUser_manual_translations|User Manual]] for earlier versions of Gramps for instructions on the import of v2.x databases into Gramps v3.x.

[[File:Source-Note-GEDCOMImportNote-example-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} GEDCOM import note indicating omitted data attached to "Source>Note"(data from "GEDitCOM" - "GEDCOM 5.5 Torture Test Files")]]