Changes

The latest released version is '''GRAMPSGramps''' {{version}}. This version may not yet be available for installation on your platform. Please visit the [[Download]] page for more information.

== Upgrading GRAMPS Gramps ==

{{man warn|1=Warning|2=If you are '''Upgrading GRAMPSGramps''' from a previous version you should first:follow these intructions.}}

# Use your If you are '''old version of GRAMPSUpgrading Gramps''' to '''export''' your Family Trees to GRAMPS XML ('''uncheck privacy options''' on Exporter Assistant)# '''Uninstall''' your old version of GRAMPS# '''Install''' the new from a previous version of GRAMPS by following the instructions below# '''Create''' a new Family Tree# '''Import''' your old GRAMPS XML datayou should first:

# Use your '''old version of Gramps''' to '''backup''' or '''export''' your Family Trees to GRAMPS XML (you 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).# '''Uninstall''' your old version of Gramps# '''Install''' the new version of Gramps by following the instructions below# '''Open''' your existing Family tree. :# Normally, opening just works, and will upgrade your data if needed. If successfull, save the backup you took in a safe place.:# In case opening or upgrading your existing Family Tree failed, do the following:::#'''Create''' a new Family Tree::# '''Import''' your old Gramps XML data in this Family Tree ==Additional software GRAMPS Gramps can benefit from==GRAMPS Gramps does not rely on the following programs, however, having them will increase your productivity:

* '''[http://www.freedesktop.org/wiki/Software/desktop-file-utilsdesktop-file-utils]''': see list of programs to open a media file on right click on an image

