Difference between revisions of "Download"

From Gramps
Jump to: navigation, search
(Community supported: 2012-05-23 (64 bit only) no exe's for 32 bit versions available)
(Debian-based)
(465 intermediate revisions by 22 users not shown)
Line 1: Line 1:
{{languages}}
+
{{languages|Download}}
===The latest released version===
+
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]
* Version '''GRAMPS''' {{version}} was released.  All releases of GRAMPS are available from [https://sourceforge.net/projects/gramps/files/ the download page on SourceForge].
+
'''Research, organize and share your family tree with Gramps.'''
  
Visit the following page for instructions on:
+
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.
* [[Installation]]
 
* [[Installation#Upgrading_GRAMPS|Upgrading]]
 
* [[3.3 Addons|Addons]] - third-party plugins
 
  
===Officially supported===
+
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2020-01-10'''}}|''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?]]{{-}}
* Only the Linux platform is officially supported as [[Portal:Developers|GRAMPS developers]] use and test the '''source code''' on that platform, fixing any problems that arise due to upgrades.
+
[[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]]}}
  
{| {{Prettytable}}
+
== Linux ==
! Platform
+
 
! GRAMPS<br>Release
+
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]
! Download
+
 
! Note
+
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]]].
|-
+
 
|<!-- Platform -->Linux
+
<big>
|<!-- GRAMPS<br>Release -->[https://gramps.svn.sourceforge.net/svnroot/gramps/branches/maintenance/ Maintenance]<br>{{Needs backup}}
+
<u>[[Download#Linux distributions|via Distributions]]</u>
|<!-- Download -->[[Installation#Installing_GRAMPS_from_source_code|Installation from source]]
+
&nbsp;&nbsp;&nbsp;&nbsp;
|<!-- Note -->Building of GRAMPS from source required
+
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big>
|}
+
{{-}}
 +
 
 +
== MS Windows ==
 +
 
 +
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]
 +
 
 +
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<sup>1</sup>]].
 +
 
 +
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.
 +
 
 +
(''Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16'')
 +
 
 +
<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'''. <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 [[#Missing_other_languages|mix of British and US English]].
 +
 
 +
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}''      {{man menu| &larr; for 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. 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.
 +
 
 +
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).
 +
 
 +
If necessary, there is an alternative independent '''Legacy''' MS Windows [[#2|portable version<sup>2</sup>]].
 +
 
 +
You may also install using the alternative independent Gramps [[#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 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 spellcheck Notes in other than the British dialect of English. 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 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 (Leopard) and later.
 +
 
 +
<big><u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u></big>
 +
&nbsp;&nbsp;&nbsp;&nbsp;
 +
 
 +
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.
 +
 
 +
{{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.}}
 +
 
 +
 
 +
An alternative way to download and install Gramps on MacOS can be done using the MacPorts[[#5|[5]]] framework.
 +
{{-}}
 +
 
 +
== <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 [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.
  
===Community supported===
+
Below are ways to install Gramps on some of the more popular distributions:
*A platform is community supported when users have created an installable version for that platform. Full functionality of GRAMPS is not guaranteed and some components may be disabled. Developers are dependent on the community to fix any issues that arise. The GRAMPS developers aim to have GRAMPS working on all platforms, but have no resources to do specific testing to assure this is the case on release of a new version.
 
  
{| {{Prettytable}}
+
{| {{prettytable}}
! Platform
+
!style="width: 85pt;" | Distribution
! GRAMPS<br>Release
+
!GUI Package manager
! Download
+
!Current versions
! Note
+
!Notes
 
|-
 
|-
|<!-- Platform -->Windows, 32-bit
+
|<!-- Distribution        -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''
|<!-- GRAMPS<br>Release -->{{version_windows_AIO32}}<br>(All In One)<br>{{Needs backup}}
+
|<!-- GUI Package manager -->Add/Remove Software
|<!-- Download -->[http://sourceforge.net/projects/gramps/files/Stable/3.3.1/ GrampsAIO-{{version_windows_AIO32}}-2.exe]<br>(41.9 MB)
+
|<!-- Current versions    -->
|<!-- Note --> [[All In One Gramps Software Bundle for Windows |All In One GRAMPS]] includes all dependencies required for Windows<br>By Josip - '''Please report issues to the author.''' (2011-10-02)
+
* Debian 8 ("jessie")(old old stable): Gramps 4.1.1<!-- Debian 8 EOL ~2020-06-30  https://wiki.debian.org/DebianReleases#Production_Releases -->
 +
* 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.2
 +
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.2
 +
|<!-- Notes              -->[http://packages.debian.org/search?keywords=gramps available versions]
 
|-
 
|-
|<!-- Platform -->Windows, 64-bit
+
|<!-- Distribution        -->[[File:Ubuntu_32x32.png]]''' Ubuntu '''
|<!-- GRAMPS<br>Release -->{{version_windows_AIO64}}<br>(All In One)<br>{{Needs backup}}
+
|<!-- GUI Package manager -->Software Centre
|<!-- Download -->[http://sourceforge.net/projects/gramps/files/Stable/{{version_windows_AIO64}} GrampsAIO64-{{version_windows_AIO64}}.exe]<br>(46.0 MB)
+
|<!-- Current versions    -->
|<!-- Note --> [[All In One Gramps Software Bundle for Windows |All In One GRAMPS]] includes all dependencies required for Windows x64<br>(2012-05-23)
+
* Xenial (16.04 LTS): Gramps: 4.2.2
 +
* Xenial (16.04 LTS): Gramps: 4.2.6 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport])
 +
* Bionic Beaver (18.04 LTS): Gramps: 5.0.0
 +
* Eoan (19.10): Gramps: 5.0.1
 +
* Focal (20.04 LTS): Gramps: 5.1.2
 +
* Groovy Gorilla (Development: 20.10): Gramps: 5.1.2
 +
|<!-- Notes              -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])
 
|-
 
|-
|<!-- Platform -->Windows
+
|<!-- Distribution        -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''
|<!-- GRAMPS<br>Release -->{{version_windowsOS}}<br>{{Needs backup}}
+
|<!-- GUI Package manager -->Software Manager
|<!-- Download -->[http://sourceforge.net/projects/gramps/files/Stable/{{version_windowsOS}} gramps-{{version_windowsOS}}-1.exe] (8.2 MB)
+
|<!-- Current versions    -->
|<!-- Note -->[[Windows_installer#Installation|Download and install Windows dependencies first]]
+
* 18.x(Gramps 4.2.2~dfsg-1)
 +
* 19.x(Gramps 4.2.8)
 +
|<!-- Notes              -->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]
 
|-
 
|-
|<!-- Platform -->Windows
+
|<!-- Distribution        -->[[File:Fedora_32x32.png]]''' Fedora '''
|<!-- GRAMPS<br>Release -->{{version_windows_portable}}<br>{{Needs backup}}
+
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)
|<!-- Download -->[http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe]<br>(18.7 MB)
+
|<!-- Current versions    -->
|<!-- Note -->[http://portableapps.com/apps/education/gramps_portable Portable GRAMPS from PortableApps.com] includes all dependencies required for Windows.<br>''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.''<br>By Bart.S - '''Please report issues to the author.''' (2011-05-17)
+
* Rawhide (Gramps 5.1.2)
 +
* Fedora 30 (Gramps 5.1.2)
 +
* Fedora 31 (Gramps 5.1.2)
 +
* Fedora 32 (Gramps 5.1.2)
 +
|<!-- Notes              -->[https://apps.fedoraproject.org/packages/gramps available versions]
 
|-
 
|-
|<!-- Platform -->
+
|<!-- Distribution        -->'''[https://www.mageia.org/en/ Mageia]'''
|<!-- GRAMPS<br>Release -->
+
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]
|<!-- Download -->
+
|<!-- Current versions    -->
|<!-- Note -->
+
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.2
 +
* Mageia 7.1: Gramps 5.0.1
 +
|<!-- Notes              -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]
 
|-
 
|-
|<!-- Platform -->Linux
+
|<!-- Distribution        -->[[File:OpenSUSE-distribution-icon.png|32px]]''' openSUSE '''
|<!-- GRAMPS<br>Release -->{{version}}<br>{{Needs backup}}
+
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]
|<!-- Download -->[[Installation#Automatic_download_and_install_of_GRAMPS|Automatic installation]]
+
|<!-- Current versions    -->
|<!-- Note -->Depends on version of Linux used
+
* openSUSE Tumbleweed: Gramps 5.1.2
 +
* openSUSE Leap 15.2: Gramps 4.2.8
 +
* openSUSE Leap 15.1: Gramps 4.2.8
 +
* openSUSE Leap 15.0: Gramps 4.2.8
 +
|<!-- Notes              -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository
 
|-
 
|-
|<!-- Platform -->Linux
+
|<!-- Distribution        -->[[File:Slackware-distribution-icon.jpg|32px]]'''Slackware'''
|<!-- GRAMPS<br>Release -->{{version}}<br>{{Needs backup}}
+
|<!-- GUI Package manager -->
|<!-- Download -->[[Installation#Manual_download_and_install_of_GRAMPS|Manual installation]]
+
|<!-- Current versions    -->
|<!-- Note -->Depends on version of Linux used
+
* 14.2: Gramps 4.2.6
 +
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]
 +
* 14.1: Gramps 4.0.3
 +
|<!-- Notes              -->[http://pkgs.org/search/?keyword=gramps available versions]
 
|-
 
|-
|<!-- Platform -->
+
|<!-- Distribution        -->[[File:archlinux-icon-crystal-32.svg]]'''[https://www.archlinux.org/ Arch Linux]'''
|<!-- GRAMPS<br>Release -->
+
|<!-- GUI Package manager -->
|<!-- Download -->
+
|<!-- Current versions    -->
|<!-- Note -->
+
* Gramps 5.1.2
 +
|<!-- Notes              -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]
 
|-
 
|-
|<!-- Platform -->Linux Live CD<br>'''Demonstration'''
+
|<!-- Distribution        -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''
|<!-- GRAMPS<br>Release -->{{Version Linux Live CD}}<br>{{Needs backup}}
+
|<!-- GUI Package manager -->
|<!-- Download -->[[Linux_Genealogy_CD#Obtaining_the_CD|ubuntu10.10 lgenealogy-6.1-desktop-i386.iso]]<br>(727 MB)
+
|<!-- Current versions    -->
|<!-- Note -->[[Linux Genealogy CD|Linux Genealogy CD based on Ubuntu 10.10 (Maverick Meerkat)]]<br>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..''')
+
* Gramps 5.1.2
 +
|<!-- Notes              -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]
 
|-
 
|-
|<!-- Platform -->
+
|<!-- Distribution        -->'''[https://www.netbsd.org/ NetBSD]'''
|<!-- GRAMPS<br>Release -->
+
|<!-- GUI Package manager -->
|<!-- Download -->
+
|<!-- Current versions    -->
|<!-- Note -->
+
* NetBSD: [http://pkgsrc.se/databases/gramps3 Gramps 3.4.9]
 +
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.2]
 +
|<!-- Notes              -->
 
|-
 
|-
|<!-- Platform -->BSD
+
|<!-- Distribution        -->'''[https://www.freebsd.org/ FreeBSD]'''
|<!-- GRAMPS<br>Release -->{{version_BSD}}<br>{{Needs backup}}
+
|<!-- GUI Package manager -->
|<!-- Download -->[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps FreeBSD port]
+
|<!-- Current versions    -->
|<!-- Note -->[[BSD platforms]]
+
* FreeBSD: Gramps 4.2.8
 +
* [https://www.freshports.org/science/gramps/ FreshPorts: Gramps 5.1.1]
 +
|<!-- Notes              -->[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]
 
|-
 
|-
|<!-- Platform -->
+
|<!-- Distribution        -->'''[https://www.openbsd.org/ OpenBSD]'''
|<!-- GRAMPS<br>Release -->
+
|<!-- GUI Package manager -->
|<!-- Download -->
+
|<!-- Current versions    -->
|<!-- Note -->
+
* OpenBSD: Gramps 5.1.1
 +
|<!-- Notes              -->[http://openports.se/misc/gramps available versions]
 
|-
 
|-
|<!-- Platform -->Solaris
+
|<!-- Distribution        -->
|<!-- GRAMPS<br>Release -->{{version_solaris}}<br>{{Needs backup}}
+
|<!-- GUI Package manager -->
|<!-- Download -->[[Solaris Platforms]]
+
|<!-- Current versions    -->
|<!-- Note -->Building of GRAMPS from source required
+
|<!-- Notes              -->
|-
 
|<!-- Platform -->
 
|<!-- GRAMPS<br>Release -->
 
|<!-- Download -->
 
|<!-- Note -->
 
|-
 
|<!-- Platform -->Mac OS X
 
|<!-- GRAMPS<br>Release -->{{version_Mac}}<br>{{Needs backup}}
 
|<!-- Download -->[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}} Gramps-{{version_Mac}}-1_PPC.dmg] (41 MB)<br>Or<br>[http://sourceforge.net/projects/gramps/files/Stable/{{version_Mac}} Gramps-{{version_Mac}}-1_Intel.dmg] (42 MB)
 
|<!-- Note -->A single, stand-alone bundle which uses the native quartz windowing system instead of X11 and includes all dependencies required for Mac OS X (PPC or Intel). Please read the installation instructions at [[Mac OS X:Application package]] before you use the program.<br>By John Ralls - '''Report issues on the [http://www.gramps-project.org/bugs/bug_report_page.php bug tracker]''' (2011-10-02)
 
|-
 
|<!-- Platform --> Mac OS X
 
|<!-- GRAMPS<br>Release -->{{version_MacPort}}<br>{{Needs backup}}
 
|<!-- Download -->[[Mac OS X:Build from source:MacPorts]]
 
|<!-- Note -->Requires installing X11 if using [https://secure.wikimedia.org/wikipedia/en/wiki/Mac_OS_X#Versions versions] of Mac OS X older than Leopard(10.5).<br> [http://www.macports.org/ports.php?by=name&substr=gramps Gramps:MacPorts Maintained by: devans openmaintainer]
 
 
|}
 
|}
 +
 +
 +
{{-}}
 +
 +
== 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 [[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 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 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 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, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]
 +
 +
== BSD ==
 +
 +
[[File:Bsd daemon.png|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]]].
 +
 +
<big>
 +
<u>[[Download#Linux and BSD distributions|via Distributions]]</u>
 +
&nbsp;&nbsp;&nbsp;&nbsp;
 +
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big>
 +
 +
 +
See also:
 +
* [[BSD platforms]]
 +
{{-}}
 +
 +
== Live CD ==
 +
 +
{{man warn|Note that both Live CD demonstrations use an old version of Gramps and it is not recommended for general use}}
 +
 +
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]
 +
'''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#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 ===
 +
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.}}
 +
{{-}}
 +
 +
== Notes ==
 +
 +
[<span id="1">1</span>]
 +
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]]
 +
 +
[<span id="2">2</span>]
 +
{{man menu|Note that PortableApps.com use 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 - '''[http://portableapps.com/blog/84601 Please report packaging issues to the author.]''' (2012-09-07)
 +
 +
[<span id="3">3</span>]
 +
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]
 +
 +
[<span id="4">4</span>]
 +
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.
 +
 +
[<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]]
 +
 +
== See also ==
 +
* [[Previous releases of Gramps]]
 +
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
[[Category:Developers/Installation]]
 
[[Category:Developers/Packaging]]
 

Revision as of 13:39, 16 June 2020

Gramp-Small-background-wiki-2020.jpg

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.

Gramps-notes.png
Gramps Current version: 5.2.1 Released: 2020-01-10

Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Default database is now SQlite. Lot of updates see: What's new?
Linux 220x261.png Windows 180x160.png Macos 200x200.png Bsd daemon.png

Linux

Linux 220x261.png

Before upgrading your distribution: Use your old version of Gramps to backup your Family Trees [1].

via Distributions      Latest version (5.2.1) (advanced users only)

MS Windows

Windows 180x160.png

Before downloading the All-In-One software installer bundle for Windows: Use your earlier version of Gramps to backup your Family Trees to the hardy and portable XML format1.

This installer supports Microsoft Windows in all versions Vista/7 and later.

(Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16)

After download: double-click to install Gramps.
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 mix of British and US English.

Tango-Dialog-information.png
Shortcuts

During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu.
Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.
1) GrampsAIOXX 5.2.1 ← for normal use of Gramps
2)
GrampsAIOXX 5.2.1-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. Should this fail for any reason, Create a new Family Tree and 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 this page (English only).

If necessary, there is an alternative independent Legacy MS Windows portable version2.

You may also install using the alternative independent Gramps Chocolatey NuGet Package3.


Missing other languages

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 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 spellcheck Notes in other than the British dialect of English. 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.

macOS

Macos 200x200.png

Before download: Use your old version of Gramps to backup your Family Trees [1]. Read the before installation instructions.

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

Intel 5.2.0     

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].

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.

Tango-Dialog-information.png
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 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 oxt to zip, 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, foo.aff and foo.dic. 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 fr-moderne.aff and fr-moderne.dic. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to fr.aff and fr.dic or fr_FR.aff and fr_FR.dic. 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.


An alternative way to download and install Gramps on MacOS can be done using the MacPorts[5] framework.

Linux and BSD distributions

Gramps-notes.png
These packages are built and supported by the distros.

If your distribution is not listed you may possibly find it listed on Repology
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:

Distribution GUI Package manager Current versions Notes
Debianopenlogo-32.png Debian Add/Remove Software
  • Debian 8 ("jessie")(old old stable): Gramps 4.1.1
  • Debian 9 ("stretch") (old stable): Gramps 4.2.5
  • Debian 9 ("stretch")(backports): Gramps 5.0.1
  • Debian 10 ("buster") (stable): Gramps 5.0.1
  • Debian 10 ("buster")(backports) (stable): Gramps 5.1.2
  • bullseye (testing): Gramps 5.1.2
  • sid (unstable): Gramps 5.1.2
available versions
Ubuntu 32x32.png Ubuntu Software Centre
  • Xenial (16.04 LTS): Gramps: 4.2.2
  • Xenial (16.04 LTS): Gramps: 4.2.6 (Backport)
  • Bionic Beaver (18.04 LTS): Gramps: 5.0.0
  • Eoan (19.10): Gramps: 5.0.1
  • Focal (20.04 LTS): Gramps: 5.1.2
  • Groovy Gorilla (Development: 20.10): Gramps: 5.1.2
available versions/ (Also see: Backports)
Farm-Fresh linux mint.png Linux Mint Software Manager
  • 18.x(Gramps 4.2.2~dfsg-1)
  • 19.x(Gramps 4.2.8)
Install the most current version of Gramps using the following instructions from the Linux Mint Forums

Old versions available from Linuxmint
Fedora 32x32.png Fedora Add/Remove Software (Gnome)
or
Software Management (KDE)
  • Rawhide (Gramps 5.1.2)
  • Fedora 30 (Gramps 5.1.2)
  • Fedora 31 (Gramps 5.1.2)
  • Fedora 32 (Gramps 5.1.2)
available versions
Mageia drakrpm (or rpmdrake)
  • Mageia Caulron: Gramps 5.1.2
  • Mageia 7.1: Gramps 5.0.1
Mageia App Db - gramps
OpenSUSE-distribution-icon.png openSUSE YaST
  • openSUSE Tumbleweed: Gramps 5.1.2
  • openSUSE Leap 15.2: Gramps 4.2.8
  • openSUSE Leap 15.1: Gramps 4.2.8
  • openSUSE Leap 15.0: Gramps 4.2.8
available versions
The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository
Slackware-distribution-icon.jpgSlackware available versions
Archlinux-icon-crystal-32.svgArch Linux
  • Gramps 5.1.2
available versions
Gentoo-distribution-icon.pngGentoo Linux
  • Gramps 5.1.2
available versions
NetBSD
FreeBSD available versions
OpenBSD
  • OpenBSD: Gramps 5.1.1
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.

Gnome-important.png
Warning before attempting this use your existing installation to make a Gramps XML backup

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 Debianopenlogo-32.pngDebian-based linux distributions (Which includes Ubuntu 32x32.png Ubuntu ) 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_5.2.1-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[1]:

  • Find out what version you are running, by using this:
   dpkg-query -s 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 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, Download link.png the source and follow the instructions for Linux:Build from source

BSD

Bsd daemon.png

Before upgrading your distribution: Use your old version of Gramps to backup your Family Trees [1].

via Distributions      Latest version (advanced users only)


See also:


Live CD

Gnome-important.png
Note that both Live CD demonstrations use an old version of Gramps and it is not recommended for general use

Download link.png

Linux live CD Demonstration includes Gramps 3.2.5 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..). Download the CD (727 MB). The 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 Ubuntu and Gramps from the CD anytime you like.

Online Demonstration

You can also try an online demonstration of Gramps on rollApp:

Select Launch Online then Test Drive(Opening/saving files will not be available)

Gramps-notes.png
Note

This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.


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] Note that PortableApps.com use an old version of Gramps and it is not recommended for general use An alternative independent Legacy version is GrampsPortable_5.2.0.paf.exe (29.0 MB) 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 - Please report packaging issues to the author. (2012-09-07)

[3] Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind. Gramps Chocolatey Package

[4] 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.

[5] 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: port install gramps see: Mac OS X:Build from source:MacPorts

See also