Changes

[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]'''Research, organize and share your family tree with Gramps.'''

{{man note|{{Man menu|Gramps '''Current version: '''{{version}} ''' Released: 2020'''2022-0102-1005'''}}|''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?]]{{-}}[[File:Linux_220x261.png|128px|link=Download#Linux]] [[File:windows_180x160.png|128px|link=Download#MS_Windows]] [[File:macos_200x200.png|128px|link=Download#macOS]] [[File:Bsd daemon.png|128px|link=Download#BSD]]}}

[[File:Linux_220x261.png|128px|left|link=Download#Linux]] Before upgrading your distribution: 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¹]].  

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. Should this fail for any reason, '''Create''' a new Family Tree and [[File:windows_180x160.png|128pxHow_to_restore_a_backup|left'''Import''' the back-up]]into this new Tree.

Before download: Use your '''old the Windows AIO (All-In-One) version of Gramps''' to , please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[How_to_make_a_backup#Gramps_version_3.3_and_laterGrampsAIO cx freeze-based|backupthis page]] your Family Trees (English only). Or, you might want to look at the description of what is meant by an [[#1All_In_One_Gramps_Software_Bundle_for_Windows|[1All In One Bundle.]]].

Supports Microsoft Windows in all versions === Alternative independent installation ===[http[File://windowsGramps-release.microsoft.com/en-au/windows/lifecycle Vista/7png|left]] and later.(''Please note: PythonIf needed, there are alternatives to the All-3.5 and GtkIn-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.4One installer.4)'')

==== PortableApps.com ====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. PortableApps installations are <bigb><ui>[{{github_url}}not</releasesi></b> for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives. You can download/vthe '''{{version_windows_AIO32Version_windows_portable}}Gramps Portable version''' from:* the [https:/{{filename_windows_AIO32}}/portableapps.exe Windows Installer (32-bit) {{version_windows_AIO32}}com/apps/education/gramps_portable Gramps Portable project]<page in their [https://portableapps.com/apps/education/u>Education] category.  &nbsp;&nbsp;&nbsp;&nbspNote 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.<u>* [{{github_url}}http://sourceforge.net/projects/releasesportableapps/downloadfiles/v{{version_windows_AIO64}}Gramps%20Portable/{{filename_windows_AIO64}}GrampsPortable_3.4.9.paf.exe ] (29.0 MB)  [http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows Installer . ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (64Or the path you installed it to) or make a shortcut to that file on your desktop or start-bit) {{version_windows_AIO64}}]<menu.'' '''[https://portableapps.com/forums/u><support/big>education Please report packaging issues here]'''

After download: double-click to ==== Chocolatey NuGet Package ====You may also install Gramps. {{man menu|[[Download#Missing_other_languages|Missing other languages]] - Standard setup is British ''English only'' so if using a different language (or the American or Australian dialect of English) please ensure that you select extra dictionary and language files when asked during the installation process.}}alternative independent Gramps Chocolatey NuGet Package

{{man tip|Shortcuts|Once installed one shortcut Chocolatey NuGet is placed on the desktop and in the Start menu two shortcuts are addeda Machine Package Manager, please only use the first shortcutsomewhat like apt-get, unless requested by a developerbut built with Windows in mind.<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut for everyday use of Gramps}}<br>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* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]

Use the ==== Gramps for 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 cx freeze-based|this page]] (English only).with MSYS2 ====

Alternative independent '''Legacy''' MS Windows version [[#2|How to use [2]]https://www.msys2.org/ MSYS2]to run latest Gramps development version from source in 64bit Windows.

You may also install using the alternative independent Gramps Chocolatey Package * [[#3|[3]Gramps for Windows with MSYS2]].

The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary.  If you want prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation. To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation. Even your primary language is installed by default, you might anticipate the need to run Gramps spellcheck Notes in another language other than the British dialect of English using . Be certain to select the appropriate languages from '''Dictionaries'''. Gramps will not access your Operating System's native dictionary. There is no simple facility for adding interface or dictionary languages after installation.{{-}} <span id="Mac OS X><!-- backward compatibility hyperlinking anchor--> == macOS ==</span>[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]]  Before downloading the ready-to-run stand-alone bundle: 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¹]]. Read the [[Mac OS X:Application package|before installation]] instructions. Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 12 ([https://en.wikipedia.org/wiki/MacOS_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>* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u></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 AIO installerapplication 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 must select can allow it to be upgraded if necessary, and it during will be opened. Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the back-up]] into this new Tree. === Alternative independent installation process===[[File:Gramps-release.png|left]]Alternatively, Gramps can also be built and installed on macOS using MacPorts.

== MacPorts is a package manager for Apple Mac OS X ==.

* [[FileMac_OS_X:macos_200x200.png|128px|leftBuild_from_source:MacPorts]]

<big><u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}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 Intel {{version_Mac}}]</u></big> &nbsp;&nbsp;&nbsp;&nbsp; . It does not depend on or use any of the Homebrew-built libraries.

Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened[https://wikipedia. However if this fails org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for any reason, '''Create''' a new Family Tree macOS (and '''Import''' the back-up into this new TreeLinux).

{{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 [See https://extensionsgithub.openoffice.orgcom/ 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<homebrew/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.}}

{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on ''Repology''( [https://repology.org/metapackage/gramps/versions )''Repology'']<br>Please report any problems with them to the package maintainer.}}

|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''

|<!-- Current versions -->* Debian 8 ("jessie")(old old old stable): Gramps 4.1.1<br!-- Debian 8 EOL ~2020-06-30 https://wiki.debian.org/DebianReleases#Production_Releases / Extended Long Term Support until ~2022-06-30 -->* Debian 8 9 ("jessiestretch")(backportsold old stable): Gramps 4.2.5<br>* Debian 8 9 ("jessiestretch")([https://packages.debian.org/stretch-backports-sloppy/gramps backports]): Gramps 45.20.8<br>1* Debian 9 10 ("stretchbuster") (old stable): Gramps 45.20.5<br>1* Debian 9 10 ("stretchbuster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.01.1<br>2* Debian 10 11 ("busterbullseye") (stable): Gramps 5.01.1<br>3* Debian 10 11 ("busterbullseye")([https://packages.debian.org/bullseye-backports) (stable/gramps backports]): Gramps 5.1.1<br>bullseye 5* bookworm (testing): Gramps 5.1.1<br>5* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.15

|<!-- Distribution -->[[File:Ubuntu_32x32.png]]''' [https://ubuntu.com/ Ubuntu ]'''

|<!-- Current versions -->Xenial * Bionic Beaver (1618.04 LTS): Gramps: 45.21.2<br>Xenial * Focal (16.04 LTS): Gramps: 4.2.6 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport])<br>Bionic Beaver (1820.04 LTS): Gramps: 5.01.0<br>Disco 3* Hirsute (1921.04): Gramps: 5.01.1<br>Eoan 3* Impish (1921.10): Gramps: 5.01.1<br>Focal 4* Jammy (Development: 2022.04 LTS): Gramps: 5.1.15

|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''

|<!-- Current versions -->18* 19.x(Gramps 4.2.2~dfsg-18)<br!-- EOL April 2023 -->19* 20.x(Gramps 45.1.2.8)<!-- EOL April 2025 -->|<!-- Notes -->Install * Use the "Software Manager" to install a recent version.* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br><br>* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]

|<!-- Distribution -->[[File:Fedora_32x32.png]]''' [https://getfedora.org/ Fedora ]'''

|<!-- Current versions -->* Rawhide (Gramps 5.1.1)<br>Fedora 29 (Gramps 5.0.2)<br>* Fedora 30 34 (Gramps 5.1.15)<br>* Fedora 31 35 (Gramps 5.1.15)<br>* Fedora 32 35 (Gramps 5.1.15)|<!-- Notes -->[https://appskoji.fedoraproject.org/packageskoji/gramps packageinfo?packageID=1969 available versions]

|<!-- Current versions -->* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.01.1<br>5* Mageia 68.10: Gramps 5.01.13

|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] ''' [https://www.opensuse.org/ openSUSE ]'''

|<!-- Current versions --><!-- https://www.mageia.org/en/support/ -->* openSUSE Tumbleweed: Gramps 5.1.1<br>5* openSUSE Leap 15.13: Gramps 4.2.8<br>openSUSE Leap 15.0!-- is expected to be maintained until end of November 2022 https: Gramps 4//en.2opensuse.8org/Lifetime#openSUSE_Leap -->

|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''|<!-- GUI Package manager -->|<!-- Current versions -->* 15.0: Gramps ?.?.?* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]* 14.2: Gramps 4.2.6* 14.1: Gramps 4.0.3|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]|-|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]|<!-- Current versions -->* Gramps 5.1.5|<!-- Notes -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]|-|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''

|<!-- Current versions -->14.2: * Gramps 45.21.6<br>144* Gramps 5.1: Gramps 4.0.35 (testing)|<!-- Notes -->[httphttps://pkgspackages.org/search/?keyword=gramps available versions]<br>[https://slackbuildsgentoo.org/repository/14.2packages/app-misc/gramps/?search=gramps slackbuilds.orgavailable versions]: Gramps 5.0.0

|<!-- Current versions -->* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 35.41.45]|<!-- Notes -->[http://pkgsrc.se/databases/gramps3 available versions]

|<!-- Current versions -->* FreeBSD: Gramps 4.2.8|<!-- Notes -->[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions] or * [https://www.freshports.org/science/gramps/ FreshPorts -- science/gramps]|-|<!-- Distribution -->'''TrueOS'''|<!-- GUI Package manager -->|<!-- Current versions -->PC-BSD: Gramps 35.41.85]|<!-- Notes --><!--[http://webportsmon.pcbsdfreebsd.org/pcportoverview.py?category=science&portname=gramps available versions]-bsd-is-now-trueos/ 2016/09/01 - PC-BSD is now TrueOS]>

|<!-- Current versions -->* OpenBSD: Gramps 45.21.85

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 [[ImageFile:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[ImageFile: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}}).

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

dpkg-query -s python3-gramps

sudo dpkg -r python3-gramps

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

[[File:Bsd daemon.jpgpng|128px|left|link=Download#BSD]]

== 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.}}