Gramps - User contributions [en]

Download

2017-08-29T20:29:31Z

RossGammon: Update Ubuntu Versions, including my latest backports

{{languages}}

'''Research, organize and share your family tree with Gramps.'''

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

{{man note|{{Man menu|'''Current version: {{version}} Released: 2017-08-01'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Lot of updates see:.''[[Gramps_4.2_Wiki_Manual_-_What's_new%3F|What's new?]]}}

{{man warn|''Legacy version: 3.4.9 Released: 2015-04-30|This is the final maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x and version 4.2.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2015/04/gramps-3-4-9-released/]}}

== Linux ==

[[File:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[File:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

Supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.(''Please note: Python-3.5 and Gtk-3.18 dropped support for Windows XP not Gramps itself. Gramps can still be run on Windows XP with older versions of those libraries eg:(Gtk-3.16 & Python3.4.4)'')

<big>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps. {{man menu|Standard setup is ''English only'' so if using a different language please ensure that you select extra dictionary and language files when asked during the installation process.}}

{{man tip|Shortcuts|Once installed one shortcut is placed on the desktop and in the Start menu two shortcuts are added, please only use the first shortcut, unless requested by a developer. 1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut for everyday use of Gramps}} 2) ''GrampsAIO'''XX''' ''{{version}}''-console)}}

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only).

Alternative independent '''Legacy''' MS Windows version [[#3|[3]]].

You may also install using the alternative independent Gramps Chocolatey Package [[#4|[4]]].

== Mac OS X ==

[[File:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Supports Mac OS X in all versions 10.5 (Leopard) and later.

<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{man tip|Spell Checking:|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [http://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}

{{-}}

== BSD ==

[[File:Bsd daemon.jpg|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[File:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu 14.04.3] and Gramps from the CD anytime you like.
{{-}}
[[File:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04/release/]]
'''Edubuntu 14.04.3''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit])
{{-}}

=== Online Demonstration ===
You can also try an online demonstration of Gramps on rollApp:
* https://www.rollapp.com/app/gramps
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''

{{man note|Note|This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}
{{-}}

== Linux and BSD distributions ==
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|Please report any problems with them to the package maintainer.}}
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[File:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|Debian 7 ("wheezy") (old old stable): Gramps 3.4.0 Debian 8 ("jessie")(old stable): Gramps 4.1.1 Debian 8 ("jessie")(backports): Gramps 4.2.5 Debian 8 ("jessie")(backports-sloppy): Gramps 4.2.6 Debian 9 ("stretch") (stable): Gramps 4.2.5 Debian 9 ("stretch")(backports): Gramps 4.2.6 buster (testing): Gramps 4.2.6 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.2.6
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[File:Ubuntu_32x32.png]]''' Ubuntu '''
|Software Centre
|Trusty (14.04 LTS): Gramps: 4.0.3 Trusty (14.04 LTS): Gramps: 4.2.3 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport]) Xenial (16.04 LTS): Gramps: 4.2.2 Xenial (16.04 LTS): Gramps: 4.2.6 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport]) Zesty (17.04): Gramps: 4.2.5 Zesty (17.04): Gramps: 4.2.6 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport]) Artful (Development: 17.10): Gramps: 4.2.6
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|'''Linux Mint'''
|Software Manager
|Qiana/Rosa 17(Gramps 4.0.3+dfsg-2) Sarah/Serena 18(Gramps 4.2.2~dfsg-1)
|[http://community.linuxmint.com/software/view/gramps available versions]
|-
|[[File:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Rawhide (Gramps 4.2.5) Fedora 26 (Gramps 4.2.5) Fedora 25 (Gramps 4.2.5) Fedora 24 (Gramps 4.2.5)
|[https://apps.fedoraproject.org/packages/gramps available versions] / Note:The Fedora and Red Hat Projects were merged on September 22, 2003.
|-
|'''[https://www.mageia.org/en/ Mageia]'''
||[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|Mageia Caulron: Gramps 4.2.5 Mageia 5.0: Gramps 4.1.3
|[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
|-
|''' openSUSE '''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|openSUSE Tumbleweed: Gramps 4.2.5 openSUSE Leap 42.2: Gramps 4.2.4 openSUSE 13.2: Gramps 4.0.4
|[http://software.opensuse.org/package/gramps available versions] See note [http://gramps.1791082.n4.nabble.com/ahnenforschung-familie-ihle-de-td4672224.html#a4672266] : Gramps 4.2 can be installed on Opensuse 13.2 ( if you add the 'openSUSE BuildService - GNOME:Apps' )
|-
|'''Slackware'''
|
|14.2: Gramps 3.4.3 14.1: Gramps 4.0.3
|[http://pkgs.org/search/?keyword=gramps available versions] [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]: Gramps 4.2.5
|-
|'''[https://www.netbsd.org/ NetBSD]'''
|
|NetBSD: Gramps 3.4.4
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''[https://www.freebsd.org/ FreeBSD]'''
|
|FreeBSD: Gramps 4.2.4
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''TrueOS'''
|
|PC-BSD: Gramps 3.4.8
|[http://web.pcbsd.org/pc-bsd-is-now-trueos/ 2016/09/01 - PC-BSD is now TrueOS]
|-
|'''[https://www.openbsd.org/ OpenBSD]'''
|
|OpenBSD: Gramps 4.2.5
|[http://openports.se/misc/gramps available versions]
|-
|'''Arch Linux'''
|
| Gramps 4.2.6
|[https://www.archlinux.org/packages/community/any/gramps/ available versions]
|-
|'''Gentoo Linux'''
|
| Gramps 4.2.5
|[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|-
|
|
|
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.

{{man warn|1=Warning before attempting this use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

=== Debian-based ===
For [[Image:Debianopenlogo-32.png]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[Image:Ubuntu_32x32.png]]''' Ubuntu ''') [{{github_url}}/releases/v{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i python3-gramps_{{version}}-1_all.deb

If you have an error about having unmet dependencies run:

sudo apt-get -f install

to install the dependencies.

==== Useful command lines ====
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:

* Find out what version you are running, by using this:

dpkg-query -s python3-gramps

that queries the package and gives you info about it.

* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :

sudo dpkg -r python3-gramps

this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )

* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:

sudo apt-mark hold gramps

'''Upgrade is then complete.'''

=== For other distributions ===
For other distributions, [[Image:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data. See : [[How to make a backup]]

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (29.0 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report packaging issues to the author.]''' (2012-09-07)

[4]
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind. [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]

== See also ==
* [[Previous releases of Gramps]]

[[Category:Documentation]]

Download

2017-08-29T20:23:52Z

RossGammon: Update with 4.2.6 backports in Debian

{{languages}}

'''Research, organize and share your family tree with Gramps.'''

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

{{man note|{{Man menu|'''Current version: {{version}} Released: 2017-08-01'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Lot of updates see:.''[[Gramps_4.2_Wiki_Manual_-_What's_new%3F|What's new?]]}}

{{man warn|''Legacy version: 3.4.9 Released: 2015-04-30|This is the final maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x and version 4.2.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2015/04/gramps-3-4-9-released/]}}

== Linux ==

[[File:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[File:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

Supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.(''Please note: Python-3.5 and Gtk-3.18 dropped support for Windows XP not Gramps itself. Gramps can still be run on Windows XP with older versions of those libraries eg:(Gtk-3.16 & Python3.4.4)'')

<big>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps. {{man menu|Standard setup is ''English only'' so if using a different language please ensure that you select extra dictionary and language files when asked during the installation process.}}

{{man tip|Shortcuts|Once installed one shortcut is placed on the desktop and in the Start menu two shortcuts are added, please only use the first shortcut, unless requested by a developer. 1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut for everyday use of Gramps}} 2) ''GrampsAIO'''XX''' ''{{version}}''-console)}}

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only).

Alternative independent '''Legacy''' MS Windows version [[#3|[3]]].

You may also install using the alternative independent Gramps Chocolatey Package [[#4|[4]]].

== Mac OS X ==

[[File:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Supports Mac OS X in all versions 10.5 (Leopard) and later.

<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{man tip|Spell Checking:|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [http://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}

{{-}}

== BSD ==

[[File:Bsd daemon.jpg|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[File:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu 14.04.3] and Gramps from the CD anytime you like.
{{-}}
[[File:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04/release/]]
'''Edubuntu 14.04.3''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit])
{{-}}

=== Online Demonstration ===
You can also try an online demonstration of Gramps on rollApp:
* https://www.rollapp.com/app/gramps
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''

{{man note|Note|This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}
{{-}}

== Linux and BSD distributions ==
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|Please report any problems with them to the package maintainer.}}
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[File:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|Debian 7 ("wheezy") (old old stable): Gramps 3.4.0 Debian 8 ("jessie")(old stable): Gramps 4.1.1 Debian 8 ("jessie")(backports): Gramps 4.2.5 Debian 8 ("jessie")(backports-sloppy): Gramps 4.2.6 Debian 9 ("stretch") (stable): Gramps 4.2.5 Debian 9 ("stretch")(backports): Gramps 4.2.6 buster (testing): Gramps 4.2.6 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.2.6
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[File:Ubuntu_32x32.png]]''' Ubuntu '''
|Software Centre
|Trusty (14.04 LTS): Gramps: 4.0.3 Trusty (14.04 LTS): Gramps: 4.2.3 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport]) Xenial (16.04 LTS): Gramps: 4.2.2 Xenial (16.04 LTS): Gramps: 4.2.5 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport]) Zesty (17.04): Gramps: 4.2.5 Artful (Development: 17.10): Gramps: 4.2.5
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|'''Linux Mint'''
|Software Manager
|Qiana/Rosa 17(Gramps 4.0.3+dfsg-2) Sarah/Serena 18(Gramps 4.2.2~dfsg-1)
|[http://community.linuxmint.com/software/view/gramps available versions]
|-
|[[File:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Rawhide (Gramps 4.2.5) Fedora 26 (Gramps 4.2.5) Fedora 25 (Gramps 4.2.5) Fedora 24 (Gramps 4.2.5)
|[https://apps.fedoraproject.org/packages/gramps available versions] / Note:The Fedora and Red Hat Projects were merged on September 22, 2003.
|-
|'''[https://www.mageia.org/en/ Mageia]'''
||[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|Mageia Caulron: Gramps 4.2.5 Mageia 5.0: Gramps 4.1.3
|[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
|-
|''' openSUSE '''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|openSUSE Tumbleweed: Gramps 4.2.5 openSUSE Leap 42.2: Gramps 4.2.4 openSUSE 13.2: Gramps 4.0.4
|[http://software.opensuse.org/package/gramps available versions] See note [http://gramps.1791082.n4.nabble.com/ahnenforschung-familie-ihle-de-td4672224.html#a4672266] : Gramps 4.2 can be installed on Opensuse 13.2 ( if you add the 'openSUSE BuildService - GNOME:Apps' )
|-
|'''Slackware'''
|
|14.2: Gramps 3.4.3 14.1: Gramps 4.0.3
|[http://pkgs.org/search/?keyword=gramps available versions] [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]: Gramps 4.2.5
|-
|'''[https://www.netbsd.org/ NetBSD]'''
|
|NetBSD: Gramps 3.4.4
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''[https://www.freebsd.org/ FreeBSD]'''
|
|FreeBSD: Gramps 4.2.4
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''TrueOS'''
|
|PC-BSD: Gramps 3.4.8
|[http://web.pcbsd.org/pc-bsd-is-now-trueos/ 2016/09/01 - PC-BSD is now TrueOS]
|-
|'''[https://www.openbsd.org/ OpenBSD]'''
|
|OpenBSD: Gramps 4.2.5
|[http://openports.se/misc/gramps available versions]
|-
|'''Arch Linux'''
|
| Gramps 4.2.6
|[https://www.archlinux.org/packages/community/any/gramps/ available versions]
|-
|'''Gentoo Linux'''
|
| Gramps 4.2.5
|[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|-
|
|
|
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.

{{man warn|1=Warning before attempting this use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

=== Debian-based ===
For [[Image:Debianopenlogo-32.png]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[Image:Ubuntu_32x32.png]]''' Ubuntu ''') [{{github_url}}/releases/v{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i python3-gramps_{{version}}-1_all.deb

If you have an error about having unmet dependencies run:

sudo apt-get -f install

to install the dependencies.

==== Useful command lines ====
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:

* Find out what version you are running, by using this:

dpkg-query -s python3-gramps

that queries the package and gives you info about it.

* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :

sudo dpkg -r python3-gramps

this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )

* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:

sudo apt-mark hold gramps

'''Upgrade is then complete.'''

=== For other distributions ===
For other distributions, [[Image:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data. See : [[How to make a backup]]

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (29.0 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report packaging issues to the author.]''' (2012-09-07)

[4]
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind. [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]

== See also ==
* [[Previous releases of Gramps]]

[[Category:Documentation]]

Download

2017-02-11T20:58:27Z

RossGammon: Jessie backports updated

{{languages}}

'''Research, organize and share your family tree with Gramps.'''

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

{{man note|{{Man menu|'''Current version: {{version}} Released: 2016-12-15'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Lot of updates see:.''[[Gramps_4.2_Wiki_Manual_-_What's_new%3F|What's new?]]}}

{{man warn|''Legacy version: 3.4.9 Released: 2015-04-30|This is the final maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x and version 4.2.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2015/04/gramps-3-4-9-released/]}}

== Linux ==

[[File:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[File:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

Supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.(''Please note: Python-3.5 and Gtk-3.18 dropped support for Windows XP not Gramps itself. Gramps can still be run on Windows XP with older versions of those libraries eg:(Gtk-3.16 & Python3.4.4)'')

<big>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps. {{man menu|Standard setup is ''English only'' so if using a different language please ensure that you select extra dictionary and language files when asked during the installation process.}}

{{man tip|Shortcuts|Once installed one shortcut is placed on the desktop and in the Start menu two shortcuts are added, please only use the first shortcut, unless requested by a developer. 1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut for everyday use of Gramps}} 2) ''GrampsAIO'''XX''' ''{{version}}''-console)}}

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only).

Alternative independent '''Legacy''' MS Windows version [[#3|[3]]].

You may also install using the alternative independent Gramps Chocolatey Package [[#4|[4]]].

== Mac OS X ==

[[File:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Supports Mac OS X in all versions 10.5 (Leopard) and later.

<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{man tip|Spell Checking:|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [http://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}

{{-}}

== BSD ==

[[File:Bsd daemon.jpg|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[File:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu 14.04.3] and Gramps from the CD anytime you like.
{{-}}
[[File:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04/release/]]
'''Edubuntu 14.04.3''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit])
{{-}}

=== Online Demonstration ===
You can also try an online demonstration of Gramps on rollApp:
* https://www.rollapp.com/app/gramps
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''

{{man note|Note|This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}
{{-}}

== Linux and BSD distributions ==
{{man note|These packages are built and supported by the distros.|Please report any problems with them to the package maintainer.}}
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[File:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|Debian 7 ("wheezy") (old stable): Gramps 3.4.0 Debian 8 ("jessie")(stable): Gramps 4.1.1 Debian 8 ("jessie")(backports): Gramps 4.2.5 stretch (testing): Gramps 4.2.5 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.2.5
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[File:Ubuntu_32x32.png]]''' Ubuntu '''
|Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Trusty (14.04 LTS): Gramps: 4.0.3 Trusty Backports (14.04 LTS): Gramps: 4.0.4 Xenial (16.04 LTS): Gramps: 4.2.2 Yakkety (16.10): Gramps: 4.2.3 Zesty (Development: 17.04): Gramps: 4.2.5
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|'''Linux Mint'''
|Software Manager
|Qiana/Rosa 17(Gramps 4.0.3+dfsg-2) Sarah/Serena 18(Gramps 4.2.2~dfsg-1)
|[http://community.linuxmint.com/software/view/gramps available versions]
|-
|[[File:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Rawhide (Gramps 4.2.5) Fedora 25 (Gramps 4.2.5) Fedora 24 (Gramps 4.2.5)
|[https://apps.fedoraproject.org/packages/gramps available versions] / Note:The Fedora and Red Hat Projects were merged on September 22, 2003.
|-
|'''[https://www.mageia.org/en/ Mageia]'''
||[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|Mageia Caulron: Gramps 4.2.5 Mageia 5.0: Gramps 4.1.3
|[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
|-
|''' openSUSE '''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|openSUSE Tumbleweed: Gramps 4.2.5 openSUSE Leap 42.2: Gramps 4.2.4 openSUSE 13.2: Gramps 4.0.4
|[http://software.opensuse.org/package/gramps available versions] See note [http://gramps.1791082.n4.nabble.com/ahnenforschung-familie-ihle-de-td4672224.html#a4672266] : Gramps 4.2 can be installed on Opensuse 13.2 ( if you add the 'openSUSE BuildService - GNOME:Apps' )
|-
|'''Slackware'''
|
|14.2: Gramps 3.4.3 14.1: Gramps 4.0.3
|[http://pkgs.org/search/?keyword=gramps available versions] [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]: Gramps 4.2.4
|-
|'''[https://www.netbsd.org/ NetBSD]'''
|
|NetBSD: Gramps 3.4.4
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''[https://www.freebsd.org/ FreeBSD]'''
|
|FreeBSD: Gramps 4.2.4
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''TrueOS'''
|
|PC-BSD: Gramps 3.4.8
|[http://web.pcbsd.org/pc-bsd-is-now-trueos/ 2016/09/01 - PC-BSD is now TrueOS]
|-
|'''[https://www.openbsd.org/ OpenBSD]'''
|
|OpenBSD: Gramps 4.2.5
|[http://openports.se/misc/gramps available versions]
|-
|'''Arch Linux'''
|
| Gramps 4.2.5
|[https://www.archlinux.org/packages/community/any/gramps/ available versions]
|-
|'''Gentoo Linux'''
|
| Gramps 4.2.4
|[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|-
|
|
|
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.

{{man warn|1=Warning before attempting this use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

=== Debian-based ===
For [[Image:Debianopenlogo-32.png]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[Image:Ubuntu_32x32.png]]''' Ubuntu ''') [{{github_url}}/releases/v{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i python3-gramps_{{version}}-1_all.deb

If you have an error about having unmet dependencies run:

sudo apt-get -f install

to install the dependencies.

==== Useful command lines ====
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:

* Find out what version you are running, by using this:

dpkg-query -s python3-gramps

that queries the package and gives you info about it.

* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :

sudo dpkg -r python3-gramps

this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )

* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:

sudo apt-mark hold gramps

'''Upgrade is then complete.'''

=== For other distributions ===
For other distributions, [[Image:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data. See : [[How to make a backup]]

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (29.0 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report packaging issues to the author.]''' (2012-09-07)

[4]
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind. [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]

== See also ==
* [[Previous releases of Gramps]]

[[Category:Documentation]]

Download

2016-11-29T16:14:13Z

RossGammon: Vivid & Wily no longer supported by Ubuntu

{{languages}}

'''Research, organize and share your family tree with Gramps.'''

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

{{man note|{{Man menu|'''Current version: {{version}} Released: 2016-09-04'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Lot of updates see:.''[[Gramps_4.2_Wiki_Manual_-_What's_new%3F|What's new?]]}}

{{man warn|''Legacy version: 3.4.9 Released: 2015-04-30|This is the final maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x and version 4.2.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2015/04/gramps-3-4-9-released/]}}

== Linux ==

[[File:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[File:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

Supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.(''Please note: Python-3.5 and Gtk-3.18 dropped support for Windows XP not Gramps itself. Gramps can still be run on Windows XP with older versions of those libraries eg:(Gtk-3.16 & Python3.4.4)'')

<big>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

{{man tip|Shortcuts|Once installed one shortcut is placed on the desktop and in the Start menu three shortcuts are added, please only use the first shortcut, unless requested by a developer. 1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut for everyday use of Gramps}} 2) ''GrampsAIO'''XX''' ''{{version}}''-console 3) ''GrampsAIO'''XX''' ''{{version}}''-debug}}

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only).

Alternative independent '''Legacy''' MS Windows version [[#3|[3]]].

You may also install using the alternative independent Gramps Chocolatey Package [[#4|[4]]].

== Mac OS X ==

[[File:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Supports Mac OS X in all versions 10.5 (Leopard) and later.

<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{man tip|Spell Checking:|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [http://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}

{{-}}

== BSD ==

[[File:Bsd daemon.jpg|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[File:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu 14.04.3] and Gramps from the CD anytime you like.
{{-}}
[[File:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04/release/]]
'''Edubuntu 14.04.3''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit])
{{-}}

=== Online Demonstration ===
You can also try an online demonstration of Gramps on rollApp:
* https://www.rollapp.com/app/gramps
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''

{{man note|Note|This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}
{{-}}

== Linux and BSD distributions ==
{{man note|These packages are built and supported by the distros.|Please report any problems with them to the package maintainer.}}
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

— current stable release
Debian 7 ("wheezy") — obsolete stable release
— obsolete stable release

{| {{prettytable}}
!Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[File:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|Debian 7 ("wheezy") (old stable): Gramps 3.4.0 Debian 8 ("jessie")(stable): Gramps 4.1.1 Debian 8 ("jessie")(backports): Gramps 4.2.4 stretch (testing): Gramps 4.2.4 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.2.4
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[File:Ubuntu_32x32.png]]''' Ubuntu '''
|Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Trusty (14.04 LTS): Gramps: 4.0.3 Trusty Backports (14.04 LTS): Gramps: 4.0.4 Xenial (16.04 LTS): Gramps: 4.2.2 Yakkety (16.10): Gramps: 4.2.3 Zesty (Development: 17.04): Gramps: 4.2.4
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|'''Linux Mint'''
|Software Manager
|Isadora (Gramps 3.2.0-1) Lisa (Gramps 3.3.1-1) Olivia (Gramps 3.4.0-1) Qiana (Gramps 4.0.3+dfsg-2) Sarah (Gramps 4.2.2~dfsg-1)
|[http://community.linuxmint.com/software/view/gramps available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Rawhide (Gramps 4.2.4) Fedora 25 (Gramps 4.2.4) Fedora 24 (Gramps 4.2.4) Fedora 23 (Gramps 4.2.4)
|[https://apps.fedoraproject.org/packages/gramps available versions]
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|Package Management Tool([https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/5/html/Deployment_Guide/ch-graphical-rpm.html pirut])
|
|The Fedora and Red Hat Projects were merged on September 22, 2003. See Fedora.
|-
|'''[https://www.mageia.org/en/ Mageia]'''
||[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|Mageia Caulron: Gramps 4.2.4 Mageia 5.0: Gramps 4.1.3
|[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
|-
|''' openSUSE '''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|openSUSE Tumbleweed: Gramps 4.2.4 openSUSE Leap 42.1: Gramps 4.2.0 openSUSE 13.2: Gramps 4.0.4
|[http://software.opensuse.org/package/gramps available versions] See note [http://gramps.1791082.n4.nabble.com/ahnenforschung-familie-ihle-de-td4672224.html#a4672266] : Gramps 4.2 can be installed on Opensuse 13.2 ( if you add the 'openSUSE BuildService - GNOME:Apps' )
|-
|'''Slackware'''
|
|Slackware 14.1: Gramps 4.0.3
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.4
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 4.2.3
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.4.8
|
|-
|'''OpenBSD'''
|
|OpenBSD: Gramps 4.2.3
|[http://openports.se/misc/gramps available versions]
|-
|'''Arch Linux'''
|
| Gramps 4.2.4
|[https://www.archlinux.org/packages/community/any/gramps/ available versions]
|-
|'''Gentoo Linux'''
|
| Gramps 4.2.4
|[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|-
|
|
|
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [{{github_url}}/releases/v{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i python-gramps_{{version}}-1_all.deb
or
sudo dpkg -i python3-gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (29.0 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report packaging issues to the author.]''' (2012-09-07)

[4]
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind. [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]

== See also ==
* [[Previous releases of Gramps]]

[[Category:Documentation]]

Download

2016-11-29T16:09:55Z

RossGammon: Add Debian Jessie backports

{{languages}}

'''Research, organize and share your family tree with Gramps.'''

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

{{man note|{{Man menu|'''Current version: {{version}} Released: 2016-09-04'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Lot of updates see:.''[[Gramps_4.2_Wiki_Manual_-_What's_new%3F|What's new?]]}}

{{man warn|''Legacy version: 3.4.9 Released: 2015-04-30|This is the final maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x and version 4.2.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2015/04/gramps-3-4-9-released/]}}

== Linux ==

[[File:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[File:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

Supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.(''Please note: Python-3.5 and Gtk-3.18 dropped support for Windows XP not Gramps itself. Gramps can still be run on Windows XP with older versions of those libraries eg:(Gtk-3.16 & Python3.4.4)'')

<big>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

{{man tip|Shortcuts|Once installed one shortcut is placed on the desktop and in the Start menu three shortcuts are added, please only use the first shortcut, unless requested by a developer. 1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut for everyday use of Gramps}} 2) ''GrampsAIO'''XX''' ''{{version}}''-console 3) ''GrampsAIO'''XX''' ''{{version}}''-debug}}

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only).

Alternative independent '''Legacy''' MS Windows version [[#3|[3]]].

You may also install using the alternative independent Gramps Chocolatey Package [[#4|[4]]].

== Mac OS X ==

[[File:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Supports Mac OS X in all versions 10.5 (Leopard) and later.

<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
<big>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{man tip|Spell Checking:|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [http://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}

{{-}}

== BSD ==

[[File:Bsd daemon.jpg|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[File:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu 14.04.3] and Gramps from the CD anytime you like.
{{-}}
[[File:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04/release/]]
'''Edubuntu 14.04.3''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit])
{{-}}

=== Online Demonstration ===
You can also try an online demonstration of Gramps on rollApp:
* https://www.rollapp.com/app/gramps
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''

{{man note|Note|This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}
{{-}}

== Linux and BSD distributions ==
{{man note|These packages are built and supported by the distros.|Please report any problems with them to the package maintainer.}}
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

— current stable release
Debian 7 ("wheezy") — obsolete stable release
— obsolete stable release

{| {{prettytable}}
!Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[File:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|Debian 7 ("wheezy") (old stable): Gramps 3.4.0 Debian 8 ("jessie")(stable): Gramps 4.1.1 Debian 8 ("jessie")(backports): Gramps 4.2.4 stretch (testing): Gramps 4.2.4 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.2.4
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[File:Ubuntu_32x32.png]]''' Ubuntu '''
|Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Trusty (14.04 LTS): Gramps: 4.0.3 Trusty Backports (14.04 LTS): Gramps: 4.0.4 Vivid (15.04): Gramps: 4.1.1 Wily (15.10): Gramps: 4.2.0 Xenial (16.04 LTS): Gramps: 4.2.2 Yakkety (16.10): Gramps: 4.2.3 Zesty (Development: 17.04): Gramps: 4.2.4
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|'''Linux Mint'''
|Software Manager
|Isadora (Gramps 3.2.0-1) Lisa (Gramps 3.3.1-1) Olivia (Gramps 3.4.0-1) Qiana (Gramps 4.0.3+dfsg-2) Sarah (Gramps 4.2.2~dfsg-1)
|[http://community.linuxmint.com/software/view/gramps available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Rawhide (Gramps 4.2.4) Fedora 25 (Gramps 4.2.4) Fedora 24 (Gramps 4.2.4) Fedora 23 (Gramps 4.2.4)
|[https://apps.fedoraproject.org/packages/gramps available versions]
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|Package Management Tool([https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/5/html/Deployment_Guide/ch-graphical-rpm.html pirut])
|
|The Fedora and Red Hat Projects were merged on September 22, 2003. See Fedora.
|-
|'''[https://www.mageia.org/en/ Mageia]'''
||[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|Mageia Caulron: Gramps 4.2.4 Mageia 5.0: Gramps 4.1.3
|[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
|-
|''' openSUSE '''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|openSUSE Tumbleweed: Gramps 4.2.4 openSUSE Leap 42.1: Gramps 4.2.0 openSUSE 13.2: Gramps 4.0.4
|[http://software.opensuse.org/package/gramps available versions] See note [http://gramps.1791082.n4.nabble.com/ahnenforschung-familie-ihle-de-td4672224.html#a4672266] : Gramps 4.2 can be installed on Opensuse 13.2 ( if you add the 'openSUSE BuildService - GNOME:Apps' )
|-
|'''Slackware'''
|
|Slackware 14.1: Gramps 4.0.3
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.4
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 4.2.3
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.4.8
|
|-
|'''OpenBSD'''
|
|OpenBSD: Gramps 4.2.3
|[http://openports.se/misc/gramps available versions]
|-
|'''Arch Linux'''
|
| Gramps 4.2.4
|[https://www.archlinux.org/packages/community/any/gramps/ available versions]
|-
|'''Gentoo Linux'''
|
| Gramps 4.2.4
|[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|-
|
|
|
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [{{github_url}}/releases/v{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i python-gramps_{{version}}-1_all.deb
or
sudo dpkg -i python3-gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (29.0 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report packaging issues to the author.]''' (2012-09-07)

[4]
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind. [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]

== See also ==
* [[Previous releases of Gramps]]

[[Category:Documentation]]

Download

2015-08-23T07:36:48Z

RossGammon: Update latest in Debian & Ubuntu

__NOTOC__
{{languages}}

{{man note|{{Man menu|'''Current version: {{version}} Released: 2015-08-02'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Lot of updates see:.''[[Gramps_4.2_Wiki_Manual_-_What's_new%3F|What's new?]]}}

{{man warn|''Legacy version: 3.4.9 Released: 2015-04-30|This is a maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x and version 4.2.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2015/04/gramps-3-4-9-released/]}}

== Linux ==

[[Image:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

{{man tip|Shortcuts|Once installed one shortcut is placed on the desktop and in the Start menu three shortcuts are added, please only use the first shortcut, unless requested by a developer. 1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut for everyday use of Gramps}} 2) ''GrampsAIO'''XX''' ''{{version}}''-console 3) ''GrampsAIO'''XX''' ''{{version}}''-debug}}

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only).

Alternative independent '''Legacy''' MS Windows version [[#3|[3]]].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.
Supports Mac OS X in all versions 10.5 (Leopard) and later.

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{man tip|Spell Checking:|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [http://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}

{{-}}

== BSD ==

[[File:Bsd daemon.jpg|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu 14.04.2] and Gramps from the CD anytime you like.
{{-}}
[[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04.2/release/]]
'''Edubuntu 14.04.2''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit])
{{-}}

== Linux and BSD distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|squeeze (old old stable): Gramps 3.2.3 wheezy (old stable): Gramps 3.4.0 jessie (stable): Gramps 4.1.1 stretch (testing): Gramps 4.2.0 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.2.0
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Trusty (14.04 LTS): Gramps: 4.0.3 Trusty Backports (14.04 LTS): Gramps: 4.0.4 Vivid (15.04): Gramps: 4.1.1 Wily (Development): Gramps: 4.2.0
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|'''Linux Mint'''
|Software Manager
|Isadora (Gramps 3.2.0-1) Lisa (Gramps 3.3.1-1) Olivia (Gramps 3.4.0-1) Qiana (Gramps 4.0.3+dfsg-2)
|[http://community.linuxmint.com/software/view/gramps available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Rawhide (Gramps 4.1.3) Fedora 23 (Gramps 4.1.3) Fedora 22 (Gramps 4.1.3) Fedora 21 (Gramps 4.1.3)
|[https://apps.fedoraproject.org/packages/gramps available versions]
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|Package Management Tool([https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/5/html/Deployment_Guide/ch-graphical-rpm.html pirut])
|
|The Fedora and Red Hat Projects were merged on September 22, 2003. See Fedora.
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6
|See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|'''[https://www.mageia.org/en/ Mageia]'''
|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|Mageia 4.1: Gramps 4.0.1 Mageia 5.0RC: Gramps 4.1.1
|
|-
|''' openSUSE '''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|openSUSE Tumbleweed: Gramps 4.1.3 openSUSE 13.2: Gramps 4.0.4
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.1: Gramps 4.0.3
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.4
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 3.4.8
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.4.8
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i python-gramps_{{version}}-1_all.deb
or
sudo dpkg -i python3-gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (29.0 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Download

2015-08-11T21:50:35Z

RossGammon: Update Debian & Ubuntu

__NOTOC__
{{languages}}

:{{Man menu|'''Current version: {{version}} Released: 2015-08-02'''}} - ''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Lot of updates see:.''[[Gramps_4.2_Wiki_Manual_-_What's_new%3F|What's new?]]

:''Legacy version: 3.4.9 Released: 2015-04-30 - This is a maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x and version 4.2.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2015/04/gramps-3-4-9-released/]

== Linux ==

[[Image:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

{{man tip|Shortcuts|Once installed three shortcuts are placed on the desktop and in the Start menu, please only use the first shortcut, unless requested by a developer. 1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut for everyday use of Gramps}} 2) ''GrampsAIO'''XX''' ''{{version}}''-console 3) ''GrampsAIO'''XX''' ''{{version}}''-debug}}

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only).

Alternative independent '''Legacy''' MS Windows version [[#3|[3]]].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.
Supports Mac OS X in all versions 10.5 (Leopard) and later.

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{man tip|Spell Checking:|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [http://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}

{{-}}

== BSD ==

[[File:Bsd daemon.jpg|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu 14.04.2] and Gramps from the CD anytime you like.
{{-}}
[[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04.2/release/]]
'''Edubuntu 14.04.2''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit])
{{-}}

== Linux and BSD distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|squeeze (old old stable): Gramps 3.2.3 wheezy (old stable): Gramps 3.4.0 jessie (stable): Gramps 4.1.1 stretch (testing): Gramps 4.1.3 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.2.0
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Trusty (14.04 LTS): Gramps: 4.0.3 Trusty Backports (14.04 LTS): Gramps: 4.0.4 Vivid (15.04): Gramps: 4.1.1 Wily (Development): Gramps: 4.1.3
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|'''Linux Mint'''
|Software Manager
|Isadora (Gramps 3.2.0-1) Lisa (Gramps 3.3.1-1) Olivia (Gramps 3.4.0-1) Qiana (Gramps 4.0.3+dfsg-2)
|[http://community.linuxmint.com/software/view/gramps available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Rawhide (Gramps 4.1.3) Fedora 23 (Gramps 4.1.3) Fedora 22 (Gramps 4.1.3) Fedora 21 (Gramps 4.1.3)
|[https://apps.fedoraproject.org/packages/gramps available versions]
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|Package Management Tool([https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/5/html/Deployment_Guide/ch-graphical-rpm.html pirut])
|
|The Fedora and Red Hat Projects were merged on September 22, 2003. See Fedora.
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6
|See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|'''[https://www.mageia.org/en/ Mageia]'''
|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|Mageia 4.1: Gramps 4.0.1 Mageia 5.0RC: Gramps 4.1.1
|
|-
|''' openSUSE '''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|openSUSE Tumbleweed: Gramps 4.1.3 openSUSE 13.2: Gramps 4.0.4
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.1: Gramps 4.0.3
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.4
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 3.4.8
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.4.8
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i python-gramps_{{version}}-1_all.deb
or
sudo dpkg -i python3-gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (29.0 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Download

2015-05-07T15:39:18Z

RossGammon: /* Linux and BSD distributions */

__NOTOC__
{{languages}}

:{{Man menu|'''Current version: {{version}} Released: 2015/05/01'''}} - ''Different data format to the GRAMPS 3.4 series. Full Python 3 support. Conversion to GTK+ 3. New place hierarchies model.''[https://gramps-project.org/wiki/index.php?title=Gramps_4.1_Wiki_Manual_-_What%27s_new%3F#Place_hierarchies]

:''Legacy version: 3.4.9 Released: 2015/04/30 - This is a maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2015/04/gramps-3-4-9-released/]

== Linux ==

[[Image:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only).

Alternative independent '''Legacy''' MS Windows version [[#3|[3]]].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Mac OS X 10.5, 10.6, 10.7, 10.8, and 10.9     <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
Mac OS X 10.5    <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{-}}

== BSD ==

[[File:Bsd daemon.jpg|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu 14.04.1] and Gramps from the CD anytime you like.
{{-}}
[[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04.2/release/]]
'''Edubuntu 14.04.2''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit])
{{-}}

== Linux and BSD distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|squeeze (old old stable): Gramps 3.2.3 wheezy (old stable): Gramps 3.4.0 jessie (stable): Gramps 4.1.1 stretch (testing): Gramps 4.1.2 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.1.2
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Trusty (14.04 LTS): Gramps: 4.0.3 Trusty Backports (14.04 LTS): Gramps: 4.0.4 Utopic (14.10): Gramps: 4.0.4 Vivid (15.04): Gramps: 4.1.1 Wily (Development): Gramps: 4.1.2
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|'''Linux Mint'''
|Software Manager
|Isadora (Gramps 3.2.0-1) Lisa (Gramps 3.3.1-1) Olivia (Gramps 3.4.0-1) Qiana (Gramps 4.0.3+dfsg-2)
|[http://community.linuxmint.com/software/view/gramps available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Rawhide (Gramps 4.1.2) Fedora 21 (Gramps 4.1.2) Fedora 20 (Gramps 4.1.2)
|[https://apps.fedoraproject.org/packages/gramps available versions]
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|Package Management Tool([https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/5/html/Deployment_Guide/ch-graphical-rpm.html pirut])
|
|The Fedora and Red Hat Projects were merged on September 22, 2003. See Fedora.
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6
|See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|'''[https://www.mageia.org/en/ Mageia]'''
|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|Mageia 4.1: Gramps 4.0.1 Mageia 5.0RC: Gramps 4.1.1
|
|-
|''' openSUSE '''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|openSUSE Tumbleweed: Gramps 4.1.2 openSUSE 13.2: Gramps 4.0.4
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.1: Gramps 4.0.3
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.4
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 3.4.8
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.4.8
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i python-gramps_{{version}}-1_all.deb
or
sudo dpkg -i python3-gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (29.0 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Download

2015-04-26T10:43:44Z

RossGammon: /* Linux and BSD distributions */

__NOTOC__
{{languages}}

:{{Man menu|'''Current version: {{version}} Released: 2015/02/28'''}} - ''Different data format to the GRAMPS 3.4 series. Full Python 3 support. Conversion to GTK+ 3. New place hierarchies model.''[https://gramps-project.org/wiki/index.php?title=Gramps_4.1_Wiki_Manual_-_What%27s_new%3F#Place_hierarchies]

:''Legacy version: 3.4.8 Released: 2014/05/31 - This is a maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.x (not version 4.1.x) and 3.4.x branch, most differences are into interface...''[https://gramps-project.org/2014/05/gramps-3-4-8-released/]

== Linux ==

[[Image:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Use the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO-4|this page]] (English only).

Alternative independent '''Legacy''' MS Windows version [[#3|[3]]].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Mac OS X 10.5, 10.6, 10.7, 10.8, and 10.9     <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
Mac OS X 10.5    <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{-}}

== BSD ==

[[File:Bsd daemon.jpg|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu 14.04.1] and Gramps from the CD anytime you like.
{{-}}
[[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04.2/release/]]
'''Edubuntu 14.04.2''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit])
{{-}}

== Linux and BSD distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| {{prettytable}}
!Distribution
!GUI Package manager
!Current versions
!Notes
|-
|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|wheezy (old stable): Gramps 3.4.0 jessie (stable): Gramps 4.1.1 stretch (testing): Gramps 4.1.1 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.1.2
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Trusty (14.04 LTS): Gramps: 4.0.3 Utopic (14.10): Gramps: 4.0.4 Vivid (Development): Gramps: 4.1.1
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|'''Linux Mint'''
|Software Manager
|Isadora (Gramps 3.2.0-1) Lisa (Gramps 3.3.1-1) Olivia (Gramps 3.4.0-1) Qiana (Gramps 4.0.3+dfsg-2)
|[http://community.linuxmint.com/software/view/gramps available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Rawhide (Gramps 4.1.2) Fedora 21 (Gramps 4.1.1) Fedora 20 (Gramps 4.0.3) Fedora 19 (Gramps 3.4.8) Fedora EPEL 6 (Gramps 3.4.8)
|[https://apps.fedoraproject.org/packages/gramps available versions]
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|Package Management Tool([https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/5/html/Deployment_Guide/ch-graphical-rpm.html pirut])
|
|
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6
|See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|''' Mageia '''
|
|
|
|-
|''' openSUSE '''
|[https://en.opensuse.org/YaST_Software_Management YaST]
|openSUSE 13.2: Gramps 4.0.4
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.1: Gramps 4.0.3
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.4
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 3.4.8
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.4.8
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i python-gramps_{{version}}-1_all.deb
or
sudo dpkg -i python3-gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent '''Legacy''' version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Download

2014-06-08T20:29:55Z

RossGammon:

__NOTOC__
{{languages}}
== Linux ==

[[Image:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Alternative independent MS Windows version [[#3|[3]]].

Gramps 4.0.3, see [[Gramps_4.0_Wiki_Manual_-_What's_new%3F|what's new]], is also available. Download [http://sourceforge.net/projects/gramps/files/Stable/4.0.3/ here].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Mac OS X 10.5, 10.6, 10.7, 10.8, and 10.9     <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
Mac OS X 10.5    <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{-}}

== BSD ==

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. Allows you to trial a pre-installed Gramps {{Version Linux Live CD}}, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install [http://www.ubuntulinux.org/ Ubuntu 10.10] and Gramps from the CD anytime you like.
{{-}}
[[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/13.04/release/]]
'''Edubuntu 13.04''' includes Gramps 3.4.0
{{-}}

== Linux and BSD distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| border="1" cellspacing="0"
|Distribution
|GUI pkg manager
|Current versions
|Notes
|-
|'''Linux Mint'''
|Software Manager
|Nadia: Gramps 3.4.0-1 Lisa: Gramps 3.3.1-1 Isadora: Gramps 3.2.0-1
|
|-
|''' Mageia '''
|
|
|
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Saucy (13.10): Gramps 3.4.0 Trusty (14.04 LTS): Gramps: 4.0.3 Utopic (development): Gramps: 4.0.4
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Fedora Rawhide: Gramps 3.4.3 Fedora 18: Gramps 3.4.2.
|
|-
|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|squeeze (old stable): Gramps 3.2.3 wheezy (stable): Gramps 3.4.0 jessie (testing): Gramps 4.0.4 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.0.4
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6 See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|
|
|
|-
|''' openSUSE '''
|YaST ??
|openSUSE 12.3: Gramps 3.4.2
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.0: Gramps 3.4.2
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.3
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 3.3.0
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.3.0
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Download

2014-06-03T08:54:19Z

RossGammon: Update Debian & Ubuntu

__NOTOC__
{{languages}}
== Linux ==

[[Image:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Alternative independent MS Windows version [[#3|[3]]].

Gramps 4.0.3, see [[Gramps_4.0_Wiki_Manual_-_What's_new%3F|what's new]], is also available. Download [http://sourceforge.net/projects/gramps/files/Stable/4.0.3/ here].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Mac OS X 10.5, 10.6, 10.7, 10.8, and 10.9     <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
Mac OS X 10.5    <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{-}}

== BSD ==

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. Allows you to trial a pre-installed Gramps {{Version Linux Live CD}}, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install [http://www.ubuntulinux.org/ Ubuntu 10.10] and Gramps from the CD anytime you like.
{{-}}
[[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/13.04/release/]]
'''Edubuntu 13.04''' includes Gramps 3.4.0
{{-}}

== Linux and BSD distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| border="1" cellspacing="0"
|Distribution
|GUI pkg manager
|Current versions
|Notes
|-
|'''Linux Mint'''
|Software Manager
|Nadia: Gramps 3.4.0-1 Lisa: Gramps 3.3.1-1 Isadora: Gramps 3.2.0-1
|
|-
|''' Mageia '''
|
|
|
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Saucy (13.10): Gramps 3.4.0 Trusty (14.04 LTS): Gramps: 4.0.3 Utopic (development): Gramps: 4.0.4
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Fedora Rawhide: Gramps 3.4.3 Fedora 18: Gramps 3.4.2.
|
|-
|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|squeeze (old stable): Gramps 3.2.3 wheezy (stable): Gramps 3.4.0 jessie (testing): Gramps 4.0.3 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.0.4
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6 See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|
|
|
|-
|''' openSUSE '''
|YaST ??
|openSUSE 12.3: Gramps 3.4.2
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.0: Gramps 3.4.2
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.3
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 3.3.0
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.3.0
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Download

2014-05-31T19:27:51Z

RossGammon: Update Ubuntu

__NOTOC__
{{languages}}
== Linux ==

[[Image:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Alternative independent MS Windows version [[#3|[3]]].

Gramps 4.0.3, see [[Gramps_4.0_Wiki_Manual_-_What's_new%3F|what's new]], is also available. Download [http://sourceforge.net/projects/gramps/files/Stable/4.0.3/ here].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Mac OS X 10.5, 10.6, 10.7, 10.8, and 10.9     <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
Mac OS X 10.5    <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{-}}

== BSD ==

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. Allows you to trial a pre-installed Gramps {{Version Linux Live CD}}, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install [http://www.ubuntulinux.org/ Ubuntu 10.10] and Gramps from the CD anytime you like.
{{-}}
[[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/13.04/release/]]
'''Edubuntu 13.04''' includes Gramps 3.4.0
{{-}}

== Linux and BSD distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| border="1" cellspacing="0"
|Distribution
|GUI pkg manager
|Current versions
|Notes
|-
|'''Linux Mint'''
|Software Manager
|Nadia: Gramps 3.4.0-1 Lisa: Gramps 3.3.1-1 Isadora: Gramps 3.2.0-1
|
|-
|''' Mageia '''
|
|
|
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Precise (12.04 LTS): Gramps 3.3.1 Saucy (13.10): Gramps 3.4.0 Trusty (14.04 LTS): Gramps: 4.0.3 Utopic (development): Gramps: 4.0.3
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Fedora Rawhide: Gramps 3.4.3 Fedora 18: Gramps 3.4.2.
|
|-
|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|squeeze (old stable): Gramps 3.2.3 wheezy (stable): Gramps 3.4.0 jessie (testing): Gramps 4.0.3 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.0.3
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6 See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|
|
|
|-
|''' openSUSE '''
|YaST ??
|openSUSE 12.3: Gramps 3.4.2
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.0: Gramps 3.4.2
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.3
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 3.3.0
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.3.0
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Download

2014-05-31T19:18:08Z

RossGammon: Update Debian

__NOTOC__
{{languages}}
== Linux ==

[[Image:Linux_220x261.png|128px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</big>

After download: double-click to install Gramps.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Alternative independent MS Windows version [[#3|[3]]].

Gramps 4.0.3, see [[Gramps_4.0_Wiki_Manual_-_What's_new%3F|what's new]], is also available. Download [http://sourceforge.net/projects/gramps/files/Stable/4.0.3/ here].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Mac OS X 10.5, 10.6, 10.7, 10.8, and 10.9     <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_intel}}.dmg Intel {{version_Mac}}]</big>
    
Mac OS X 10.5    <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/{{filename_mac_ppc}}.dmg Power PC {{version_Mac}}]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

{{-}}

== BSD ==

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>
[[Download#Linux and BSD distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. Allows you to trial a pre-installed Gramps {{Version Linux Live CD}}, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install [http://www.ubuntulinux.org/ Ubuntu 10.10] and Gramps from the CD anytime you like.
{{-}}
[[Image:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/13.04/release/]]
'''Edubuntu 13.04''' includes Gramps 3.4.0
{{-}}

== Linux and BSD distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| border="1" cellspacing="0"
|Distribution
|GUI pkg manager
|Current versions
|Notes
|-
|'''Linux Mint'''
|Software Manager
|Nadia: Gramps 3.4.0-1 Lisa: Gramps 3.3.1-1 Isadora: Gramps 3.2.0-1
|
|-
|''' Mageia '''
|
|
|
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Quantal: Gramps 3.4.0-1
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Fedora Rawhide: Gramps 3.4.3 Fedora 18: Gramps 3.4.2.
|
|-
|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''
|Add/Remove Software
|squeeze (old stable): Gramps 3.2.3 wheezy (stable): Gramps 3.4.0 jessie (testing): Gramps 4.0.3 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.0.3
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6 See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|
|
|
|-
|''' openSUSE '''
|YaST ??
|openSUSE 12.3: Gramps 3.4.2
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.0: Gramps 3.4.2
|[http://pkgs.org/search/?keyword=gramps available versions]
|-
|'''NetBSD'''
|
|NetBSD: Gramps 3.4.3
|[http://pkgsrc.se/databases/gramps3 available versions]
|-
|'''FreeBSD'''
|
|FreeBSD: Gramps 3.3.0
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|'''PC-BSD'''
|
|PC-BSD: Gramps 3.3.0
|
|}

{{-}}

== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Debianopenlogo-32.png]]'''[[Debian]]''' and [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [http://sourceforge.net/projects/gramps/files/Stable/{{version}} Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved (change the filename to match the one you downloaded).

sudo dpkg -i gramps_{{version}}-1_all.deb

For other distributions, [[Image:Download_link.png|150px|link=http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz]] the source and follow the instructions for [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Gramps 4.0 Wiki Manual - Entering and editing data: detailed - part 3

2013-07-26T16:13:12Z

RossGammon: /* Merging records */ Desribed how the Family Merge function works.

{{grampsmanualcopyright}}

{{man index|Gramps 4.0 Wiki Manual - Entering and Editing Data:_Detailed - part 2|Gramps_4.0_Wiki_Manual_-_Navigation|4.0}}

{{languages|Gramps_4.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_3}}

{{#vardefine:chapter|7.3}}
{{#vardefine:figure|0}}

The previous section offered you a detailed overview of how to enter and edit the main objects you see in Gramps. This section continues with some objects you will encounter as part of sources, persons, ...

{{out of date|still needs a once over}}

== Name Editor ==

Names are edited through the {{man label|Name Editor}} dialog:

[[Image:EditPerson-NameEditorWindow-40.png|thumb|400px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Name Editor]]

The top of the window allows entry of the type of name (e.g., Birth Name, Married Name, etc) from a dropdown list. Next are elements of the personal name most commonly grouped together as Given Name elements. Following the Given Name section is the Family Names section. At the bottom are elements allowing for customization of name sorting, dates for names, name sources and notes for names.

{{man tip|Tip|The tab labels reflect the presence of corresponding information: if the tab contains any data, its label appears '''boldface'''; if the tab has no data then its label appears regular (not bold).}}

{{-}}

===Type===

The Name Type dropdown list allows you to select the type of name being entered.

=== Given Names Section ===

The Given Names Section contains all parts of a personal name you can store with Gramps.

*{{man label|Given}}, The person's given names should all be entered here.
*{{man label|Call Name}}, The person's proper legal name that was used most commonly by the person should be entered here. For example, someone named John Raymond Smith who uses the name Raymond should have ''Raymond'' entered here. If this person uses ''Ray'' commonly, this should be entered as a nickname since Ray is not the proper legal name (see following). In Germany and some other places, it was custom to underline the callname among the different given names (see also [http://www.gramps-project.org/wiki/index.php?title=CallName here]).
*{{man label|Title}}, The person's personal title, such as Doctor (or Dr.) can be entered here.
*{{man label|Suffix}}, The person's personal name suffix, such as Junior (Jr.) or III, should be entered here.
*{{man label|Nick Name}}, The person's nickname should be entered here. Nicknames include shortenings of proper legal names such as Greg for Gregory (cf. Call Name above).

===Family Names Section===

The Family Names Section contains the person's family name elements. Gramps allows for multiple family names as well as multiple kinds of family names.

*A {{man label|Prefix}} for the family name that is not used in sorting (such as "de" or "van").
*{{man label|Surname}} for the main portion of one's family name.
*{{man label|Connector}} often used in matronymic or patronymic naming schemes, such as ''dotter''.
*{{man label|Origin}} indicating the type of family name this is and its derivation.
*{{man label|Family Nick Name}} for families commonly referred to using a more vernacular nick name.

See also: [[Names in Gramps|Names wiki entry]]

Check the {{man label|Private record}} icon in the top right corner to mark this name record as private. This will give you a chance to omit this name from being included in reports, if you choose so among the report generation options.

===General tab===

{{man label|Options}} allow you to adjust specific grouping, sorting, and displaying properties of this name, as well as to provide the date corresponding to the name.

* The {{man label|Grouping}} field provides an alternative grouping node for a name in the person view, overriding the default grouping based on the family name. This may be necessary with similar family names that need to be grouped together -- for example Russian names Ivanov and Ivanova are considered the same, but difference in gender is reflected in different spelling. To enable typing into this field, check the {{man label|Override}} check button.
:People are displayed according to the name format given in the Preferences (the default).
:Here you can make sure this person is displayed according to a custom name format (extra formats can be set in the Preferences).
*The {{man label|Sort as}} and {{man label|Display as}} determine the manner in which the name appears in the People View and in the reports. The sort as allows you to override the name pattern set in the Gramps preferences in sorting of the name. For example, you suddenly have a branch of Swedish names with given and patronymic, but the rest of your database sorts names on Family name, Given. You can indicate here to sort this name always as Patronymic, Given.
:Here you can make sure this person is sorted according to a custom name format (extra formats can be set in the Preferences).
:The display as allows you to say how the name is displayed. You might for example want to sort a name in a specific manner, but still have the display of the name as set in your preferences.
:The Person Tree view groups people under the primary surname. You can override this by setting here a group value. You will be asked if you want to group this person only, or all people with this specific primary surname.

*The {{man label|Date}} can provide information on the validity of this name -- use date spans as necessary. The edit date icon opens the [[Gramps_4.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_1#Editing_dates|Date Editor]]. Eg. for a Married Name, date the name is first used or marriage date.

===Citations tab===

The {{man label|Citations}} tab displays information about sources and citations relevant to this name and controls allowing its modification. The central part displays the list of all such citations and sources stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} allow you to correspondingly add, modify, and remove a citation to this name. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.

More info: [[Gramps_4.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_2#Editing_source_citations|Citations editor]]

===Note tab===

The {{man label|Note}} tab displays any notes concerning the name. To add a note or modify existing notes simply edit the text in the text entry field.

More info: [[Gramps_4.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_2#Editing_information_about_notes|Note Editor]]

== Attributes ==

[[Attributes]] are edited through the following {{man label|Attribute Editor}} dialog:

[[Image:EditPerson-AttributeTab-AttributeEditorWindow-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Attribute editor]]

The top of the window shows the dialog title including the name of the person whose attribute is being edited. The central part of the window displays three notebook tabs containing different categories of available information. You can bring any tab to the top for viewing or editing by clicking on the appropriate tab heading. The bottom part has {{man button|OK}} and {{man button|Cancel}} buttons. Clicking the {{man button|OK}} button at any time will apply all the changes made in all tabs and close the dialog window. Clicking the {{man button|Cancel}} button at any time will close the window without applying any changes.

{{man tip|Tip|The tab labels reflect the presence of corresponding information: if the tab contains any data, its label appears '''boldface'''; if the tab has no data then its label appears regular (not bold).}}

The top tab allows editing of the most general information about the attribute:
# The name of an {{man label|Attribute}} you want to use. For example: ''Height'' (for a person), ''Weather on this Day'' (for an event), ... Use this to store snippets of information you collect and want to correctly link to sources. Attributes can be used for people, families, events and media.
#The {{man label|Value}} of the attribute. Eg. ''1.8m, Sunny, or Blue eyes''.

The information can be typed in the appropriate text entry fields. The attribute name can also be selected from available choices (if any) listed in the {{man label|Attribute}} drop-down menu.

{{man note|Note|Some predefined attributes are present because the are defined in the GEDCOM standard.}}

Check the {{man label|Private record}} box to mark this attribute record as private. This will give you a chance to omit this attribute from being included in the reports, if you choose so among the report generation options.

*Source Citations

:The {{man label|Source Citations}} tab displays information about citations and sources relevant to this attribute and controls allowing its modification. The central part displays the list of all such sources and citations references stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} allow you to correspondingly add, modify, and remove a source reference to this attribute. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a citation/source reference is selected from the list.

*Notes

:The {{man label|Note}} tab displays any notes concerning the attribute. To add a note or modify existing notes simply edit the text in the text entry field.

The {{man label|Format}} option allows you to set the appearance of the note in the output (i.e. in reports and web pages). Selecting {{man label|Flowed}} will replace all multiple spaces, tabs, and single end-of-line characters with single space in the output. The two consecutive new lines (i.e. an empty line) denote a new paragraph. Selecting {{man label|Preformatted}} will honor all multiple spaces tabs, and new lines, so that the output will appear as it is entered into the text entry field.

== Addresses ==

[[Image:EditPerson-AddressesTab-AddressEditorWindow-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Address editor]]

Addresses are edited through the following {{man label|Address Editor}} dialog:

The top part shows the dialog title including the name of the person whose address is being edited. The central part of the window displays three notebook tabs containing different categories of available information. You can bring any tab to the top for viewing or editing by clicking on the appropriate tab heading. The bottom part has {{man button|OK}} and {{man button|Cancel}} buttons. Clicking the {{man button|OK}} button at any time will apply all the changes made in all tabs and close the dialog window. Clicking the {{man button|Cancel}} button at any time will close the window without applying any changes.

{{man tip|Tip|The tab labels reflect the presence of corresponding information: if the tab contains any data, its label appears '''boldface'''; if the tab has no data then its label appears regular (not bold).}}

It provides the following information categories of the address data:

The top of the window allows editing of the most general information about the address:
#{{man label|Date}}: Date at which the address is valid.
#{{man label|Street}}: The street of the address.
#{{man label|Locality}}: The locality name of the address.
#{{man label|City}}: The village or city of the address.
#{{man label|State/County}}: The state or county of the address in case a mail address must contain this.
#{{man label|Country}}: Country of the address.
#{{man label|ZIP/Postal code}}: Postal code.
#{{man label|Phone}}: Phone number linked to the address.

{{man tip|Note|Use Residence Event for genealogical address data.}}

The information can be typed in the appropriate text entry fields. Check the {{man label|Private record}} box to mark this address record as private. This will give you a chance to omit this address from being included in reports, if you choose so among the report generation options.

*Source Citations

:The {{man label|Source Citations}} tab displays information about sources relevant to this address and controls allowing its modification. The central part displays the list of all such sources and citations references stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} allow you to correspondingly add, modify, and remove a citation/source reference to this address. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.

*Notes

:The {{man label|Notes}} tab displays any notes concerning the address. To add a note or modify existing notes simply edit the text in the text entry field.

The {{man label|Format}} option allows you to set the appearance of the note in the output (i.e. in reports and web pages). Selecting {{man label|Flowed}} will replace all multiple spaces, tabs, and single end-of-line characters with single space in the output. The two consecutive new lines (i.e. an empty line) denote a new paragraph. Selecting {{man label|Preformatted}} will honor all multiple spaces tabs, and new lines, so that the output will appear as it is entered into the text entry field.

== Merging records ==

Sometime several records in the database turn out to be describing the same object: same person, same place, or same citation/source. It could happen either when the data is entered twice by mistake, or when new information reveals that the two entries refer to the same person. It can also happen after importing GEDCOM obtained from a relative, whose database overlaps with your existing data.

Whenever you detect duplicate records, merging them a useful way of correcting the situation.

{{man tip|1=Tip|2=To make a merge, exactly two records have to be selected in the appropriate view (People View, Sources View, or Places View). This is accomplished by selecting one entry and then selecting another person while holding down the {{man key press|Ctrl}} key.}}

===Merge People===

Merging two people is done from the Edit menu.

{{man note|Note|Merging people does not discard any information. The decisions you make during the merge only affect which data will become primary and which will become secondary for the resulting merged record.}}

*Merge
[[Image:Edit-MergePeople-DefaultWindow-40.png|left|thumb|200px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge people (regular view)]]
[[Image:Edit-MergePeople-ExpandedWindow-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge people (expanded view)]]

:When exactly two people are selected, choose '''Edit ->Merge...''' to invoke the {{man label|Merge}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged. If you decide that the records should not be merged, despite similar names, you may click {{man button|Cancel}} button to close the dialog without making any changes. Expanding the ''"Detailed Selection"'' and the ''"Context Information"'' fields on the bottom left (fig. 6.3.4) shows more information about the people to be merged.

If you decide to proceed with merging, select the appropriate {{man button|Select}} radio button to specify the record to be used as the source of primary data, then click {{man button|OK}}. The data from the other record will be kept as alternate data.

Specifically, all names from the other record will become alternate names of the merged record. Similarly, parents, spouses, and children of the other record will become alternate parents, spouses, and children of the merged record, and so on.

===Merge Families===

When exactly two families are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Families}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged. If you decide that the records should not be merged, despite being similar, you may click {{man button|Cancel}} to close the dialog without making any changes.

You can either choose one of the two families to be the source of the primary data for the new family, or by expanding the ''"Detailed Selection"'' field you can individually choose which father is the source of the primary data, which mother is the source of the primary data, and which family (selected by Gramps ID) is the source of the other primary data.

If you decide to proceed with merging, choose the appropriate {{man button|Select}} radio button(s) to specify the source(s) of the primary data to be used for the merged family record, and then click {{man button|OK}} . The children from both marriages are merged into the new family. The two fathers are merged together and the events from the secondary father are attached to the primary father. The names from the secondary father become alternate names for the primary father. The same occurs to the two mothers. The events related to the secondary family (e.g. marriage and any divorce) are transferred to the primary family. The secondary family, and the person record for the secondary father and mother are deleted from the database.

===Merge Events===

When exactly two events are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Events}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
*
*
to be used for the merged record, then click {{man button|OK}}

{{-}}

===Merge Sources===

[[Image:Edit-MergeSources-DefaultWindow-40.png|left|thumb|200px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge sources (regular)]]

[[Image:Edit-MergeSources-ExpandedWindow-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge sources (expanded)]]

When exactly two sources are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Sources}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
* Title
* Author
* Abbreviated title
* Publication information
* ID
to be used for the merged record, then click {{man button|OK}} .

{{-}}

===Merge Places===

[[Image:Edit-MergePlaces-DefaultWindow-40.png|thumb|left|200px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge places (regular)]]

[[Image:Edit-MergePlaces-ExpandedWindow-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge places (expanded)]]

When exactly two places are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Places}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
* Title
* Latitude
* Longitude
* Location
* ID
to be used for the merged record, then click {{man button|OK}}.

{{-}}

===Merge Media Objects===

When exactly two Media Objects are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Media Objects}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
*
*
to be used for the merged record, then click {{man button|OK}}

{{-}}

===Merge Repositories===

When exactly two repositories are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Repositories}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
*
*
to be used for the merged record, then click {{man button|OK}}

{{-}}

===Merge Notes===

When exactly two notes are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Notes}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
*
*
to be used for the merged record, then click {{man button|OK}}

{{-}}

{{man index|Gramps 4.0 Wiki Manual - Entering and Editing Data:_Detailed - part 2|Gramps_4.0_Wiki_Manual_-_Navigation|4.0}}

{{languages|Gramps_4.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_3}}

[[Category:Documentation]]

Gramps 4.1 Wiki Manual - Entering and editing data: detailed - part 3

2013-07-26T16:13:12Z

RossGammon: /* Merging records */ Desribed how the Family Merge function works.

{{grampsmanualcopyright}}

{{man index|Gramps 4.1 Wiki Manual - Entering and Editing Data:_Detailed - part 2|Gramps_4.1_Wiki_Manual_-_Navigation|4.1}}

{{languages|Gramps_4.1_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_3}}

{{#vardefine:chapter|7.3}}
{{#vardefine:figure|0}}

The previous section offered you a detailed overview of how to enter and edit the main objects you see in Gramps. This section continues with some objects you will encounter as part of sources, persons, ...

{{out of date|still needs a once over}}

== Name Editor ==

Names are edited through the {{man label|Name Editor}} dialog:

[[Image:EditPerson-NameEditorWindow-40.png|thumb|400px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Name Editor]]

The top of the window allows entry of the type of name (e.g., Birth Name, Married Name, etc) from a dropdown list. Next are elements of the personal name most commonly grouped together as Given Name elements. Following the Given Name section is the Family Names section. At the bottom are elements allowing for customization of name sorting, dates for names, name sources and notes for names.

{{man tip|Tip|The tab labels reflect the presence of corresponding information: if the tab contains any data, its label appears '''boldface'''; if the tab has no data then its label appears regular (not bold).}}

{{-}}

===Type===

The Name Type dropdown list allows you to select the type of name being entered.

=== Given Names Section ===

The Given Names Section contains all parts of a personal name you can store with Gramps.

*{{man label|Given}}, The person's given names should all be entered here.
*{{man label|Call Name}}, The person's proper legal name that was used most commonly by the person should be entered here. For example, someone named John Raymond Smith who uses the name Raymond should have ''Raymond'' entered here. If this person uses ''Ray'' commonly, this should be entered as a nickname since Ray is not the proper legal name (see following). In Germany and some other places, it was custom to underline the callname among the different given names (see also [http://www.gramps-project.org/wiki/index.php?title=CallName here]).
*{{man label|Title}}, The person's personal title, such as Doctor (or Dr.) can be entered here.
*{{man label|Suffix}}, The person's personal name suffix, such as Junior (Jr.) or III, should be entered here.
*{{man label|Nick Name}}, The person's nickname should be entered here. Nicknames include shortenings of proper legal names such as Greg for Gregory (cf. Call Name above).

===Family Names Section===

The Family Names Section contains the person's family name elements. Gramps allows for multiple family names as well as multiple kinds of family names.

*A {{man label|Prefix}} for the family name that is not used in sorting (such as "de" or "van").
*{{man label|Surname}} for the main portion of one's family name.
*{{man label|Connector}} often used in matronymic or patronymic naming schemes, such as ''dotter''.
*{{man label|Origin}} indicating the type of family name this is and its derivation.
*{{man label|Family Nick Name}} for families commonly referred to using a more vernacular nick name.

See also: [[Names in Gramps|Names wiki entry]]

Check the {{man label|Private record}} icon in the top right corner to mark this name record as private. This will give you a chance to omit this name from being included in reports, if you choose so among the report generation options.

===General tab===

{{man label|Options}} allow you to adjust specific grouping, sorting, and displaying properties of this name, as well as to provide the date corresponding to the name.

* The {{man label|Grouping}} field provides an alternative grouping node for a name in the person view, overriding the default grouping based on the family name. This may be necessary with similar family names that need to be grouped together -- for example Russian names Ivanov and Ivanova are considered the same, but difference in gender is reflected in different spelling. To enable typing into this field, check the {{man label|Override}} check button.
:People are displayed according to the name format given in the Preferences (the default).
:Here you can make sure this person is displayed according to a custom name format (extra formats can be set in the Preferences).
*The {{man label|Sort as}} and {{man label|Display as}} determine the manner in which the name appears in the People View and in the reports. The sort as allows you to override the name pattern set in the Gramps preferences in sorting of the name. For example, you suddenly have a branch of Swedish names with given and patronymic, but the rest of your database sorts names on Family name, Given. You can indicate here to sort this name always as Patronymic, Given.
:Here you can make sure this person is sorted according to a custom name format (extra formats can be set in the Preferences).
:The display as allows you to say how the name is displayed. You might for example want to sort a name in a specific manner, but still have the display of the name as set in your preferences.
:The Person Tree view groups people under the primary surname. You can override this by setting here a group value. You will be asked if you want to group this person only, or all people with this specific primary surname.

*The {{man label|Date}} can provide information on the validity of this name -- use date spans as necessary. The edit date icon opens the [[Gramps_4.1_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_1#Editing_dates|Date Editor]]. Eg. for a Married Name, date the name is first used or marriage date.

===Citations tab===

The {{man label|Citations}} tab displays information about sources and citations relevant to this name and controls allowing its modification. The central part displays the list of all such citations and sources stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} allow you to correspondingly add, modify, and remove a citation to this name. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.

More info: [[Gramps_4.1_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_2#Editing_source_citations|Citations editor]]

===Note tab===

The {{man label|Note}} tab displays any notes concerning the name. To add a note or modify existing notes simply edit the text in the text entry field.

More info: [[Gramps_4.1_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_2#Editing_information_about_notes|Note Editor]]

== Attributes ==

[[Attributes]] are edited through the following {{man label|Attribute Editor}} dialog:

[[Image:EditPerson-AttributeTab-AttributeEditorWindow-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Attribute editor]]

The top of the window shows the dialog title including the name of the person whose attribute is being edited. The central part of the window displays three notebook tabs containing different categories of available information. You can bring any tab to the top for viewing or editing by clicking on the appropriate tab heading. The bottom part has {{man button|OK}} and {{man button|Cancel}} buttons. Clicking the {{man button|OK}} button at any time will apply all the changes made in all tabs and close the dialog window. Clicking the {{man button|Cancel}} button at any time will close the window without applying any changes.

{{man tip|Tip|The tab labels reflect the presence of corresponding information: if the tab contains any data, its label appears '''boldface'''; if the tab has no data then its label appears regular (not bold).}}

The top tab allows editing of the most general information about the attribute:
# The name of an {{man label|Attribute}} you want to use. For example: ''Height'' (for a person), ''Weather on this Day'' (for an event), ... Use this to store snippets of information you collect and want to correctly link to sources. Attributes can be used for people, families, events and media.
#The {{man label|Value}} of the attribute. Eg. ''1.8m, Sunny, or Blue eyes''.

The information can be typed in the appropriate text entry fields. The attribute name can also be selected from available choices (if any) listed in the {{man label|Attribute}} drop-down menu.

{{man note|Note|Some predefined attributes are present because the are defined in the GEDCOM standard.}}

Check the {{man label|Private record}} box to mark this attribute record as private. This will give you a chance to omit this attribute from being included in the reports, if you choose so among the report generation options.

*Source Citations

:The {{man label|Source Citations}} tab displays information about citations and sources relevant to this attribute and controls allowing its modification. The central part displays the list of all such sources and citations references stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} allow you to correspondingly add, modify, and remove a source reference to this attribute. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a citation/source reference is selected from the list.

*Notes

:The {{man label|Note}} tab displays any notes concerning the attribute. To add a note or modify existing notes simply edit the text in the text entry field.

The {{man label|Format}} option allows you to set the appearance of the note in the output (i.e. in reports and web pages). Selecting {{man label|Flowed}} will replace all multiple spaces, tabs, and single end-of-line characters with single space in the output. The two consecutive new lines (i.e. an empty line) denote a new paragraph. Selecting {{man label|Preformatted}} will honor all multiple spaces tabs, and new lines, so that the output will appear as it is entered into the text entry field.

== Addresses ==

[[Image:EditPerson-AddressesTab-AddressEditorWindow-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Address editor]]

Addresses are edited through the following {{man label|Address Editor}} dialog:

The top part shows the dialog title including the name of the person whose address is being edited. The central part of the window displays three notebook tabs containing different categories of available information. You can bring any tab to the top for viewing or editing by clicking on the appropriate tab heading. The bottom part has {{man button|OK}} and {{man button|Cancel}} buttons. Clicking the {{man button|OK}} button at any time will apply all the changes made in all tabs and close the dialog window. Clicking the {{man button|Cancel}} button at any time will close the window without applying any changes.

{{man tip|Tip|The tab labels reflect the presence of corresponding information: if the tab contains any data, its label appears '''boldface'''; if the tab has no data then its label appears regular (not bold).}}

It provides the following information categories of the address data:

The top of the window allows editing of the most general information about the address:
#{{man label|Date}}: Date at which the address is valid.
#{{man label|Street}}: The street of the address.
#{{man label|Locality}}: The locality name of the address.
#{{man label|City}}: The village or city of the address.
#{{man label|State/County}}: The state or county of the address in case a mail address must contain this.
#{{man label|Country}}: Country of the address.
#{{man label|ZIP/Postal code}}: Postal code.
#{{man label|Phone}}: Phone number linked to the address.

{{man tip|Note|Use Residence Event for genealogical address data.}}

The information can be typed in the appropriate text entry fields. Check the {{man label|Private record}} box to mark this address record as private. This will give you a chance to omit this address from being included in reports, if you choose so among the report generation options.

*Source Citations

:The {{man label|Source Citations}} tab displays information about sources relevant to this address and controls allowing its modification. The central part displays the list of all such sources and citations references stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} allow you to correspondingly add, modify, and remove a citation/source reference to this address. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.

*Notes

:The {{man label|Notes}} tab displays any notes concerning the address. To add a note or modify existing notes simply edit the text in the text entry field.

The {{man label|Format}} option allows you to set the appearance of the note in the output (i.e. in reports and web pages). Selecting {{man label|Flowed}} will replace all multiple spaces, tabs, and single end-of-line characters with single space in the output. The two consecutive new lines (i.e. an empty line) denote a new paragraph. Selecting {{man label|Preformatted}} will honor all multiple spaces tabs, and new lines, so that the output will appear as it is entered into the text entry field.

== Merging records ==

Sometime several records in the database turn out to be describing the same object: same person, same place, or same citation/source. It could happen either when the data is entered twice by mistake, or when new information reveals that the two entries refer to the same person. It can also happen after importing GEDCOM obtained from a relative, whose database overlaps with your existing data.

Whenever you detect duplicate records, merging them a useful way of correcting the situation.

{{man tip|1=Tip|2=To make a merge, exactly two records have to be selected in the appropriate view (People View, Sources View, or Places View). This is accomplished by selecting one entry and then selecting another person while holding down the {{man key press|Ctrl}} key.}}

===Merge People===

Merging two people is done from the Edit menu.

{{man note|Note|Merging people does not discard any information. The decisions you make during the merge only affect which data will become primary and which will become secondary for the resulting merged record.}}

*Merge
[[Image:Edit-MergePeople-DefaultWindow-40.png|left|thumb|200px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge people (regular view)]]
[[Image:Edit-MergePeople-ExpandedWindow-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge people (expanded view)]]

:When exactly two people are selected, choose '''Edit ->Merge...''' to invoke the {{man label|Merge}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged. If you decide that the records should not be merged, despite similar names, you may click {{man button|Cancel}} button to close the dialog without making any changes. Expanding the ''"Detailed Selection"'' and the ''"Context Information"'' fields on the bottom left (fig. 6.3.4) shows more information about the people to be merged.

If you decide to proceed with merging, select the appropriate {{man button|Select}} radio button to specify the record to be used as the source of primary data, then click {{man button|OK}}. The data from the other record will be kept as alternate data.

Specifically, all names from the other record will become alternate names of the merged record. Similarly, parents, spouses, and children of the other record will become alternate parents, spouses, and children of the merged record, and so on.

===Merge Families===

When exactly two families are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Families}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged. If you decide that the records should not be merged, despite being similar, you may click {{man button|Cancel}} to close the dialog without making any changes.

You can either choose one of the two families to be the source of the primary data for the new family, or by expanding the ''"Detailed Selection"'' field you can individually choose which father is the source of the primary data, which mother is the source of the primary data, and which family (selected by Gramps ID) is the source of the other primary data.

If you decide to proceed with merging, choose the appropriate {{man button|Select}} radio button(s) to specify the source(s) of the primary data to be used for the merged family record, and then click {{man button|OK}} . The children from both marriages are merged into the new family. The two fathers are merged together and the events from the secondary father are attached to the primary father. The names from the secondary father become alternate names for the primary father. The same occurs to the two mothers. The events related to the secondary family (e.g. marriage and any divorce) are transferred to the primary family. The secondary family, and the person record for the secondary father and mother are deleted from the database.

===Merge Events===

When exactly two events are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Events}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
*
*
to be used for the merged record, then click {{man button|OK}}

{{-}}

===Merge Sources===

[[Image:Edit-MergeSources-DefaultWindow-40.png|left|thumb|200px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge sources (regular)]]

[[Image:Edit-MergeSources-ExpandedWindow-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge sources (expanded)]]

When exactly two sources are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Sources}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
* Title
* Author
* Abbreviated title
* Publication information
* ID
to be used for the merged record, then click {{man button|OK}} .

{{-}}

===Merge Places===

[[Image:Edit-MergePlaces-DefaultWindow-40.png|thumb|left|200px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge places (regular)]]

[[Image:Edit-MergePlaces-ExpandedWindow-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Merge places (expanded)]]

When exactly two places are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Places}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
* Title
* Latitude
* Longitude
* Location
* ID
to be used for the merged record, then click {{man button|OK}}.

{{-}}

===Merge Media Objects===

When exactly two Media Objects are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Media Objects}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
*
*
to be used for the merged record, then click {{man button|OK}}

{{-}}

===Merge Repositories===

When exactly two repositories are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Repositories}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
*
*
to be used for the merged record, then click {{man button|OK}}

{{-}}

===Merge Notes===

When exactly two notes are selected, choose '''Edit ->Merge...''' to invoke {{man label|Merge Notes}} dialog.

The dialog allows you to make a decision on whether or not the selected records should be merged.

If you decide that the records should not be merged, despite similar titles, you may click {{man button|Cancel}} to close the dialog without making any changes.

If you decide to proceed with merging, choose the appropriate radio button to specify:
*
*
to be used for the merged record, then click {{man button|OK}}

{{-}}

{{man index|Gramps 4.1 Wiki Manual - Entering and Editing Data:_Detailed - part 2|Gramps_4.1_Wiki_Manual_-_Navigation|4.1}}

{{languages|Gramps_4.1_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_3}}

[[Category:Documentation]]

Gramps 4.0 Wiki Manual - What's new?

2013-07-19T19:21:27Z

RossGammon: Improve text introducing changes to plugins

{{grampsmanualcopyright}}

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps upgrading from version 3.4 are encouraged to review this section to be sure to take advantage of these new features when they start using version 4.0.

= Before you upgrade =

{{man warn| Warning |Creating an archive alone to safeguard your data might not be appropriate before upgrading. In the unlikely event that Gramps 4.0 corrupts your database, it could also corrupt the archive. An backup of your data as outlined in this section is recommended.}}

Before you upgrade, make sure your family tree data is secure. The best way to do this is:
# Start Gramps 3.4
# Open your family tree
# Back up the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Backup your tree via menu {{man menu|Family Trees->Make Backup...}}.
# Close this family tree and repeat the above steps for any other family trees you have
# Keep the resulting file(s) in a safe place

For more information, please review [[Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].

After properly safeguarding your data, proceed to install Gramps 4.0. Using your operating system's regular installation process to do this will in most cases ensure that the new Gramps 4.0 installation will not clash with your older version of Gramps. However, it may be safer to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location. This is always necessary if you are installing from the source code. For more information on installing Gramps 4.0, please see [[Download|Downloading the latest Gramps]]

After you install Gramps 4.0, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), import the backup file(s) created above to recreate your family tree(s).

{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}

= Visible changes to the core =

The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.

Nevertheless, some changes are visible after the migration:

== The Dashboard ==
The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view

== New Look and Feel ==

Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See [http://gramps-project.org/2012/08/status-gtk-3-for-gramps-4-0/ status GTK 3 for Gramps 4.0].

== Data Model ==
There are no changes to the data model. A .gramps xml file generated by Gramps 3.4 is identical to one generated by Gramps 4.0

==Navigator modes==

[[Image:Viewing_mode_selection.png|left|thumb|300px|Category navigator mode]]

[[Image:Drop-Down.png|right|thumb|300px|Drop-Down navigator mode]]

[[Image:Expander.png|left|thumb|300px|Expander navigator mode]]

If there is more than one navigator mode installed, you can choose the navigator mode with the drop down.
The navigator modes are "Category", "Drop-Down" and "Expander".

{{-}}

==New wizards, help and bug report dialogs==

[[Image:ExportAssistantStart-40.png|left|thumb|300px|Export Assistant: Start screen]]

[[Image:ExportAssistantChoose-40.png|right|thumb|300px|Export Assistant: Choose the output format screen]]

Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.

{{-}}

==Colors dialog==

[[File:EditPreferencesColors-40.png|right|thumb|350px|Color Preferences]]

A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.

{{-}}

== Plugins changes ==

The following are the changes made in the plugins: import/export, gramplets, views, reports, tools.

=== To Do Gramplets ===

[[Image:ToDoList-sidebar-gramplet-40.png|right|thumb|200px| To Do Gramplet]]

Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New ''To Do'' notes can be created directly from the gramplet. See [[Gramps_4.0_Wiki_Manual_-_Gramplets#To_Do_Gramplet|ToDo Gramplet]] for more details.

{{-}}

== Views ==

* New columns on views (private records)

=== Fan Charts ===

[[Image:ChartsViewFanChart-40.png|left|thumb|300px| Fan Chart]]
[[Image:ChartsViewDescendantFanChart-40.png|right|thumb|300px| Fan Chart]]

In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the ''entire'' descendant tree.

The Fan Charts are powerfull, use the {{man button|Configure}} button in the toolbar to investigate some posibilities:
* colored filtering via filter sidebar
* Gradient coloring to give extra information
* Print to output (pdf, printer) from the toolbar

{{-}}

== Tools ==

New tool for refreshing given name's statistics according to gender.

== Reports ==

* More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new [[#Locales handling|locales handling]].

===Book ===

* More friendly way for accessing to book report via command line.
* Improvements on OpenDocument and PDF file formats support

=== NarrativeWeb ===

A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable

= Under the hood changes =

Technical stuff

== Python 3 support ==

Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.

== Code reogranization ==

Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.

== Python based install ==

Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to use a package installer to install Gramps. Those installing from source code can do so now with the commands :

python setup.py build
python setup.py install

See the INSTALL and README file for details. This means that once you have installed gramps, you can use the code as a standard python module, eg:

from gramps.gen.lib.date import Date

to use the date computations as used by Gramps.

== Locales handling ==

See [[Internationalization]].

== Command Line Interface ==

See [[#Code reogranization|code reorganization]] and [[#Python based install|python based installation]].

* more translated typeout

= Further information =

More information.

== Roadmap ==

* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]

== Changelog ==

* [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 roadmap 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=34 changelog]

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

[[Category:Documentation]]

Gramps 4.0 Wiki Manual - What's new?

2013-07-19T17:49:33Z

RossGammon: improve text in Data Model section

{{grampsmanualcopyright}}

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps upgrading from version 3.4 are encouraged to review this section to be sure to take advantage of these new features when they start using version 4.0.

= Before you upgrade =

{{man warn| Warning |Creating an archive alone to safeguard your data might not be appropriate before upgrading. In the unlikely event that Gramps 4.0 corrupts your database, it could also corrupt the archive. An backup of your data as outlined in this section is recommended.}}

Before you upgrade, make sure your family tree data is secure. The best way to do this is:
# Start Gramps 3.4
# Open your family tree
# Back up the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Backup your tree via menu {{man menu|Family Trees->Make Backup...}}.
# Close this family tree and repeat the above steps for any other family trees you have
# Keep the resulting file(s) in a safe place

For more information, please review [[Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].

After properly safeguarding your data, proceed to install Gramps 4.0. Using your operating system's regular installation process to do this will in most cases ensure that the new Gramps 4.0 installation will not clash with your older version of Gramps. However, it may be safer to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location. This is always necessary if you are installing from the source code. For more information on installing Gramps 4.0, please see [[Download|Downloading the latest Gramps]]

After you install Gramps 4.0, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), import the backup file(s) created above to recreate your family tree(s).

{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}

= Visible changes to the core =

The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.

Nevertheless, some changes are visible after the migration:

== The Dashboard ==
The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view

== New Look and Feel ==

Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See [http://gramps-project.org/2012/08/status-gtk-3-for-gramps-4-0/ status GTK 3 for Gramps 4.0].

== Data Model ==
There are no changes to the data model. A .gramps xml file generated by Gramps 3.4 is identical to one generated by Gramps 4.0

==Navigator modes==

[[Image:Viewing_mode_selection.png|left|thumb|300px|Category navigator mode]]

[[Image:Drop-Down.png|right|thumb|300px|Drop-Down navigator mode]]

[[Image:Expander.png|left|thumb|300px|Expander navigator mode]]

If there is more than one navigator mode installed, you can choose the navigator mode with the drop down.
The navigator modes are "Category", "Drop-Down" and "Expander".

{{-}}

==New wizards, help and bug report dialogs==

[[Image:ExportAssistantStart-40.png|left|thumb|300px|Export Assistant: Start screen]]

[[Image:ExportAssistantChoose-40.png|right|thumb|300px|Export Assistant: Choose the output format screen]]

Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.

{{-}}

==Colors dialog==

[[File:EditPreferencesColors-40.png|right|thumb|350px|Color Preferences]]

A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.

{{-}}

== Plugins changes ==

Everything about the plugins: import/export, gramplets, views, reports, tools.

=== To Do Gramplets ===

[[Image:ToDoList-sidebar-gramplet-40.png|right|thumb|200px| To Do Gramplet]]

Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New ''To Do'' notes can be created directly from the gramplet. See [[Gramps_4.0_Wiki_Manual_-_Gramplets#To_Do_Gramplet|ToDo Gramplet]] for more details.

{{-}}

== Views ==

* New columns on views (private records)

=== Fan Charts ===

[[Image:ChartsViewFanChart-40.png|left|thumb|300px| Fan Chart]]
[[Image:ChartsViewDescendantFanChart-40.png|right|thumb|300px| Fan Chart]]

In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the ''entire'' descendant tree.

The Fan Charts are powerfull, use the {{man button|Configure}} button in the toolbar to investigate some posibilities:
* colored filtering via filter sidebar
* Gradient coloring to give extra information
* Print to output (pdf, printer) from the toolbar

{{-}}

== Tools ==

New tool for refreshing given name's statistics according to gender.

== Reports ==

* More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new [[#Locales handling|locales handling]].

===Book ===

* More friendly way for accessing to book report via command line.
* Improvements on OpenDocument and PDF file formats support

=== NarrativeWeb ===

A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable

= Under the hood changes =

Technical stuff

== Python 3 support ==

Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.

== Code reogranization ==

Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.

== Python based install ==

Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to use a package installer to install Gramps. Those installing from source code can do so now with the commands :

python setup.py build
python setup.py install

See the INSTALL and README file for details. This means that once you have installed gramps, you can use the code as a standard python module, eg:

from gramps.gen.lib.date import Date

to use the date computations as used by Gramps.

== Locales handling ==

See [[Internationalization]].

== Command Line Interface ==

See [[#Code reogranization|code reorganization]] and [[#Python based install|python based installation]].

* more translated typeout

= Further information =

More information.

== Roadmap ==

* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]

== Changelog ==

* [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 roadmap 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=34 changelog]

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

[[Category:Documentation]]

Gramps 4.0 Wiki Manual - What's new?

2013-07-07T18:33:04Z

RossGammon: /* Python based install */

{{grampsmanualcopyright}}

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps upgrading from version 3.4 are encouraged to review this section to be sure to take advantage of these new features when they start using version 4.0.

= Before you upgrade =

{{man warn| Warning |Creating an archive alone to safeguard your data might not be appropriate before upgrading. In the unlikely event that Gramps 4.0 corrupts your database, it could also corrupt the archive. An backup of your data as outlined in this section is recommended.}}

Before you upgrade, make sure your family tree data is secure. The best way to do this is:
# Start Gramps 3.4
# Open your family tree
# Back up the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Backup your tree via menu {{man menu|Family Trees->Make Backup...}}.
# Close this family tree and repeat the above steps for any other family trees you have
# Keep the resulting file(s) in a safe place

For more information, please review [[Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].

After properly safeguarding your data, proceed to install Gramps 4.0. Using your operating system's regular installation process to do this will in most cases ensure that the new Gramps 4.0 installation will not clash with your older version of Gramps. However, it may be safer to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location. This is always necessary if you are installing from the source code. For more information on installing Gramps 4.0, please see [[Download|Downloading the latest Gramps]]

After you install Gramps 4.0, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), import the backup file(s) created above to recreate your family tree(s).

{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}

= Visible changes to the core =

The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.

Nevertheless, some changes are visible after the migration:

== The Dashboard ==
The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view

== New Look and Feel ==

Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See [http://gramps-project.org/2012/08/status-gtk-3-for-gramps-4-0/ status GTK 3 for Gramps 4.0].

== Data Model ==
There are no changes to the data model. An .gramps xml file generated by Gramps 3.4 is identical to the one of Gramps 4.0

==Navigator modes==

[[Image:Viewing_mode_selection.png|left|thumb|300px|Category navigator mode]]

[[Image:Drop-Down.png|right|thumb|300px|Drop-Down navigator mode]]

[[Image:Expander.png|left|thumb|300px|Expander navigator mode]]

If there is more than one navigator mode installed, you can choose the navigator mode with the drop down.
The navigator modes are "Category", "Drop-Down" and "Expander".

{{-}}

==New wizards, help and bug report dialogs==

[[Image:ExportAssistantStart-40.png|left|thumb|300px|Export Assistant: Start screen]]

[[Image:ExportAssistantChoose-40.png|right|thumb|300px|Export Assistant: Choose the output format screen]]

Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.

{{-}}

==Colors dialog==

[[File:EditPreferencesColors-40.png|right|thumb|350px|Color Preferences]]

A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.

{{-}}

== Plugins changes ==

Everything about the plugins: import/export, gramplets, views, reports, tools.

=== To Do Gramplets ===

[[Image:ToDoList-sidebar-gramplet-40.png|right|thumb|200px| To Do Gramplet]]

Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New ''To Do'' notes can be created directly from the gramplet. See [[Gramps_4.0_Wiki_Manual_-_Gramplets#To_Do_Gramplet|ToDo Gramplet]] for more details.

{{-}}

== Views ==

* New columns on views (private records)

=== Fan Charts ===

[[Image:ChartsViewFanChart-40.png|left|thumb|300px| Fan Chart]]
[[Image:ChartsViewDescendantFanChart-40.png|right|thumb|300px| Fan Chart]]

In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the ''entire'' descendant tree.

The Fan Charts are powerfull, use the {{man button|Configure}} button in the toolbar to investigate some posibilities:
* colored filtering via filter sidebar
* Gradient coloring to give extra information
* Print to output (pdf, printer) from the toolbar

{{-}}

== Tools ==

New tool for refreshing given name's statistics according to gender.

== Reports ==

* More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new [[#Locales handling|locales handling]].

===Book ===

* More friendly way for accessing to book report via command line.
* Improvements on OpenDocument and PDF file formats support

=== NarrativeWeb ===

A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable

= Under the hood changes =

Technical stuff

== Python 3 support ==

Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.

== Code reogranization ==

Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.

== Python based install ==

Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to use a package installer to install Gramps. Those installing from source code can do so now with the commands :

python setup.py build
python setup.py install

See the INSTALL and README file for details. This means that once you have installed gramps, you can use the code as a standard python module, eg:

from gramps.gen.lib.date import Date

to use the date computations as used by Gramps.

== Locales handling ==

See [[Internationalization]].

== Command Line Interface ==

See [[#Code reogranization|code reorganization]] and [[#Python based install|python based installation]].

* more translated typeout

= Further information =

More information.

== Roadmap ==

* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]

== Changelog ==

* [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 roadmap 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=34 changelog]

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

[[Category:Documentation]]

Gramps 4.0 Wiki Manual - What's new?

2013-07-07T18:30:31Z

RossGammon: /* Plugins changes */

{{grampsmanualcopyright}}

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps upgrading from version 3.4 are encouraged to review this section to be sure to take advantage of these new features when they start using version 4.0.

= Before you upgrade =

{{man warn| Warning |Creating an archive alone to safeguard your data might not be appropriate before upgrading. In the unlikely event that Gramps 4.0 corrupts your database, it could also corrupt the archive. An backup of your data as outlined in this section is recommended.}}

Before you upgrade, make sure your family tree data is secure. The best way to do this is:
# Start Gramps 3.4
# Open your family tree
# Back up the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Backup your tree via menu {{man menu|Family Trees->Make Backup...}}.
# Close this family tree and repeat the above steps for any other family trees you have
# Keep the resulting file(s) in a safe place

For more information, please review [[Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].

After properly safeguarding your data, proceed to install Gramps 4.0. Using your operating system's regular installation process to do this will in most cases ensure that the new Gramps 4.0 installation will not clash with your older version of Gramps. However, it may be safer to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location. This is always necessary if you are installing from the source code. For more information on installing Gramps 4.0, please see [[Download|Downloading the latest Gramps]]

After you install Gramps 4.0, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), import the backup file(s) created above to recreate your family tree(s).

{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}

= Visible changes to the core =

The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.

Nevertheless, some changes are visible after the migration:

== The Dashboard ==
The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view

== New Look and Feel ==

Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See [http://gramps-project.org/2012/08/status-gtk-3-for-gramps-4-0/ status GTK 3 for Gramps 4.0].

== Data Model ==
There are no changes to the data model. An .gramps xml file generated by Gramps 3.4 is identical to the one of Gramps 4.0

==Navigator modes==

[[Image:Viewing_mode_selection.png|left|thumb|300px|Category navigator mode]]

[[Image:Drop-Down.png|right|thumb|300px|Drop-Down navigator mode]]

[[Image:Expander.png|left|thumb|300px|Expander navigator mode]]

If there is more than one navigator mode installed, you can choose the navigator mode with the drop down.
The navigator modes are "Category", "Drop-Down" and "Expander".

{{-}}

==New wizards, help and bug report dialogs==

[[Image:ExportAssistantStart-40.png|left|thumb|300px|Export Assistant: Start screen]]

[[Image:ExportAssistantChoose-40.png|right|thumb|300px|Export Assistant: Choose the output format screen]]

Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.

{{-}}

==Colors dialog==

[[File:EditPreferencesColors-40.png|right|thumb|350px|Color Preferences]]

A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.

{{-}}

== Plugins changes ==

Everything about the plugins: import/export, gramplets, views, reports, tools.

=== To Do Gramplets ===

[[Image:ToDoList-sidebar-gramplet-40.png|right|thumb|200px| To Do Gramplet]]

Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New ''To Do'' notes can be created directly from the gramplet. See [[Gramps_4.0_Wiki_Manual_-_Gramplets#To_Do_Gramplet|ToDo Gramplet]] for more details.

{{-}}

== Views ==

* New columns on views (private records)

=== Fan Charts ===

[[Image:ChartsViewFanChart-40.png|left|thumb|300px| Fan Chart]]
[[Image:ChartsViewDescendantFanChart-40.png|right|thumb|300px| Fan Chart]]

In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the ''entire'' descendant tree.

The Fan Charts are powerfull, use the {{man button|Configure}} button in the toolbar to investigate some posibilities:
* colored filtering via filter sidebar
* Gradient coloring to give extra information
* Print to output (pdf, printer) from the toolbar

{{-}}

== Tools ==

New tool for refreshing given name's statistics according to gender.

== Reports ==

* More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new [[#Locales handling|locales handling]].

===Book ===

* More friendly way for accessing to book report via command line.
* Improvements on OpenDocument and PDF file formats support

=== NarrativeWeb ===

A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable

= Under the hood changes =

Technical stuff

== Python 3 support ==

Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.

== Code reogranization ==

Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.

== Python based install ==

Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to a package installer to install Gramps. Those installing from source code can do some now with the commands :

python setup.py build
python setup.py install

See the INSTALL and README file for details. This means that once you installed gramps, you can use the code as a standard python module, eg:

from gramps.gen.lib.date import Date

to use the date computations as used by Gramps.

== Locales handling ==

See [[Internationalization]].

== Command Line Interface ==

See [[#Code reogranization|code reorganization]] and [[#Python based install|python based installation]].

* more translated typeout

= Further information =

More information.

== Roadmap ==

* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]

== Changelog ==

* [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 roadmap 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=34 changelog]

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

[[Category:Documentation]]

Gramps 4.0 Wiki Manual - What's new?

2013-07-07T18:26:33Z

RossGammon: changed link to "the latest Gramps" instead of 4.0

{{grampsmanualcopyright}}

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps upgrading from version 3.4 are encouraged to review this section to be sure to take advantage of these new features when they start using version 4.0.

= Before you upgrade =

{{man warn| Warning |Creating an archive alone to safeguard your data might not be appropriate before upgrading. In the unlikely event that Gramps 4.0 corrupts your database, it could also corrupt the archive. An backup of your data as outlined in this section is recommended.}}

Before you upgrade, make sure your family tree data is secure. The best way to do this is:
# Start Gramps 3.4
# Open your family tree
# Back up the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Backup your tree via menu {{man menu|Family Trees->Make Backup...}}.
# Close this family tree and repeat the above steps for any other family trees you have
# Keep the resulting file(s) in a safe place

For more information, please review [[Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].

After properly safeguarding your data, proceed to install Gramps 4.0. Using your operating system's regular installation process to do this will in most cases ensure that the new Gramps 4.0 installation will not clash with your older version of Gramps. However, it may be safer to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location. This is always necessary if you are installing from the source code. For more information on installing Gramps 4.0, please see [[Download|Downloading the latest Gramps]]

After you install Gramps 4.0, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), import the backup file(s) created above to recreate your family tree(s).

{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}

= Visible changes to the core =

The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.

Nevertheless, some changes are visible after the migration:

== The Dashboard ==
The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view

== New Look and Feel ==

Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See [http://gramps-project.org/2012/08/status-gtk-3-for-gramps-4-0/ status GTK 3 for Gramps 4.0].

== Data Model ==
There are no changes to the data model. An .gramps xml file generated by Gramps 3.4 is identical to the one of Gramps 4.0

==Navigator modes==

[[Image:Viewing_mode_selection.png|left|thumb|300px|Category navigator mode]]

[[Image:Drop-Down.png|right|thumb|300px|Drop-Down navigator mode]]

[[Image:Expander.png|left|thumb|300px|Expander navigator mode]]

If there is more than one navigator mode installed, you can choose the navigator mode with the drop down.
The navigator modes are "Category", "Drop-Down" and "Expander".

{{-}}

==New wizards, help and bug report dialogs==

[[Image:ExportAssistantStart-40.png|left|thumb|300px|Export Assistant: Start screen]]

[[Image:ExportAssistantChoose-40.png|right|thumb|300px|Export Assistant: Choose the output format screen]]

Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.

{{-}}

==Colors dialog==

[[File:EditPreferencesColors-40.png|right|thumb|350px|Color Preferences]]

A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.

{{-}}

= Plugins changes =

Everything about the plugins: import/export, gramplets, views, reports, tools.

=== To Do Gramplets ===

[[Image:ToDoList-sidebar-gramplet-40.png|right|thumb|200px| To Do Gramplet]]

Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New ''To Do'' notes can be created directly from the gramplet. See [[Gramps_4.0_Wiki_Manual_-_Gramplets#To_Do_Gramplet|ToDo Gramplet]] for more details.

{{-}}

== Views ==

* New columns on views (private records)

=== Fan Charts ===

[[Image:ChartsViewFanChart-40.png|left|thumb|300px| Fan Chart]]
[[Image:ChartsViewDescendantFanChart-40.png|right|thumb|300px| Fan Chart]]

In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the ''entire'' descendant tree.

The Fan Charts are powerfull, use the {{man button|Configure}} button in the toolbar to investigate some posibilities:
* colored filtering via filter sidebar
* Gradient coloring to give extra information
* Print to output (pdf, printer) from the toolbar

{{-}}

== Tools ==

New tool for refreshing given name's statistics according to gender.

== Reports ==

* More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new [[#Locales handling|locales handling]].

===Book ===

* More friendly way for accessing to book report via command line.
* Improvements on OpenDocument and PDF file formats support

=== NarrativeWeb ===

A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable

= Under the hood changes =

Technical stuff

== Python 3 support ==

Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.

== Code reogranization ==

Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.

== Python based install ==

Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to a package installer to install Gramps. Those installing from source code can do some now with the commands :

python setup.py build
python setup.py install

See the INSTALL and README file for details. This means that once you installed gramps, you can use the code as a standard python module, eg:

from gramps.gen.lib.date import Date

to use the date computations as used by Gramps.

== Locales handling ==

See [[Internationalization]].

== Command Line Interface ==

See [[#Code reogranization|code reorganization]] and [[#Python based install|python based installation]].

* more translated typeout

= Further information =

More information.

== Roadmap ==

* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]

== Changelog ==

* [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 roadmap 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=34 changelog]

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

[[Category:Documentation]]

Talk:Gramps 4.0 Wiki Manual - What's new?

2013-07-07T18:25:29Z

RossGammon: Deleted discussion - question answered on devel list

Gramps 4.0 Wiki Manual - What's new?

2013-07-07T18:22:37Z

RossGammon: Advice on uninstalling/upgarding changed and added link to download page

{{grampsmanualcopyright}}

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps upgrading from version 3.4 are encouraged to review this section to be sure to take advantage of these new features when they start using version 4.0.

= Before you upgrade =

{{man warn| Warning |Creating an archive alone to safeguard your data might not be appropriate before upgrading. In the unlikely event that Gramps 4.0 corrupts your database, it could also corrupt the archive. An backup of your data as outlined in this section is recommended.}}

Before you upgrade, make sure your family tree data is secure. The best way to do this is:
# Start Gramps 3.4
# Open your family tree
# Back up the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Backup your tree via menu {{man menu|Family Trees->Make Backup...}}.
# Close this family tree and repeat the above steps for any other family trees you have
# Keep the resulting file(s) in a safe place

For more information, please review [[Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].

After properly safeguarding your data, proceed to install Gramps 4.0. Using your operating system's regular installation process to do this will in most cases ensure that the new Gramps 4.0 installation will not clash with your older version of Gramps. However, it may be safer to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location. This is always necessary if you are installing from the source code. For more information on installing Gramps 4.0, please see [[Download|Downloading Gramps 4.0]]

After you install Gramps 4.0, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), import the backup file(s) created above to recreate your family tree(s).

{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}

= Visible changes to the core =

The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.

Nevertheless, some changes are visible after the migration:

== The Dashboard ==
The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view

== New Look and Feel ==

Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See [http://gramps-project.org/2012/08/status-gtk-3-for-gramps-4-0/ status GTK 3 for Gramps 4.0].

== Data Model ==
There are no changes to the data model. An .gramps xml file generated by Gramps 3.4 is identical to the one of Gramps 4.0

==Navigator modes==

[[Image:Viewing_mode_selection.png|left|thumb|300px|Category navigator mode]]

[[Image:Drop-Down.png|right|thumb|300px|Drop-Down navigator mode]]

[[Image:Expander.png|left|thumb|300px|Expander navigator mode]]

If there is more than one navigator mode installed, you can choose the navigator mode with the drop down.
The navigator modes are "Category", "Drop-Down" and "Expander".

{{-}}

==New wizards, help and bug report dialogs==

[[Image:ExportAssistantStart-40.png|left|thumb|300px|Export Assistant: Start screen]]

[[Image:ExportAssistantChoose-40.png|right|thumb|300px|Export Assistant: Choose the output format screen]]

Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.

{{-}}

==Colors dialog==

[[File:EditPreferencesColors-40.png|right|thumb|350px|Color Preferences]]

A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.

{{-}}

= Plugins changes =

Everything about the plugins: import/export, gramplets, views, reports, tools.

=== To Do Gramplets ===

[[Image:ToDoList-sidebar-gramplet-40.png|right|thumb|200px| To Do Gramplet]]

Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New ''To Do'' notes can be created directly from the gramplet. See [[Gramps_4.0_Wiki_Manual_-_Gramplets#To_Do_Gramplet|ToDo Gramplet]] for more details.

{{-}}

== Views ==

* New columns on views (private records)

=== Fan Charts ===

[[Image:ChartsViewFanChart-40.png|left|thumb|300px| Fan Chart]]
[[Image:ChartsViewDescendantFanChart-40.png|right|thumb|300px| Fan Chart]]

In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the ''entire'' descendant tree.

The Fan Charts are powerfull, use the {{man button|Configure}} button in the toolbar to investigate some posibilities:
* colored filtering via filter sidebar
* Gradient coloring to give extra information
* Print to output (pdf, printer) from the toolbar

{{-}}

== Tools ==

New tool for refreshing given name's statistics according to gender.

== Reports ==

* More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new [[#Locales handling|locales handling]].

===Book ===

* More friendly way for accessing to book report via command line.
* Improvements on OpenDocument and PDF file formats support

=== NarrativeWeb ===

A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable

= Under the hood changes =

Technical stuff

== Python 3 support ==

Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.

== Code reogranization ==

Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.

== Python based install ==

Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to a package installer to install Gramps. Those installing from source code can do some now with the commands :

python setup.py build
python setup.py install

See the INSTALL and README file for details. This means that once you installed gramps, you can use the code as a standard python module, eg:

from gramps.gen.lib.date import Date

to use the date computations as used by Gramps.

== Locales handling ==

See [[Internationalization]].

== Command Line Interface ==

See [[#Code reogranization|code reorganization]] and [[#Python based install|python based installation]].

* more translated typeout

= Further information =

More information.

== Roadmap ==

* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]

== Changelog ==

* [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 roadmap 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=34 changelog]

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

[[Category:Documentation]]

Talk:Gramps 4.0 Wiki Manual - What's new?

2013-07-07T16:25:01Z

RossGammon: Question on install advice?

Not sure about the advice to uninstall first when using the Linux distro official package. Also think the install in different place is only applicable to installing from source (unless it is advice for Windows).

Gramps 4.0 Wiki Manual - What's new?

2013-07-07T16:21:13Z

RossGammon: Tweak to wording after testing an upgrade from 4.3 to 4.0

{{grampsmanualcopyright}}

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps upgrading from version 3.4 are encouraged to review this section to be sure to take advantage of these new features when they start using version 4.0.

= Before you upgrade =

{{man warn| Warning |Creating an archive alone to safeguard your data might not be appropriate before upgrading. In the unlikely event that Gramps 4.0 corrupts your database, it could also corrupt the archive. An export as outlined in this section is recommended.}}

Before you upgrade, make sure your family tree data is secure. The best way to do this is:
# Start Gramps 3.4
# Open your family tree
# Back up the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Backup your tree via menu {{man menu|Family Trees->Make Backup...}}.
# Close this family tree and repeat the above steps for any other family trees you have
# Keep the resulting file(s) in a safe place

For more information, please review [[Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].

After properly safeguarding your data, proceed to install Gramps 4.0. Use your operating system's regular installation process to do this. It is also best to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location.

After you install Gramps 4.0, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), import the backup file(s) created above to recreate your family tree(s).

{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}

= Visible changes to the core =

The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.

Nevertheless, some changes are visible after the migration:

== The Dashboard ==
The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view

== New Look and Feel ==

Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See [http://gramps-project.org/2012/08/status-gtk-3-for-gramps-4-0/ status GTK 3 for Gramps 4.0].

== Data Model ==
There are no changes to the data model. An .gramps xml file generated by Gramps 3.4 is identical to the one of Gramps 4.0

==Navigator modes==

[[Image:Viewing_mode_selection.png|left|thumb|300px|Category navigator mode]]

[[Image:Drop-Down.png|right|thumb|300px|Drop-Down navigator mode]]

[[Image:Expander.png|left|thumb|300px|Expander navigator mode]]

If there is more than one navigator mode installed, you can choose the navigator mode with the drop down.
The navigator modes are "Category", "Drop-Down" and "Expander".

{{-}}

==New wizards, help and bug report dialogs==

[[Image:ExportAssistantStart-40.png|left|thumb|300px|Export Assistant: Start screen]]

[[Image:ExportAssistantChoose-40.png|right|thumb|300px|Export Assistant: Choose the output format screen]]

Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.

{{-}}

==Colors dialog==

[[File:EditPreferencesColors-40.png|right|thumb|350px|Color Preferences]]

A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.

{{-}}

= Plugins changes =

Everything about the plugins: import/export, gramplets, views, reports, tools.

=== To Do Gramplets ===

[[Image:ToDoList-sidebar-gramplet-40.png|right|thumb|200px| To Do Gramplet]]

Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New ''To Do'' notes can be created directly from the gramplet. See [[Gramps_4.0_Wiki_Manual_-_Gramplets#To_Do_Gramplet|ToDo Gramplet]] for more details.

{{-}}

== Views ==

* New columns on views (private records)

=== Fan Charts ===

[[Image:ChartsViewFanChart-40.png|left|thumb|300px| Fan Chart]]
[[Image:ChartsViewDescendantFanChart-40.png|right|thumb|300px| Fan Chart]]

In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the ''entire'' descendant tree.

The Fan Charts are powerfull, use the {{man button|Configure}} button in the toolbar to investigate some posibilities:
* colored filtering via filter sidebar
* Gradient coloring to give extra information
* Print to output (pdf, printer) from the toolbar

{{-}}

== Tools ==

New tool for refreshing given name's statistics according to gender.

== Reports ==

* More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new [[#Locales handling|locales handling]].

===Book ===

* More friendly way for accessing to book report via command line.
* Improvements on OpenDocument and PDF file formats support

=== NarrativeWeb ===

A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable

= Under the hood changes =

Technical stuff

== Python 3 support ==

Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.

== Code reogranization ==

Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.

== Python based install ==

Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to a package installer to install Gramps. Those installing from source code can do some now with the commands :

python setup.py build
python setup.py install

See the INSTALL and README file for details. This means that once you installed gramps, you can use the code as a standard python module, eg:

from gramps.gen.lib.date import Date

to use the date computations as used by Gramps.

== Locales handling ==

See [[Internationalization]].

== Command Line Interface ==

See [[#Code reogranization|code reorganization]] and [[#Python based install|python based installation]].

* more translated typeout

= Further information =

More information.

== Roadmap ==

* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]

== Changelog ==

* [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 roadmap 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=34 changelog]

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

[[Category:Documentation]]

Gramps 4.0 Wiki Manual - What's new?

2013-07-03T20:15:22Z

RossGammon: Minor tweak of wording

{{grampsmanualcopyright}}

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps upgrading from version 3.4 are encouraged to review this section to be sure to take advantage of these new features when they start using version 4.0.

= Before you upgrade =

{{man warn| Warning |Creating an archive alone to safeguard your data might not be appropriate before upgrading. In the unlikely event that Gramps 4.0 corrupts your database, it could also corrupt the archive. An export as outlined in this section is recommended.}}

Before you upgrade, make sure your family tree data is secure. The best way to do this is:
# Start Gramps 3.4
# Open your family tree
# Export the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Export your tree via menu {{man menu|Family Trees->Backup...}}.
# Close this family tree and repeat the above steps for any other family trees you have
# Keep the resulting file(s) in a safe place

For more information, please review [[Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].

After properly safeguarding your data, proceed to install Gramps 4.0. Use your operating system's regular installation process to do this. It is also best to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location.

After you install Gramps 4.0, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), use the backup file(s) created above to recreate your family tree(s).

{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}

= Visible changes to the core =

The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.

Nevertheless, some changes are visible after the migration:

== The Dashboard ==
The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view

== New Look and Feel ==

Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See [http://gramps-project.org/2012/08/status-gtk-3-for-gramps-4-0/ status GTK 3 for Gramps 4.0].

== Data Model ==
There are no changes to the data model. An .gramps xml file generated by Gramps 3.4 is identical to the one of Gramps 4.0

==Navigator modes==

[[Image:Viewing_mode_selection.png|left|thumb|300px|Category navigator mode]]

[[Image:Drop-Down.png|right|thumb|300px|Drop-Down navigator mode]]

[[Image:Expander.png|left|thumb|300px|Expander navigator mode]]

If there is more than one navigator mode installed, you can choose the navigator mode with the drop down.
The navigator modes are "Category", "Drop-Down" and "Expander".

{{-}}

==New wizards, help and bug report dialogs==

[[Image:ExportAssistantStart-40.png|left|thumb|300px|Export Assistant: Start screen]]

[[Image:ExportAssistantChoose-40.png|right|thumb|300px|Export Assistant: Choose the output format screen]]

Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.

{{-}}

==Colors dialog==

[[File:EditPreferencesColors-40.png|right|thumb|350px|Color Preferences]]

A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.

{{-}}

= Plugins changes =

Everything about the plugins: import/export, gramplets, views, reports, tools.

=== To Do Gramplets ===

[[Image:ToDoList-sidebar-gramplet-40.png|right|thumb|200px| To Do Gramplet]]

Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New ''To Do'' notes can be created directly from the gramplet. See [[Gramps_4.0_Wiki_Manual_-_Gramplets#To_Do_Gramplet|ToDo Gramplet]] for more details.

{{-}}

== Views ==

* New columns on views (private records)

=== Fan Charts ===

[[Image:ChartsViewFanChart-40.png|left|thumb|300px| Fan Chart]]
[[Image:ChartsViewDescendantFanChart-40.png|right|thumb|300px| Fan Chart]]

In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the ''entire'' descendant tree.

The Fan Charts are powerfull, use the {{man button|Configure}} button in the toolbar to investigate some posibilities:
* colored filtering via filter sidebar
* Gradient coloring to give extra information
* Print to output (pdf, printer) from the toolbar

{{-}}

== Tools ==

New tool for refreshing given name's statistics according to gender.

== Reports ==

* More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new [[#Locales handling|locales handling]].

===Book ===

* More friendly way for accessing to book report via command line.
* Improvements on OpenDocument and PDF file formats support

=== NarrativeWeb ===

A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable

= Under the hood changes =

Technical stuff

== Python 3 support ==

Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.

== Code reogranization ==

Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.

== Python based install ==

Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to a package installer to install Gramps. Those installing from source code can do some now with the commands :

python setup.py build
python setup.py install

See the INSTALL and README file for details. This means that once you installed gramps, you can use the code as a standard python module, eg:

from gramps.gen.lib.date import Date

to use the date computations as used by Gramps.

== Locales handling ==

See [[Internationalization]].

== Command Line Interface ==

See [[#Code reogranization|code reorganization]] and [[#Python based install|python based installation]].

* more translated typeout

= Further information =

More information.

== Roadmap ==

* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]

== Changelog ==

* [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 roadmap 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=34 changelog]

{{man index|Gramps 4.0 Wiki Manual - Preface|Gramps 4.0 Wiki Manual - Getting started|4.0}}

{{languages|Gramps 4.0 Wiki Manual - What's new?}}

[[Category:Documentation]]

Download

2013-05-20T19:26:50Z

RossGammon:

__NOTOC__
{{languages}}
== Linux ==

[[Image:Linux_220x261.png|55px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz Source]
    
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit)]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit)]</big>

After download: double-click to install Gramps.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Alternative independent MS Windows version [[#3|[3]]].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left|link=http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Mac OS X 10.5 (Leopard), 10.6 (Snow Leopard) and 10.7 (Lion)    <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/Gramps-PPC-{{version_Mac}}-2.dmg Intel]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/Gramps-Intel-{{version_Mac}}-2.dmg Power PC]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-uo into this new Tree.

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. Allows you to trial a pre-installed Gramps {{Version Linux Live CD}}, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install [http://www.ubuntulinux.org/ Ubuntu 10.10] and Gramps from the CD anytime you like.

== Linux distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| border="1" cellspacing="0"
|Distribution
|GUI pkg manager
|Current versions
|Notes
|-
|'''Linux Mint'''
|Synaptic ??
|Nadia: Gramps 3.4.0-1 Lisa: Gramps 3.3.1-1 Isadora: Gramps 3.2.0-1
|
|-
|''' Mageia '''
|
|
|
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Quantal: Gramps 3.4.0-1
|[http://packages.ubuntu.com/quantal/gramps available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Fedora Rawhide: Gramps 3.4.3 Fedora 18: Gramps 3.4.2.
|
|-
|[[Image:Debianopenlogo-32.png]]''' Debian '''
|Add/Remove Software
|squeeze (old stable): Gramps 3.2.3 wheezy (stable): Gramps 3.4.0 jessie (testing): Gramps 3.4.0 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 3.4.0
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6 See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|
|
|
|-
|''' openSUSE '''
|YaST ??
|openSUSE 12.3: Gramps 3.4.2
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.0: Gramps 3.4.2
|[http://pkgs.org/search/?keyword=gramps available versions]
|}

{{-}}
== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Ubuntu_32x32.png]]'''Debian''' and ''' Ubuntu ''' [[http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps_{{version}}-1_all.deb|Download the .deb file]]. Run the following command from the directory where the file was saved (change the filename to match the one you downloaded)
sudo dpkg -i gramps_3.4.4-1_all.deb

For other distributions, you could try [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Download

2013-05-20T19:14:26Z

RossGammon:

__NOTOC__
{{languages}}
== Linux ==

[[Image:Linux_220x261.png|55px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz Source]
    
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit)]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit)]</big>

After download: double-click to install Gramps.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Alternative independent MS Windows version [[#3|[3]]].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left|link=http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Mac OS X 10.5 (Leopard), 10.6 (Snow Leopard) and 10.7 (Lion)    <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/Gramps-PPC-{{version_Mac}}-2.dmg Intel]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/Gramps-Intel-{{version_Mac}}-2.dmg Power PC]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-uo into this new Tree.

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. Allows you to trial a pre-installed Gramps {{Version Linux Live CD}}, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install [http://www.ubuntulinux.org/ Ubuntu 10.10] and Gramps from the CD anytime you like.

== Linux distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| border="1" cellspacing="0"
|Distribution
|GUI pkg manager
|Current versions
|Notes
|-
|'''Linux Mint'''
|Synaptic ??
|Nadia: Gramps 3.4.0-1 Lisa: Gramps 3.3.1-1 Isadora: Gramps 3.2.0-1
|
|-
|''' Mageia '''
|
|
|
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Quantal: Gramps 3.4.0-1
|[http://packages.ubuntu.com/quantal/gramps available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Fedora Rawhide: Gramps 3.4.3 Fedora 18: Gramps 3.4.2.
|
|-
|[[Image:Debianopenlogo-32.png]]''' Debian '''
|
|squeeze (old stable): Gramps 3.2.3 wheezy (stable): Gramps 3.4.0 jessie (testing): Gramps 3.4.0 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 3.4.0
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6 See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|
|
|
|-
|''' openSUSE '''
|YaST ??
|openSUSE 12.3: Gramps 3.4.2
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.0: Gramps 3.4.2
|[http://pkgs.org/search/?keyword=gramps available versions]
|}

{{-}}
== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Ubuntu_32x32.png]]'''Debian''' and ''' Ubuntu ''' [[http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps_{{version}}-1_all.deb|Download the .deb file]]. Run the following command from the directory where the file was saved (change the filename to match the one you downloaded)
sudo dpkg -i gramps_3.4.4-1_all.deb

For other distributions, you could try [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

File:Debianopenlogo-32.png

2013-05-20T19:10:33Z

RossGammon:

Download

2013-05-20T19:07:09Z

RossGammon:

__NOTOC__
{{languages}}
== Linux ==

[[Image:Linux_220x261.png|55px|left]]

Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps-{{version}}.tar.gz Source]
    
[[Download#Linux distributions|via Distributions]]
    
[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</big>
{{-}}

== MS Windows ==

[[Image:windows_180x160.png|128px|left]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

<big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit)]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit)]</big>

After download: double-click to install Gramps.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-up into this new Tree.

Alternative independent MS Windows version [[#3|[3]]].

== Mac OS X ==

[[Image:macos_200x200.png|128px|left|link=http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe]]

Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Mac OS X 10.5 (Leopard), 10.6 (Snow Leopard) and 10.7 (Lion)    <big>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/Gramps-PPC-{{version_Mac}}-2.dmg Intel]
    
[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}}/Gramps-Intel-{{version_Mac}}-2.dmg Power PC]</big>

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next drag the Gramps application to your application folder and double-click to launch it [[#2|[2]]].

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. However if this fails for any reason, '''Create''' a new Family Tree and '''Import''' the back-uo into this new Tree.

== Live CD ==

[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]
'''Linux live CD Demonstration''' [[Linux_Genealogy_CD#Obtaining_the_CD|Obtaining the CD]] (727 MB) [[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]. Allows you to trial a pre-installed Gramps {{Version Linux Live CD}}, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn..). If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install [http://www.ubuntulinux.org/ Ubuntu 10.10] and Gramps from the CD anytime you like.

== Linux distributions ==

Most linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.

Below are ways to install Gramps on some of the more popular distributions:

{| border="1" cellspacing="0"
|Distribution
|GUI pkg manager
|Current versions
|Notes
|-
|'''Linux Mint'''
|Synaptic ??
|Nadia: Gramps 3.4.0-1 Lisa: Gramps 3.3.1-1 Isadora: Gramps 3.2.0-1
|
|-
|''' Mageia '''
|
|
|
|-
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''
| Software Centre
|Quantal: Gramps 3.4.0-1
|[http://packages.ubuntu.com/quantal/gramps available versions]
|-
|[[Image:Fedora_32x32.png]]''' Fedora '''
|Add/Remove Software (Gnome) or Software Management (KDE)
|Fedora Rawhide: Gramps 3.4.3 Fedora 18: Gramps 3.4.2.
|
|-
|''' Debian '''
|
|squeeze (old stable): Gramps 3.2.3 wheezy (stable): Gramps 3.4.0 jessie (testing): Gramps 3.4.0 [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 3.4.0
|[http://packages.debian.org/search?keywords=gramps available versions]
|-
|[[Image:Mandriva_32x32.png]]''' Mandriva '''
|Software Management in the 
Mandriva Linux Control Center
|
|Mandriva 2010.1: Gramps 3.3.1 Mandriva 2011: Gramps 3.2.6 See also [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates backports] and contrib repository
|-
|[[Image:Redhat_32x32.png]]''' Redhat '''
|
|
|
|-
|''' openSUSE '''
|YaST ??
|openSUSE 12.3: Gramps 3.4.2
|[http://software.opensuse.org/package/gramps available versions]
|-
|'''Slackware'''
|
|Slackware 14.0: Gramps 3.4.2
|[http://pkgs.org/search/?keyword=gramps available versions]
|}

{{-}}
== Linux: Install latest version ==

If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually. Instructions are given below for a number of distributions.

{{man warn|1=Warning|2=This should only be attempted by experienced users, and after you have backed up your Family Tree.

The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. If you try to install a different version of Gramps there is a possibility that the components needed for the new version of Gramps are not available for your distribution, or they are available, but don't work properly. You might not discover that there is a problem till you have already done some work with the new version of Gramps.

If you already have Gramps installed, and you are only making a 'point' upgrade (i.e. from Gramps x.y.z to x.y.z+1, e.g. from 3.4.3 to 3.4.4), then it is likely but not certain that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g. from 2.y.z to 3.y.z), then the danger that it does not work properly is much greater.}}

[[Image:Ubuntu_32x32.png]]'''Debian''' and ''' Ubuntu ''' [[http://sourceforge.net/projects/gramps/files/Stable/{{version}}/gramps_{{version}}-1_all.deb|Download the .deb file]]. Run the following command from the directory where the file was saved (change the filename to match the one you downloaded)
sudo dpkg -i gramps_3.4.4-1_all.deb

For other distributions, you could try [[Linux:Build from source]]

== Notes ==

[1]
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data

[2]
Alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.

[3]
An alternative independent version is [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 MB)
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' By Bart.S - '''[http://portableapps.com/blog/84601 Please report issues to the author.]''' (2012-09-07)

[[Category:Documentation]]

Census Addons

2012-04-08T13:19:40Z

RossGammon: Added information from Michiel Nauta answer to query on the Gramps forum

[[Category:Plugins]][[Category:Developers/General]][[Category:Reports]][[Category:Gramplets]]

There are two census addons: a gramplet and a report.

The gramplet allows users to create and edit census data in a single form.

The report prints census events in a format similar to the original census entries.

==Configuration==

Before using the census addons you need to define which of your sources are census sources.

To do this you need to edit each source and add an entry in the Data tab. The entry must have a key of "Census" and a value which is a code that identifies the census.

[[Image:SourceForCensus.png]]

Supported values are:
{| {{Prettytable}}
|-
! Code !! Description
|-
| UK1841 || 1841 England and Wales Census
|-
| UK1851 || 1851 England and Wales Census
|-
| UK1861 || 1861 England and Wales Census
|-
| UK1871 || 1871 England and Wales Census
|-
| UK1881 || 1881 England and Wales Census
|-
| UK1891 || 1891 England and Wales Census
|-
| UK1901 || 1901 England and Wales Census
|-
| UK1911 || 1911 England and Wales Census
|-
|}
{| {{Prettytable}}
|-
! Code !! Description (Key='''Recensement''')
|-
| - || 1774 French Census
|-
| FR1790 || 1790 French Census
|-
| FR1793 || 1793 (An II) French Census
|-
| FR1796 || 1796 (An V) French/Belgian Census
|-
| FR1801 || 1801 (An X) French/Belgian Census
|-
| FR1806 || 1806 French/Belgian Census
|-
| - || 1817 French Census
|-
| FR1820 || 1820/1821 French Census
|-
| FR1826 || 1826 French Census
|-
| FR1831 || 1831 French Census
|-
| FR1836 || 1836 French Census
|-
| FR1841 || 1841 French Census
|-
| FR1846 || 1846 French Census
|-
| FR1851 || 1851 French Census
|-
| FR1856 || 1856 French Census
|-
| FR1861 || 1861 French Census
|-
| FR1866 || 1866 French Census
|-
| FR1872 || 1872 French Census
|-
| FR1876 || 1876 French Census
|-
| FR1881 || 1881 French Census
|-
| FR1886 || 1886 French Census
|-
| FR1891 || 1891 French Census
|-
| FR1896 || 1896 French Census
|-
| FR1901 || 1901 French Census
|-
| FR1906 || 1906 French Census
|-
| FR1911 || 1911 French Census
|-
| FR1921 || 1921 French Census
|-
| FR1926 || 1926 French Census
|-
| FR1931 || 1931 French Census
|-
| FR1936 || 1936 French Census
|-
| FR || Local Census (not national)
|-
|}
{| {{Prettytable}}
|-
! Code !! Description
|-
| - || 1814 Belgian/French Census
|-
| - || 1829 Belgian/Nederland Census
|-
| BE1846 || 1846 Belgian Census
|-
| BE1856 || 1856 Belgian Census
|-
| BE1866 || 1866 Belgian Census
|-
| BE1880 || 1880 Belgian Census
|-
| BE1890 || 1890 Belgian Census
|-
| BE1900 || 1900 Belgian Census
|-
| BE1910 || 1910 Belgian Census
|-
|}
{| {{Prettytable}}
|-
! Code !! Description
|-
| US1790 || 1790 US Census
|-
| US1800 || 1800 US Census
|-
| US1810 || 1810 US Census
|-
| US1820 || 1820 US Census
|-
| US1830 || 1830 US Census
|-
| US1840 || 1840 US Census
|-
| US1850 || 1850 US Census
|-
| US1860 || 1860 US Census
|-
| US1870 || 1870 US Census
|-
| US1880 || 1880 US Census
|-
| US1890 || 1890 US Census
|-
| US1900 || 1900 US Census
|-
| US1910 || 1910 US Census
|-
| US1920 || 1920 US Census
|-
| US1930 || 1930 US Census
|-
|}
{| {{Prettytable}}
|-
! Code !! Description
|-
| CA1851EW-A || 1851 Canada East and West Census: Personal Census
|-
| CA1851EW-B || 1851 Canada East and West Census: Agricultural Census
|-
| CA1861EW || 1861 Canada East and West Census
|-
| CA1871 || 1871 Canadian Census
|-
| CA1881 || 1881 Canadian Census
|-
| CA1891 || 1891 Canadian Census
|-
| CA1901-1 || 1901 Canadian Census: Schedule 1
|-
| CA1901-2 || 1901 Canadian Census: Schedule 2
|-
| CA1906 || 1906 Canadian Census: Manitoba, Saskatchewan and Alberta
|-
| CA1911 || 1911 Canadian Census
|-
| CA1911-A1 || 1911 Canadian Census: Schedule A1
|-
| CA1916 || 1916 Canadian Census: Manitoba, Saskatchewan and Alberta
|-
|}

==Census Gramplet==

The census gramplet consists of a census listing and a census editor.

===Census Listing===

When the gramplet is loaded it lists all the census events for the active person. The listing displays the census source, date and place.

A new census event can be created by clicking the "New" button at the bottom of the gramplet.

An existing census event can be edited either by highlighting a row and clicking the "Edit" button or by double-clicking on a row.

===Census Editor===

[[File:census edition.png|thumb|400px|right|Census edition]]

The census editor is designed so that most census data can be entered into a single form.

* The first thing to enter is the census source. This is selected from a drop-down list at the top of the editor.

* Once the source has been selected the census date is populated automatically.

* Next a source reference can be entered. This should comprise of one or more references that uniquely identify the census entry. In the case of a UK census you will need to enter the PRO reference, Piece, Folio and Page.

* A place can be selected in the usual Gramps manner.

At the bottom of the editor there is a table which allows the user to enter data specific to individual people listed on the census return. A new person can be created and then added to the census by clicking the "+" button. A person already in Gramps can be added to the census by clicking the second button ("share"). A census source must be selected before people can be added to the list, and after the first person is added, the source can no longer be changed.

The cells in the table are editable. By clicking on a cell, the user can enter data from the census return into a corresponding column in the table.

A person can be removed from the list by clicking the "-" button.

The order of people in the list can be changed by highlighting a row and then using the up and down arrow buttons.

The census data can then be saved by clicking the "OK" button or discarded using "Cancel".

==Samples==

===Census Report===

The census report prints census events in a format similar to the original census entries.

Which censuses are printed is determined by settings in the Report Options.

A drop-down list allows the following options:

* By Person
* By Source
* By Person and Source
* All Census records

Use the first option to print all census records for a given person. This defaults to the current person but can be changed using a selector.

Use the second option to print all census records for a given source. Select the required source from the drop-down list.

The third option can be used to print a single census. Both the person and source selections are taken into account.

The last option prints all censuses in the database.

''Census Report for Martin, John''
1881
Date: 3 Apr 1881
Source Reference: 17 Hope Terrace - RG 11 /2854 page 27
Address: Wednesbury

Name Relation Condition Age Occupation Where Born Disability
Martin, John Head Married 36 Laborer Wednesbury /
N., Zillah Wife 36 Golds Greence
Martin, Arthur Son 11 Scholar Wednesbury
Martin, Zillah Daughter 7 Scholar Wednesbury
Martin, Catherine Daughter 5 Scholar Wednesbury

===NarrativeWeb Report===

[[File:narrative census.png|thumb|370px|right|Census data on individual form for NarrativeWeb Report]]

[[File:narrative events.png|thumb|370px|left|Shared Event]]

 

==Data Storage==

[[File:census data.png|thumb|400px|right|Census data]]

Each census return is stored as a single event record with an event type of "Census".

The chosen source is attached to the event and contents of the "Reference" field are stored and the "Volume/Page" field of the associated source reference object.

The "Date" and "Place" fields are stored in the event object.

Each person in the table is attached to the event. The contents of the table are stored as attributes in the associated event reference object. The attribute type is set to the column heading and the value is set to the contents of the cell. An additional attribute called "Order" contains an integer which defines the position that the person appears in the census.

The addons will read existing data in this format. If "Order" attributes do not exist, they will be created when the editor saves a record. Until then the order of the people in the census will not be defined.

Data can also be edited using the usual Gramps editors.

==Example of using the Census Addon==

This is an example of how to get started with the Census Addon after it is installed as described above. The 1941 UK census is used as the example:
# Start or open a family tree in Gramps.
# Add a person (name and gender) if this is a new family tree.
# Go to the Source view.
# Add a source with a title like "Source for 1841 Census"
# Open that source and go to the "Data" tab.
# Click on the plus symbol to add a key and value.
# Fill in in the key column with "Census" and hit enter.
# Click on Value column and fill in "UK1841", hit enter.
# Click on OK.
# Reopen the Source to see if the key and value pair have been successfully stored in the "Data" tab (optional).
# Go to the People view and switch on the sidebar (View->sidebar).
# Add the "Census Gramplet" by rightclicking on the side bar and choosing "Add Gramplet->Census Gramplet".
# Select the person that you created (or an existing person that appears in that census) in the main window.
# In the Census Gramplet on the sidebar, click "New".
# The New Census" gramplet form should open and you can click on the arrow down bútton to the right of "Source". You should see the "Source for 1841 Census". Select this.
# Now you can enter all of the details from the census (e.g. Reference to the page and the address), and then add people in the normal Gramps way.
# Fill in the details from the census page against each person.

==Known Issues==

When using the census editor the user should not edit the same event using the standard Gramps event editor.

When the save button in the editor is clicked, the person records of the people in the census are updated. If a person is being edited using the Gramps person editor and the record is saved then data saved using the census editor will be lost for this person.

==Future Enhancements==

I plan to implement the following enhancements:
* Add heading fields for Municipal Ward, Ecclesiastical Parish etc...
* Split the Source Reference Page/Volume field into its component parts. (e.g. Ref., Piece, Folio, Page)
* Add a census image to gallery of the Event object.
* Add the current person when creating a new census.
* Improve data entry into the table cells. Automatically edit the next cell when "Enter" is pressed.

The following have been requested but require further thought:
* Add check-boxes to automatically add the census source to selected Gramps records.
* Ensure that attributes are kept in the correct order in the Gramps editor.
* Remove the need to add Data tags to sources. Create a tool to define census sources and store them in the Gramps configuration file.

==External Links and ressources==

* [[Census|Census page on wiki]]
* [[Events_manager#Census_Addon|Sample of use]]
* [http://www.chradams.co.uk/censusxml/howitworks.php Census XML project]
* [http://www.nappdata.org/napp/index.shtml North Atlantic Population Project]