===Automatic download and install of GRAMPSGramps===Before downloading GRAMPS Gramps from this site, see if your operating system's repository makes the current '''Gramps''' {{version}} version available. To see what the current version is, You could also visit [http://sourceforge.net/projects/gramps/files/Stable/ GRAMPS Gramps stable on Sourceforge] and look at the version number of the top package.

===Manual download and install of GRAMPSGramps===If your Linux operating systems repository does not have the current version, then you may be able to download it from this site. Some helpful users of GRAMPS Gramps have made packages for various systems. If you are lucky you'll find your system below. If it's missing you can contact the developers email list for advice.

Repository packages for '''Ubuntu''' and derivatives (Kubuntu, Mephis, LinuxMint, ...): are available on [http://sourceforge.net/projects/gramps/files/Stable/ GRAMPS Gramps download page]. {{cleanup}}

! GRAMPSGramps<br>Release

|<!-- GRAMPSGramps<br>Release -->3.3.02|<!-- Download -->[http://sourceforge.net/projects/gramps/files/Stable/3.3.02/gramps_3.3.02-1_Ubuntu.deb/download gramps_3.3.02-1.deb]

|<!-- GRAMPSGramps<br>Release -->3.3.02|<!-- Download -->[http://sourceforge.net/projects/gramps/files/Stable/3.3.02/gramps_3.3.02-1_Ubuntu.deb/download gramps_3.3.02-1.deb]

|<!-- GRAMPSGramps<br>Release -->3.2.26|<!-- Download -->[http://sourceforge.net/projects/gramps/files/Stable/3.2.26/gramps_3.2.26-1_ubuntu09.deb/download gramps_3.2.26-1_Ubuntu09.deb]

|<!-- GRAMPSGramps<br>Release -->3.2.26|<!-- Download -->[http://sourceforge.net/projects/gramps/files/Stable/3.2.26/gramps_3.2.26-1_ubuntu09.deb/download gramps_3.2.26-1_Ubuntu09.deb]

|<!-- GRAMPSGramps<br>Release -->3.1.3

|<!-- GRAMPSGramps<br>Release -->3.1.3

|<!-- GRAMPSGramps<br>Release -->3.0.3

|<!-- GRAMPSGramps<br>Release -->2.2.10

|<!-- GRAMPSGramps<br>Release -->2.2.8

'''Debian''': the latest version should be in the ''unstable'' repository ([http://packages.debian.org/sid/gramps Sid Gramps]) and can be upgraded from your package manager. The ''testing'' repository is updated 10 days later (except near a new stable release), see [http://packages.debian.org/testing/gramps Testing Gramps]. Released versions of Debian (''etch'' and ''lenny'') contain older versions of GRAMPSGramps, see the list of [http://packages.debian.org/search?keywords=gramps versions of GRAMPS Gramps in Debian].

'''SuSE''': Richard Bos has been providing the GRAMPS Gramps releases for OpenSUSE. The repository for OpenSUSE 11.1 is available from [http://download.opensuse.org/repositories/Education/openSUSE_11.1/] or [http://download.opensuse.org/repositories/home:/cornelisbb/]. Note that at the time of writing this repository is not the same as that in the repository list as "Education" and must be added as a URL. The repository for 11.0 is [http://download.opensuse.org/repositories/Education/openSUSE_11.0/] and 10.3 is [http://download.opensuse.org/repositories/Education/openSUSE_10.3/]. For earlier versions of OpenSUSE (10.2) see the forum entry about [http://www.suseforums.net/index.php?s=22f80a050a1e3cffffd590db0813dea9&showtopic=28727&pid=152093&st=0&#entry152093 satisfying GRAMPS Gramps dependencies for SuSE with the ''rbos'' and SMART]. Also, there is [[OpenSUSE_RPM|an other alternative using openSUSE BuildService]].

'''Mandriva''': Newer versions of GRAMPS Gramps are sometimes backported. To install backports you must enable the ''backports'' repository (make sure you understand the instructions on the [http://wiki.mandriva.com/en/Docs/Basic_tasks/Installing_and_removing_software#Advanced_use:_Backports_and_candidate_updates Mandriva wiki]). If the latest version is not in the ''backports'' repository you cab try the ''contrib'' repository.

'''Fedora''': For Fedora Core look on the [http://sourceforge.net/projectprojects/showfiles.php?group_id=25770 GRAMPS gramps/files/ Gramps download page] for a package containing ''fc'' with your number and ending with ''.rpm''. The alternative to installing from source is to [[fedora rpm|build a package]] from an rpm spec file, or install a binary from fedora testing.

====Slackware===='''Slackware 13.0''': Gramps 3.2.3 5 is available via [http://www.linuxpackages.net/pkg_details.php?id=13253 13368 LinuxPackages].

Different GNU/Linux distributions have other preferred ways to download and install packages for GRAMPSGramps. Please read the installation instructions specific to your distribution before downloading.

In all other cases, you must [http://sourceforge.net/projectprojects/gramps/files/showfiles.php?group_id=25770 download] the stable source package (the file ending with '.tar.gz') and install GRAMPS manually. See the section about installing from source for details.

You can use both, but GRAMPS Gramps fits in better with GNOME.

For KDE there are some minor issues due to some (GTK) issues outside of GRAMPSGramps. Check the [[KDE page]] to know what these problems might be.

For GNOME, there are some issues due to some (ATK/GAIL) issues outside of GRAMPSGramps. Check the [[Known_issues|Known issues]] to know what these problems might be.

===GRAMPS Gramps on handhelds===GRAMPS Gramps can run fine on some small-factor devices. Users have been successful in using GRAMPS Gramps on: * [[Gramps on the Eee|Asus Eee PC]]* [http://gramps-project.org/2011/01/gramps-mobile-interface-part-i/ Gramps Mobile Interface – part I] & [http://gramps-project.org/2011/01/gramps-mobile-interface-%E2%80%93-part-ii/ part II]

If you are interested in GRAMPSGramps, 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 [http://www.ubuntulinux.org/ Ubuntu 10.10] and GRAMPS Gramps from the CD anytime you like.

See Be aware there is a least 3 different ways you can install/use Gramps under windows. The method you choose will be dependent on ''your'' requirements and how much extra work you wish to put into setting up your environment.In order of difficulty:* Gramps All-in-one installer (AIO) - While still under development the AIO installer has the lowest barrier of entry, see [[downloadAll In One Gramps Software Bundle for Windows]]for more information.* Gramps Portable - Allows you to Run Gramps from a portable drive and can be installed to the local hard drive see the [http://portableapps.com/apps/education/gramps_portable PortableApps.com Gramps Portable] page for the ''Windows more information.* Gramps installer (minimal) - Stable installer'', ensure however it requires you have downloaded and installed the to install all of Gramps dependencies prior to installing Gramps. see [[Windows_installer#Installation |Installing Windows dependencies first.]]*Additional information for Windows users is on page [[GRAMPS and Windows]].

Fortunately for users More information of Microsoft Windows, some users have made a each of these installation methods can be seen on the [[Windows installerdownload]]. So far there have not been any reports of serious differences between the official builds of GRAMPS and the Windows Installer, so the future looks promising, but please, use this at your own riskpage.

====Ready-built binary applicationBuilding from source====

A new port Fortunately for users of Microsoft Windows, some users have made a [[Windows installer]]. So far there have not been any reports of serious differences between the official builds of Gramps to Mac is available (September 2010). This is relatively untested and it is wise to back up data carefully before running it. It's available as a ready-built binary application for both Intel and PPC Macsthe Windows Installer, so the future looks promising, but please, use this at your own risk.

===Mac for Gramps is described at [[Using Gramps on Apple Mac]].OS X===

====Building A ready-to-run application for Max OS X has been available since September 2009 for both Intel and PPC Apple computers. It is wise to back-up data carefully before using the application (especially if you are upgrading from source====a previous version of Gramps).

The pre-built binary version is also available as a build environment and can be built from scratch by any Mac with Please read the Apple Xcode toolset. Macports and Fink versions of Gramps have been used. An overview of installing GRAMPS from source on the Mac is given under installation instructions at [[Mac_OS_X|Installing from source code on Mac OS X:Application package]]. The latest version of MacPorts Gramps is '''{{version_MacPort}}'''.The latest official stable fink version is '''1.0.10''' for Mac OS X 10.4. The latest official unstable fink version is '''3.0.4''' for Mac OS X 10.5before you use the program.

* For FreeBSD use the [http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps /usr/ports/science/gramps] port. In case of error on FreeBSD 8.0, read [http://www.gramps-project.org/bugs/view.php?id=3228 ticket #{{bug|3228]}}.

* GRAMPS Gramps has been successfully installed from source on both Solaris 10 (SPARC) and OpenSolaris X86 (2008.05). Please see the [[Solaris Platforms|Solaris page]] for step-by-step details.

==Installing GRAMPS Gramps from source code==

GRAMPS 3.2.x Gramps {{version}} requires python 2.5 6 or greater, pygtk2 pygtk 2.12 16 or greater, glade bindings and librsvg2

|Required (needs 2.12 16 or greater)

| Required for http://gramps-connect.org[[Gramps-Connect: Introduction|Gramps-Connect]]

* The latest stable version of GRAMPS Gramps can be downloaded from the [http://sourceforge.net/projects/gramps GRAMPS /files/ Gramps SourceForge pagefile area]. Eg: gramps-{{version}}.tar.gz. Extract this file into a directory:

* If you are interested in testing out the very latest development versions of GRAMPSGramps, they can be obtained from SVN, see [[Brief introduction to SVN#Unstable_development:_.22trunk.22|Brief introduction to SVN]]. The SVN versions of GRAMPS Gramps are potentially very dangerous as they have not been extensively tested - especially the "trunk" version which contains features that may still be partly implemented. Be aware that they may be prone to crashing and cause extensive data loss. Please use with extreme caution - and only ever on a copy of your data!

svn co https://grampssvn.svncode.sourceforgesf.net/svnrootp/gramps grampsor svn co https://gramps.svn.sourceforge.net/svnroot/grampscode/tags/gramps-3.4.2.5 / gramps

for the most recent development version, see [[Running a development version of Getting started with GrampsTrunk]].

You can get tarball for last sourcesIf you have an older version of the Gramps source code installed you need to make a decision what you want to do with it before installing a later version. If you wish to keep the old version, make sure that you read the instructions in the INSTALL file regarding the use of the --prefix option to specify where the new version gets installed.

* [http://gramps.svn.sourceforge.net/viewvc/gramps/branches/maintenance/gramps32/?view=tar 3.2.x] * [http://gramps.svn.sourceforge.net/viewvc/gramps/branches/maintenance/gramps33/?view=tar 3.3.x] * [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/?view=tar Trunk] ====Upgrading GRAMPS==== If you have an older version of the GRAMPS source code installed you need to make a decision what you want to do with it before installing a later version. If you wish to keep the old version, make sure that you read the instructions in the INSTALL file regarding the use of the --prefix option to specify where the new version gets installed. Should you just want to do a straightforward replacement instead, make sure that you remove the older version before you install the new version. '''Do not install over the top of the old version. ''' As new versions of Gramps are developed, some functionality is occasionally rewritten in different ways. If you install over the top of an existing installation you run the risk that the old code left behind from the old version may be used instead of the new, sometimes with unintended consequences. If you installed from source, the best way of removing the old version is to run<code>

'''Note that you should use your old GRAMPS Gramps version to export backup copies to GRAMPS XML before removing the old version.'''

GRAMPS Gramps provides a script that can be used to prepare the code for building. This script automatically calls the standard configure script:<code>