15
edits
Changes
Improving mac section, adding homebrew.
{{languages|Download}}
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]
'''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|Gramps '''Current version: '''{{version}}''' Released: '''2020-0108-1013'''}}|''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 SQlite. 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#Mac_OS_XmacOS]] [[File:Bsd daemon.jpgpng|128px|link=Download#BSD]]}}
== Linux ==
== MS Windows ==
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]
Before downloading the [[FileAll_In_One_Gramps_Software_Bundle_for_Windows|All-In-One software installer bundle for Windows]]:windows_180x160Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.png3_and_later|128pxbackup]] your Family Trees to the hardy and portable [[#1|left|link=Download#MS_WindowsXML format<sup>1</sup>]].
<big>*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u> *<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u></big>
After download: '''double-click to install Gramps'''. {{man menu|<br>By default: new releases will be added in a new directory and earlier installations of Gramps will ''not'' be overwritten; the language will be a [[Download#Missing_other_languages|Missing other languagesmix of British and US English]] - 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.}}
{{man tip|Shortcuts|Once installed During installation, one shortcut is placed on the desktop and in the Start menu two shortcuts are added, please the Start menu. <br>''Please only use the first 'console' secondary shortcut, unless when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu|<--- Shortcut ← for everyday normal 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 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.
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).
You may also install using the alternative independent Gramps Chocolatey Package [[#3|[Chocolatey NuGet Package<sup>3]</sup>]].
{{-}}
=== Missing other languages ===
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. If you want to run Gramps in another prefer a different language other than (or spell with the US or Australian dialects of English using the Gramps AIO installer), then please ensure that you must select it during pay special attention to the Choose Components phase of the installation process.
{{-}}
<span id== "Mac OS X ==><!-- backward compatibility hyperlinking anchor-->
== macOS ==</span>[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]]
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 Apple macOS/Mac OS X in all versions 10.5 ([https://wikipedia.org/wiki/Mac_OS_X_Leopard Leopard]) and later.(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 application to your application folder and double-click to launch it [[#4|[4]]].
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.
Gramps can also be installed on MacOS using the MacPorts[[#5|[5]]] framework or Homebrew package manager[[#6|[6]]].
{{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 [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.}}
{{-}}
== <span id="Linux distributions"></span>Linux and BSD distributions ==
{{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.}}
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.
!Notes
|-
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''
|<!-- GUI Package manager -->Add/Remove Software
|<!-- Current versions -->
* Debian 8 ("jessie")(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 stable): Gramps 4.2.5
* Debian 9 ("stretch")([https://packages.debian.org/stretch-backports/gramps backports]): Gramps 5.0.1
* Debian 10 ("buster") (stable): Gramps 5.0.1
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2
* bullseye (testing): Gramps 5.1.23* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.23
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]
|-
* Bionic Beaver (18.04 LTS): Gramps: 5.0.0
* Eoan (19.10): Gramps: 5.0.1
* Focal (Development: 20.04 LTS): Gramps: 5.1.2* Groovy Gorilla (Development: 20.10): Gramps: 5.1.3
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])
|-
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''
|<!-- GUI Package manager -->Software Manager
|<!-- Current versions -->
* 18.x(Gramps 4.2.2~dfsg-1)
* 19.x(Gramps 4.2.8)
* 20.x(Gramps 5.1.2)|<!-- 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]]''' Fedora '''
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)
|<!-- Current versions -->
* Rawhide (Gramps 5.1.23)* Fedora 30 31 (Gramps 5.1.23)* Fedora 31 32 (Gramps 5.1.23)* Fedora 32 (Gramps 5.1.23)|<!-- Notes -->[https://appskoji.fedoraproject.org/packageskoji/gramps packageinfo?packageID=1969 available versions]
|-
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|<!-- Current versions -->
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.12
* Mageia 7.1: Gramps 5.0.1
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]
|<!-- Current versions -->
* openSUSE Tumbleweed: Gramps 5.1.12* openSUSE Leap 15.2: Gramps 4.2.8
* openSUSE Leap 15.1: Gramps 4.2.8
* openSUSE Leap 15.0: Gramps 4.2.8
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]]'''[https://www.archlinux.org/ Arch Linux]'''
|<!-- GUI Package manager -->
|<!-- Current versions --> * Gramps 5.1.2
|<!-- Notes -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]
|-
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''
|<!-- GUI Package manager -->
|<!-- Current versions --> * Gramps 5.1.23
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]
|-
* [https://www.freshports.org/science/gramps/ FreshPorts: Gramps 5.1.1]
|<!-- Notes -->[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
|-
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''
|<!-- GUI Package manager -->
|<!-- Current versions -->* OpenBSD: Gramps 5.1.1
|<!-- Notes -->[http://openports.se/misc/gramps available versions]
|-
=== Debian-based ===
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/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 ({{man menu|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:
to install the dependencies.
If you see an error about language support when starting Gramps, run
sudo apt install language-pack-gnome-en
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.
==== 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 )
== BSD ==
[[File:Bsd daemon.jpgpng|128px|left|link=Download#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]]].
[<span id="5">5</span>]
The MacPorts Project is an open-source community initiative to design an easy-to-use system for compiling, installing, and upgrading open-source software on the Mac operating system. https://www.macports.org/ In order to do that run the following command: <code>port install gramps</code> see: [[Mac OS X:Build from source:MacPorts]]
[<span id="6">6</span>]
Homebrew is an open-source package manager for macOS (and Linux). See https://github.com/homebrew/.
== See also ==
