- 1 Screenshots
- 2 Sandbox
- 3 Download page scratchpad
- 4 Linux
- 5 MS Windows
- 6 Mac OS X
- 7 Linux and BSD distributions
- 8 Linux: Install latest version
- 9 BSD
- 10 Live CD
- 11 Notes
- 12 See also
- 13 Download pages
Hi , Thanks for your screenshot for the user manual, sorry that I've had to revert it as all screenshots in the user manual are taken from the example.gramps family tree. I suggest note N009 or a new note as N009 already exist in example.gramps be updated (in gramps master for the Gramps 5.1 release) to show the links etc, then it can be added to the user manual. Sam888 (talk) 22:20, 18 March 2019 (UTC)
Download page scratchpad
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.
Current version: 5.1.5 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?
The All-In-One installer includes not only the Gramps application but also the language & support libraries. It currently supports Microsoft Windows in all versions Vista/7 and later.
Please note: Gtk-3.18 and Python-3.5 dropped support for Windows XP. Gramps can still be run on Windows XP when using older versions of those support libraries eg: Gtk-3.16 & Python-3.4.4
After downloading the appropriate 32-bit or 64-bit installer, double-click to install Gramps.
Missing other languages
If you want to run Gramps in another language other than English and are using the Gramps AIO installer, then you must select it during installation process.
Otherwise, it will not be available.
1) GrampsAIOXX 5.1.5 <--- Shortcut for everyday use of Gramps
2) GrampsAIOXX 5.1.5-console
Normally, when you try to load your old Family Tree and Gramps reports that it needs to be upgraded, you can allow it and the upgraded Tree will be opened. However, if this upgrade fails for any reason, Create a new Family Tree and Import your back-up into the new Tree.
To install with the Windows AIO version, please use the download links above. For more information about individual versions, console and debug modes, release notes, et cetera; look at this page (English only).
Mac OS X
Supports Apple Mac OS X in all versions 10.5 (Leopard) and later.
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 .
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 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 framework.
Linux and BSD distributions
These packages are built and supported by the distros.
If your distribution is not listed you may possibly find it listed on Repology( https://repology.org/metapackage/gramps/versions )
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|
|Debian||Add/Remove Software||Debian 8 ("jessie")(old old stable): Gramps 4.1.1
Debian 8 ("jessie")(backports): Gramps 4.2.5
Debian 8 ("jessie")(backports-sloppy): Gramps 4.2.8
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.1
bullseye (testing): Gramps 5.1.1
sid (unstable): Gramps 5.1.1
|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
Disco (19.04): Gramps: 5.0.1
Eoan (19.10): Gramps: 5.0.1
Focal (Development: 20.04 LTS): Gramps: 5.1.1
|available versions/ (Also see: Backports)|
|Linux Mint||Software Manager||18.x(Gramps 4.2.2~dfsg-1)
|Install the most current version of Gramps using the following instructions from the Linux Mint Forums|
Old versions available from Linuxmint
|Fedora||Add/Remove Software (Gnome)
Software Management (KDE)
|Rawhide (Gramps 5.1.1)
Fedora 29 (Gramps 5.0.2)
Fedora 30 (Gramps 5.1.1)
Fedora 31 (Gramps 5.1.1)
Fedora 32 (Gramps 5.1.1)
|Mageia||drakrpm (or rpmdrake)||Mageia Caulron: Gramps 5.0.1
Mageia 6.1: Gramps 5.0.1
|Mageia App Db - gramps|
|openSUSE||YaST||openSUSE Tumbleweed: Gramps 5.1.1
openSUSE Leap 15.1: Gramps 4.2.8
openSUSE Leap 15.0: Gramps 4.2.8
The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository
|Slackware||14.2: Gramps 4.2.6
14.1: Gramps 4.0.3
slackbuilds.org: Gramps 5.0.0
|NetBSD||NetBSD: Gramps 3.4.4||available versions|
|FreeBSD||FreeBSD: Gramps 4.2.8||available versions or FreshPorts -- science/gramps|
|TrueOS||PC-BSD: Gramps 3.4.8||2016/09/01 - PC-BSD is now TrueOS|
|OpenBSD||OpenBSD: Gramps 4.2.8||available versions|
|Arch Linux||Gramps 5.1.2||available versions|
|Gentoo Linux||Gramps 5.1.2||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.
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.
For Debian-based linux distributions (Which includes 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 python3-gramps_5.1.5-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:
- 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, the source and follow the instructions for Linux:Build from source
Note that both Live CD demonstrations use an old version of Gramps and it is not recommended for general use
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.
You can also try an online demonstration of Gramps on rollApp:
Select Launch Online then Test Drive(Opening/saving files will not be available)
This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.
 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
 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.1.5.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)
 Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind. Gramps Chocolatey Package
 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.
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
Why does Gramps have two download pages? There is more than one CMS (Content Management Systems) on the website and they weren't designed to play well with others. The legacy WordPress powered site was for a 'pretty' site that was intended make Gramps more appealing to non-technical prospective users. And then the MediWiki powered wiki was layered in because the Downloadable manual had been lagging behind so badly. (Of course, the Developer resources are managed by yet other systems.)
- (1) https://gramps-project.org/blog/download/ - this is just a friendly bridging page from the WordPress site into the MediaWiki page.
- (2) https://www.gramps-project.org/wiki/index.php?title=Download - this is the MediaWiki managed page
The boxed Gramps download logo also leads to (2) from https://gramps-project.org/blog/
Would it make more sense to redirect (1) to (2)? (Page 2 with all the OS specific info is kind of intimidating. That's why Sam & I are playing with the MediaWiki content in this sandbox. The multiple OS download/update process is naturally complex. The convoluted writing adds unnecessary confusion. The WordPress Download page (#1) is simply a bit of PR fluff.)
Also the link https://gramps-project.org/download/ redirects to (2).
|Special copyright notice: All edits to this page need to be under two different copyright licenses:
These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links.
This template describes the special copyright provision for material which is part of the Gramps wiki manual pages.
As the manual must in the end be distributed in a GPL released package, all edits must be dual licensed, once for the copyright of the wiki, and once for the copyright of the distributed package.