Changes

{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''20202022-0802-1305'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as [https://www.python.org/doc/sunset-python-2/ Python 2 support dropped]. Uses GTK+ 3 GUI. Default database is now SQliteSQLite. Lot of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]{{-}}

Before upgrading your distribution: Use your '''old earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|[XML format^1]]].  

Before downloading the [[All_In_One_Gramps_Software_Bundle_for_Windows|All-In-One software installer bundle for Windows]]: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format¹]].

Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO cx freeze-based|this page]] (English only).Or, you might want to look at the description of what is meant by an [[All_In_One_Gramps_Software_Bundle_for_Windows|All In One Bundle.]]

A [https://portableapps.com/apps/education/gramps_portable '''PortableApps ''' version] will run from an external device without the requirement of installing on the OS drive. [[#2|PortableApps installations²]] are <b><i>not</i></b> for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives. You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:* the [https://portableapps.com/apps/education/gramps_portable Gramps Portable project] page in their [https://portableapps.com/apps/education/ Education] category.  Note that '''PortableApps.com''' also has a Legacy 3.4.9 version of Gramps available -- although it is not recommended for general use; just for recovering older format databases.* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB)

{{man menu|You can download Gramps Portable version 5.1.3-2 from https://portableapps.com/apps/education/gramps_portable .}} Note that PortableApps.com also have available an old version of Gramps and it is not recommended for general use; 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 - '''[httphttps://portableapps.com/blogforums/84601 support/education Please report packaging issues to the author.here]''' (2012-09-07)

Before downloaddownloading the ready-to-run stand-alone bundle: Use your '''old earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|[XML format^1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.

Tested for compatibility with Apple macOS/Mac OS X versions 10.5 13 ([https://en.wikipedia.org/wiki/Mac_OS_X_Leopard LeopardMacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 11 12 ([https://en.wikipedia.org/wiki/MacOS_Big_Sur Big SurMacOS_version_history#Version_12:_%22Monterey%22 Monterey]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''

</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. (For Apple Mac OS X, 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.)

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 Should this fails fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the back-up ]] into this new Tree.

Alternatively, Gramps can also be built and installed on macOS using either the MacPorts or Homebrew package manager systems.

 The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.  [https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux).  See https://github.com/homebrew/.

{{man tip|[[Mac_OS_X:Application_package#Dictionaries|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 [https://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.}}

* Debian 8 ("jessie")(old old old stable): Gramps 4.1.1<!-- Debian 8 EOL ~2020-06-30 https://wiki.debian.org/DebianReleases#Production_Releases / Extended Long Term Support until ~2022-06-30 -->* Debian 9 ("stretch") (old old stable): Gramps 4.2.5

* Debian 10 ("buster") (old stable): Gramps 5.0.1

* Debian 11 ("bullseye ")(stable): Gramps 5.1.3* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.5* bookworm (testing): Gramps 5.1.35* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.35

* Xenial Bionic Beaver (1618.04 LTS): Gramps: 45.21.2* Xenial Focal (1620.04 LTS): Gramps: 45.21.6 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport])3* Bionic Beaver Hirsute (1821.04 LTS): Gramps: 5.01.03* Eoan Impish (1921.10): Gramps: 5.0.1* Focal (20.04 LTS): Gramps: 5.1.24* Groovy Gorilla Jammy (Development: 2022.1004): Gramps: 5.1.35

* 18.x(Gramps 4.2.2~dfsg-1)* 19.x(Gramps 4.2.8)<!-- EOL April 2023 -->* 20.x(Gramps 5.1.2)<!-- EOL April 2025 -->

* Rawhide (Gramps 5.1.35)* Fedora 31 34 (Gramps 5.1.35)* Fedora 32 35 (Gramps 5.1.35)* Fedora 32 35 (Gramps 5.1.35)

* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.35* Mageia 78.10: Gramps 5.01.13

|<!-- Current versions --><!-- https://www.mageia.org/en/support/ -->* openSUSE Tumbleweed: Gramps 5.1.35* openSUSE Leap 15.23: Gramps 4.2.8* openSUSE Leap 15.1<!-- is expected to be maintained until end of November 2022 https: Gramps 4//en.2.8* openSUSE Leap 15opensuse.0: Gramps 4.2.8org/Lifetime#openSUSE_Leap -->

* Gramps 5.1.35

* Gramps 5.1.34* Gramps 5.1.5 (testing)

* NetBSD: [http://pkgsrc.se/databases/gramps3 Gramps 3.4.9]* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.25]

* [https://www.freshports.org/science/gramps/ FreshPorts: Gramps 5.1.15]|<!-- Notes --><!--[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]-->

* OpenBSD: Gramps 5.1.35

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 35.41.3 to 35.41.45), 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 24.y.z to 35.y.z), then the danger that it does not work properly is much greater.}}

For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{versionVersion Linux Debian}}/gramps_{{Version Linux Debian}} -1_all.deb 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 ({{man menu|change the filename to match the one you downloaded}}).

If you see an error about an incomplete GTK installation and missing language support translations when starting Gramps, run

Gramps 5.1.3 {{Version Linux Flatpak}} is available in as a flatpak Flatpak at flathubFlathub.

{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the 5.1.3 flatpak{{Version Linux Flatpak}} Flatpak.}}

First set up flatpak Flatpak and the flathub Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/

Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with flathubFlathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:

== Linux Live CD ==

{{man warn|Note that both this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD demonstrations use }} an old version of Gramps released 2010-11-17 and it is not recommended for general use}}

'''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, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is 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] and Gramps from the CD anytime you like.

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

* [[User:Sam888#Gramps_Downloads_.28sinceCategory:_2001.2F04.2F21.29Versions|Rough download statisticsVersions on various platforms]]