Changes

==Easy download and install of GRAMPS 2.2.6=={{languages}}Before downloading'''Research, check if the version of GRAMPS in organize and share your distribution is not current:* Debian, (K,X,Edu)Ubuntu, Mepis, Suse: <code>apt-get install gramps</code>* Fedora: <code>yum install gramps</code>family tree with Gramps.'''

==Live CD==If you are interested in GRAMPS, but afraid Gramps is a free software project and community. We strive to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), try out our live cd: [[Linux Genealogy CD]]produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists. It does not install on the hard disk and contains is a collection of open sourcecommunity project, freecreated, genealogy programs. You can install [http://ubuntu.com Ubuntu 6.06 LTS] developed and GRAMPS from the CD anytime you likegoverned by genealogists.

==Upgrading to latest {{man note|{{Man menu|'''Current version==If your : {{version }} Released: 2018-02-09'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as Python 2 support dropped. Uses GTK+ 3 GUI. Lot of GRAMPS is not current, some users offer up to date packages for some distributionsupdates see:.''[[Gramps_4.2_Wiki_Manual_-_What's_new%3F|What's new?]]}}

# Ubuntu{{man warn|Final ''Legacy version: On sourceforge, [http3.4.9 Released://sourceforge2015-04-30|This is the final maintenance release designed for those of you still running gramps with gtk2. The database is common between version 4.0.net/project/showfilesx (not version 4.php?group_id=25770 download] gramps_zzz1.deb x and gramps-help_zzzversion 4.2.deb, x) and install with your package manager3.# SuSE: Richard Bos has been providing the GRAMPS releases for SuSE's apt repository4. They x branch, most differences are always last release in [http://softwareinto interface.opensuse.org/download/home:/rbos/ his repository]. See also ''[httphttps://wwwgramps-project.suseforums.netorg/index.php?s=22f80a050a1e3cffffd590db0813dea9&showtopic=28727&pid=152093&st=0&#entry152093. this forum entry].# Mandriva: Packages for Mandriva are available for use with urpmi from [http:2015/04/seerofsouls.comgramps-3-4-9-released/ SeerOfSouls.com].# Fedora: The alternative to installing from source (described below) is to build a package from an rpm spec file, or install a binary from fedora testing.# Debian: the latest version is installed directly into unstable and can be upgraded from your package manager. Testing is updated 10 days later (except near a new stable release).}}

''Note: Some == Linux distributions may have a slightly different way to download and install packages for GRAMPS. Please read the installation instructions specific to your distribution before downloading.''==

In all other cases, you must [http[File://sourceforgeLinux_220x261.net/project/showfiles.php?group_id=25770 downloadpng|128px|left]] the source package zzz.tar.gz, and install GRAMPS manually. See below for details.

==Windows, BSD, MacOs, Solaris==For Windows, there is an experimental installer. For more recent versions Before upgrading your distribution: Use your '''old version of GRAMPS in Windows, you need Gramps''' to wait untill a new installer is made available[[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].

==Gnome and KDEMS Windows ==You can use both, but GRAMPS fits in better with GNOME. For KDE there are some minor issues due to some (GTK) issues outside of GRAMPS. Check the wiki KDE page to know what these problems might be.

=Additional software GRAMPS can benefit from=GRAMPS does not rely on the following programs, however, having them will increase your productivity[[File:windows_180x160.png|128px|left]]

* '''Gnome-print'''Before download: It adds the ability to directly print, to preview, and to generate fully internationalized PS and PDF output. At this time, one needs to install gnome-python-desktop to obtain this package (it might be known under different names, eg on debian python-gnome2-desktop).* Use your '''Spell checking''': Installing python-gnome2-extras provides the gtkspell module, which adds spell checking in the notes* '''Graphviz''', '''Inkscapeold version of Gramps''': Gramps can make nice Genealogical trees (relationship graphs). These are generated by the Graphviz package, which defines a code (dot), as well as programs to produce graphs (dotty, to be called from command line)[[How_to_make_a_backup#Gramps_version_3. This gives you as researcher most power over how 3_and_later|backup]] your tree will look, but has a learning curve. An alternative is to make a graphical report, converting the tree to an svg file, which you then can open/edit/refine in eg Inkscape.* '''ttf-freefont''': Useful as a font that supports a large subset of the unicode and is a true type. This works well with both gnomeprint and graphviz outputFamily Trees [[#1|[1]]].

* ''After download: double-click to install Gramps. {{man menu|Standard setup is 'Yelp'English only'': Gnome help browser. This allows to call so if using a different language please ensure that you select extra dictionary and read language files when asked during the GRAMPS documentation on your computerinstallation process.}}

GRAMPS 2Use the Windows AIO version, please use the download links above.0 requires python 2.3 For more information about individual versions, console and the gnome-python and pygtk2 packagesdebug modes, release notes, etc. The gnome, look at [[GrampsAIO-python module should be 2.6.0 or greater. The pygtk package should be version 2.5.0 or greater4|this page]] (English only).

# The lastest stable version of GRAMPS can be downloaded from You may also install using the GRAMPS SourceForge page. As of writing this is gramps-2.2.6.tar.gz. Extract this file in a directory: tar xzvf gramps-zzz.tar.gz, and go into this directory: cd gramps.alternative independent Gramps Chocolatey Package [[# If you are interested in testing out the latest development version of GRAMPS, it can be obtained from SVN, see the wiki entry. The SVN version of GRAMPS is potentially very dangerous as it has not been extensively tested. It may be prone to crashing and cause extensive data loss. Please use with caution4|[4]]].

Please, now is the time to read the INSTALL and README files accompanying the code. They come with the most recent information[[File:macos_200x200.png|128px|left]]

GRAMPS provides a script that can be used to prepare the code for buildingSupports Mac OS X in all versions 10. This script automatically calls the standard configure script5 (Leopard) and later.

<big><u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</autogen.shu></big> &nbsp;&nbsp;&nbsp;&nbsp;

This script will report any missing dependenciesAfter download: Double-click the . Install these dmg file to mount the disk (see also INSTALL filenote: your browser may do this for you automatically). Building from source code typically requires that Next drag the development versions of the required libraries be installed. You might consider setting a prefix path with autogen.sh, see the INSTALL file for instructionsGramps application to your application folder and double-click to launch it [[#2|[2]]]. Standard install is in

Once a successful run of autogen.sh has been completedNormally, when you try to load your old Family Tree you can run 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 typical make procedureback-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 [http://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, makemake installit 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.}}

Installing on == BSD is as straithforward as on linux, apart from some minor issues like tools having different names. See the dedicated wiki page.==

Some users have successfully installed GRAMPS on Mac OS XBefore upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3. See the dedicated wiki page. Please, add to the wiki if you successfully installed GRAMPS on OS X3_and_later|backup]] your Family Trees [[#1|[1]]].

[[File:Download_link.png|150px|left|link==Installing 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 source code in Solaris=the CD anytime you like.{{-}}[[File:Download_link.png|150px|left|link=http://cdimage.ubuntu.com/edubuntu/releases/14.04/release/]]'''Edubuntu 14.04.3''' includes Gramps 4.0.3-1 (For information about Edubuntu [http://www.edubuntu.org/news/14.04.2-release visit]){{-}}

Previous versions === Online Demonstration ===You can also try an online demonstration of GRAMPS have run Gramps on SolarisrollApp:* https://www.rollapp.com/app/grampsSelect '''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.}}{{-}} == <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].|Please report any problems with them to the package maintainer. No }}Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent cases 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 know ways to install Gramps on some of the more popular distributions: {| {{prettytable}}!style="width: 85pt;" | Distribution!GUI Package manager!Current versions!Notes|-|<!-- Distribution -->[[File:Debianopenlogo-32.png]]''' [[Debian]] '''|<!-- GUI Package manager -->Add/Remove Software|<!-- Current versions -->Debian 7 ("wheezy") (old old stable): Gramps 3.4.0<br>Debian 8 ("jessie")(old stable): Gramps 4.1.1<br>Debian 8 ("jessie")(backports): Gramps 4.2.5<br>Debian 8 ("jessie")(backports-sloppy): Gramps 4.2.6<br>Debian 9 ("stretch") (stable): Gramps 4.2.5<br>Debian 9 ("stretch")(backports): Gramps 4.2.6<br>buster (testing): Gramps 4.2.8<br>[http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 4.2.8|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]|-|<!-- Distribution -->[[File:Ubuntu_32x32.png]]''' Ubuntu '''|<!-- GUI Package manager -->Software Centre|<!-- Current versions -->Trusty (14.04 LTS): Gramps: 4.0.3<br>Trusty (14.04 LTS): Gramps: 4.2.3 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport])<br>Xenial (16.04 LTS): Gramps: 4.2.2<br>Xenial (16.04 LTS): Gramps: 4.2.6 ([https://launchpad.net/~rosco2/+archive/ubuntu/backports Backport])<br>Artful (17.10): Gramps: 4.2.6<br>Bionic Beaver (Development: 18.04): Gramps: 4.2.8|<!-- 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]]''' Linux Mint'''|<!-- GUI Package manager -->Software Manager|<!-- Current versions -->17.x(Gramps 4.0.3+dfsg-2)<br>18.x(Gramps 4.2.2~dfsg-1)|<!-- 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]|-|<!-- Distribution -->[[File:Fedora_32x32.png]]''' Fedora ''' |<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)|<!-- Current versions -->Rawhide (Gramps 4.2.8)<br>Fedora 27 (Gramps 4.2.8)<br>Fedora 26 (Gramps 4.2.8)|<!-- Notes -->[https://apps.fedoraproject.org/packages/gramps available versions] / Note:The Fedora and Red Hat Projects were merged on September 22, 2003.|-|<!-- 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 Caulron: Gramps 4.2.5<br>Mageia 5.0: Gramps 4.1.3|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]|-|<!-- Distribution -->''' openSUSE '''|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]|<!-- Current versions -->openSUSE Tumbleweed: Gramps 4.2.6<br>openSUSE Leap 42.3: Gramps 4.2.4<br>openSUSE Leap 42.2: Gramps 4.2.4|<!-- Notes -->[http://software.opensuse.org/package/gramps available versions]<br>See note [https://sourceforge.net/p/gramps/mailman/message/34367773/] : Gramps 4.2.x can be installed on Opensuse 13.2 ( if you add the 'openSUSE BuildService - GNOME:Apps' )|-|<!-- Distribution -->'''Slackware'''|<!-- GUI Package manager -->|<!-- Current versions -->14.2: Gramps 3.4.3<br>14.1: Gramps 4.0.3|<!-- Notes -->[http://pkgs.org/search/?keyword=gramps available versions]<br>[https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]: Gramps 4.2.6|-|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''|<!-- GUI Package manager -->|<!-- Current versions -->NetBSD: Gramps 3.4.4|<!-- Notes -->[http://pkgsrc.se/databases/gramps3 available versions]|-|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''|<!-- GUI Package manager -->|<!-- Current versions -->FreeBSD: Gramps 4.2.4|<!-- Notes -->[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]|-|<!-- Distribution -->'''TrueOS'''|<!-- GUI Package manager -->|<!-- Current versions -->PC-BSD: Gramps 3.4.8|<!-- Notes -->[http://web.pcbsd.org/pc-bsd-is-now-trueos/ 2016/09/01 - PC-BSD is now TrueOS]|-|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''|<!-- GUI Package manager -->|<!-- Current versions -->OpenBSD: Gramps 4.2.6|<!-- Notes -->[http://openports.se/misc/gramps available versions]|-|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]]'''[https://www.archlinux.org/ Arch Linux]'''|<!-- GUI Package manager -->|<!-- Current versions --> Gramps 4.2.6|<!-- Notes -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]|-|<!-- Distribution -->'''Gentoo Linux'''|<!-- GUI Package manager -->|<!-- Current versions --> Gramps 4.2.5|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]|-|<!-- Distribution -->|<!-- GUI Package manager -->|<!-- Current versions -->|<!-- Notes -->|} {{-}} == 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 us howeverinstall 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. Should  If you already have successfully Gramps installed GRAMPS , 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 [[Image:Debianopenlogo-32.png]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[Image:Ubuntu_32x32.png]]''' Ubuntu ''') [{{github_url}}/releases/v{{version}} Download the .deb file]. Double-click on solaristhe downloaded .deb file or (for some distributions, please update e.g. Mint Debian) run the following command from the directory where the wikifile was saved (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:  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 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, [[Image:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]] == 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>]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="3">3</span>]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="4">4</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] == See also ==* [[Previous releases of Gramps]] [[Category:Documentation]]