If you can't access the current version from your operating system's repositories you'll need to get it from this site. Some helpful users of GRAMPS have made packages for various systems. If you're lucky you'll find your system below. If it's missing you can contact the developers email list for advice.

If you can't access the current version from your operating system's repositories you'll need to get it from this site. Some helpful users of GRAMPS have made packages for various systems. If you're lucky you'll find your system below. If it's missing you can contact the developers email list for advice.

** Dapper, Edgy and before: 2.2.10 is not available yet, for now download [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps_2.2.8-1dapper1_all.deb] and [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps-help_2.2.8-1dapper1_all.deb] , and install with your package manager.

** Dapper, Edgy and before: 2.2.10 is not available yet, for now download [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps_2.2.8-1dapper1_all.deb] and [http://sourceforge.net/project/showfiles.php?group_id=25770 gramps-help_2.2.8-1dapper1_all.deb] , and install with your package manager.

Line 38:

Line 44:

==Windows, BSD, MacOs, Solaris==

==Windows, BSD, MacOs, Solaris==

−

For Windows, there is an experimental [[Windows installer]]. If this installer does not offer the most recent versions of GRAMPS in Windows, you need to wait until a new installer is made available.

+

For Windows, there is an experimental [[Windows installer]]. If this installer does not offer the most recent versions of Gramps in Windows, you need to wait until a new installer is made available.

−

For Windows user: See also some additional information on page [[GRAMPS_and_Windows]].

+

For Windows user: See also some additional information on page [[Gramps_and_Windows]].

For MacOSX, both the [http://finkproject.org Fink project] and [http://macports.org MacPorts] have Gramps as a installable package. Fink currently has '''very''' old versions available it in the [http://pdb.finkproject.org/pdb/package.php/gramps# package database]. Detailed instructions on using both these systems to install recent versions of gramps are given under [[Mac_OS_X|Installing from source code on Mac OS X]]

For MacOSX, both the [http://finkproject.org Fink project] and [http://macports.org MacPorts] have Gramps as a installable package. Fink currently has '''very''' old versions available it in the [http://pdb.finkproject.org/pdb/package.php/gramps# package database]. Detailed instructions on using both these systems to install recent versions of gramps are given under [[Mac_OS_X|Installing from source code on Mac OS X]]

Line 45:

Line 51:

For BSD and Solaris there are experimental install instructions below. For FreeBSD use the ''/usr/ports/science/gramps'' port.

For BSD and Solaris there are experimental install instructions below. For FreeBSD use the ''/usr/ports/science/gramps'' port.

−

==Gnome and KDE==

+

==Gnome ja KDE==

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 [[KDE page]] to know what these problems might be.

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 [[KDE page]] to know what these problems might be.

Line 53:

Line 59:

* '''Gnome-print''': 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).

* '''Gnome-print''': 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).

* '''Graphviz''', '''Inkscape''': 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). This gives you as researcher most power over how your tree will look, but has a learning curve. Also, [https://gna.org/projects/kgraphviewer kgraphviewer] works fine with dot generated by GRAMPS. 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.

+

* '''Graphviz''', '''Inkscape''': 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). This gives you as researcher most power over how 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 output.

* '''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 output.

+

* '''[http://tilloy.net/dev/pyexiv2/overview.html pyexiv2]''' is a module that allows Gramps to read and write metadata embedded in image files. It is used in the Metadata Viewer and Image Metadata gramplets.

Other packages might also be useful:

Other packages might also be useful:

−

* '''Yelp''': Gnome help browser. This allows to call and read the GRAMPS documentation on your computer.

* '''desktop-file-utils''': see list of programs to open a media file on right click on an image

* '''desktop-file-utils''': see list of programs to open a media file on right click on an image

−

==Installing from source==

+

==Lähdekoogista asentaminen==

===General Requirements===

===General Requirements===

−

GRAMPS 2.0 requires python 2.3 and the gnome-python and pygtk2 packages. The gnome-python module should be 2.6.0 or greater. The pygtk package should be version 2.5.0 or greater.

+

GRAMPS {{version}} requires python 2.6 and pygtk2 packages. The pygtk package should be version 2.16 or greater.

Also librsvg2-common is needed. This is a common error at the moment in some packages. Without this library, the icons are not shown.

Also librsvg2-common is needed. This is a common error at the moment in some packages. Without this library, the icons are not shown.

Line 78:

Line 84:

|python

|python

|python

|python

−

|Required (needs version 2.5 or later)

+

|Required (needs version 2.6 or later)

|-

|-

|pygtk2

|pygtk2

|pygtk2

|pygtk2

−

|Required (needs 2.5.0 or greater)

+

|Required (needs 2.16 or greater)

|-

|-

−

|gnome-python

+

|xdg-utils

−

|gnome-python

+

|xdg-utils

−

|Required (needs 2.6.0 or greater)

+

|Required (Gramps-3.1.x or later)

|-

|-

|rcs

|rcs

Line 98:

Line 104:

|

|

|librsvg2-devel

|librsvg2-devel

−

|Required for building

−

|-

−

|

−

|gnome-common

|Required for building

|Required for building

|-

|-

|

|

|intltool

|intltool

−

|Required for building

−

|-

−

|

−

|gnome-doc-utils

|Required for building

|Required for building

|-

|-

Line 120:

Line 118:

===Obtaining the source===

===Obtaining the source===

−

* The lastest stable version of GRAMPS can be downloaded from the [http://sourceforge.net/projects/gramps GRAMPS SourceForge page]. As of this writing, this is gramps-3.0.1.tar.gz. Extract this file into a directory: <code>

+

* The lastest stable version of GRAMPS can be downloaded from the [http://sourceforge.net/projects/gramps GRAMPS SourceForge page]. As of this writing, this is gramps-{{version}}.tar.gz. Extract this file into a directory: <code>

tar xzvf gramps-zzz.tar.gz

tar xzvf gramps-zzz.tar.gz

</code> and then go into this directory:<code>

</code> and then go into this directory:<code>

Line 155:

Line 153:

Installing on BSD is as straithforward as on linux, apart from some minor issues like tools having different names. See the [[BSD page]] for details.

Installing on BSD is as straithforward as on linux, apart from some minor issues like tools having different names. See the [[BSD page]] for details.

There are several different ways of building Gramps from source on Mac OS X. An overview of building from source is given at [[Mac OS X:Build from source]].

+

+

[[Mac OS X:Build from source:MacPorts|Macports]] and [[Mac OS X:Build from source:fink|fink]] versions of Gramps have been used.

+

+

The latest version of MacPorts Gramps is '''{{version_MacPort}}'''.

+

The latest official unstable fink version is '''3.0.4''' for Mac OS X 10.5 on both PPC and Intel.

+

There is currently no official stable fink version of Gramps. (As at February 2012)

+

+

Instructions for building the pre-built binary version (Mac OX X Application package) are given at [[Mac OS X:Build from source:Application package]]. Some discussion about earlier attempts is at [[Mac OS X:Build from source:gtk-osx]] with bugs reported at [[Mac OS X:Build from source:gtk-osx:bugs]]

−

Some users have successfully installed GRAMPS on Mac OS X. See the [[Mac OS X]] page for details. Please, add to the wiki if you successfully installed GRAMPS on OS X.

+

An older build approach is given at [[Mac OS X:Build from source:Native OS X]].

===Installing from source code on Windows===

===Installing from source code on Windows===

−

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 and the Windows Installer, so the future looks promising. But please, use this at your own risk. The developers of GRAMPS provide the space for this install page, but are not responsible for it.

+

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 and the Windows Installer, so the future looks promising. But please, use this at your own risk. The developers of GRAMPS provide the space for this install page, but are not responsible for it.

If the dependencies are in place, the development version can be tested by getting the source (see above), renaming the file const.py.in to const.py, and executing "python gramps.py" from within the src directory. Of course, this is a development version on an unsupported platform, so warnings apply even more to this case than when using the installer. (I have not managed to get a localized build working this way.)

If the dependencies are in place, the development version can be tested by getting the source (see above), renaming the file const.py.in to const.py, and executing "python gramps.py" from within the src directory. Of course, this is a development version on an unsupported platform, so warnings apply even more to this case than when using the installer. (I have not managed to get a localized build working this way.)

GRAMPSin manuaalinen lataus ja asennus

If you can't access the current version from your operating system's repositories you'll need to get it from this site. Some helpful users of GRAMPS have made packages for various systems. If you're lucky you'll find your system below. If it's missing you can contact the developers email list for advice.

This page needs a cleanup. Please help keep Gramps Wiki a useful resource by refactoring this page. Consider also updating the screenshots.

Mandriva: Newer versions of GRAMPS are sometimes backported. To install backports you must enable the backports repository (make sure you understand the instructions on the Mandriva wiki). If the latest version is not in the backports repository you cab try the contrib repository.

Fedora: For Fedora Core 6 look on the GRAMPS download page for a package containing fc6 and ending with .rpm. For Fedora 7, fc7 and so on. The alternative to installing from source is to build a package from an rpm spec file, or install a binary from fedora testing.

Debian: the latest version should be in the unstable repository (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 Lenny Gramps.

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

In all other cases, you must download the source package (the file ending with '.tar.gz') and install GRAMPS manually. See the section about installing from source for details.

Windows, BSD, MacOs, Solaris

For Windows, there is an experimental Windows installer. If this installer does not offer the most recent versions of Gramps in Windows, you need to wait until a new installer is made available.
For Windows user: See also some additional information on page Gramps_and_Windows.

For BSD and Solaris there are experimental install instructions below. For FreeBSD use the /usr/ports/science/gramps port.

Gnome ja KDE

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 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:

Gnome-print: 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).

Graphviz, Inkscape: 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). This gives you as researcher most power over how 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 output.

pyexiv2 is a module that allows Gramps to read and write metadata embedded in image files. It is used in the Metadata Viewer and Image Metadata gramplets.

Other packages might also be useful:

desktop-file-utils: see list of programs to open a media file on right click on an image

Lähdekoogista asentaminen

General Requirements

GRAMPS 4.1.2 requires python 2.6 and pygtk2 packages. The pygtk package should be version 2.16 or greater.

Also librsvg2-common is needed. This is a common error at the moment in some packages. Without this library, the icons are not shown.

Linux Package Requirements

Debian /Ubuntu

Fedora /Redhat

Comment

python

python

Required (needs version 2.6 or later)

pygtk2

pygtk2

Required (needs 2.16 or greater)

xdg-utils

xdg-utils

Required (Gramps-3.1.x or later)

rcs

rcs

Suggested for running

librsvg2-common

librsvg2

Required for building

librsvg2-devel

Required for building

intltool

Required for building

gcc, make, gettext

Required for building

Obtaining the source

The lastest stable version of GRAMPS can be downloaded from the GRAMPS SourceForge page. As of this writing, this is gramps-4.1.2.tar.gz. Extract this file into a directory:

tar xzvf gramps-zzz.tar.gz

and then go into this directory:

cd gramps-zzz

If you are interested in testing out the very latest development versions of GRAMPS, they can be obtained from SVN, see Brief introduction to SVN. The SVN versions of 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!

Please, now is the time to read the INSTALL and README files accompanying the code. They come with the most recent information.

Dealing with earlier versions

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

make uninstall

as root from where you installed the version from. Use your distribution's package manager to uninstall if your old version was installed as a package.

Installing from source code on Linux

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

./autogen.sh as user

This script will report any missing dependencies. Install these (see also INSTALL file). Building from source code typically requires that the development versions of the required libraries be installed. You might consider setting a prefix path with autogen.sh, see the INSTALL file for instructions. Standard install is in /usr/local.

Once a successful run of autogen.sh has been completed, you can run the typical make procedure.

make (as user)

then

make install (as root)

Installing from source code on BSD

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

Mac OS X:Build from source

There are several different ways of building Gramps from source on Mac OS X. An overview of building from source is given at Mac OS X:Build from source.

The latest version of MacPorts Gramps is 3.4.8.
The latest official unstable fink version is 3.0.4 for Mac OS X 10.5 on both PPC and Intel.
There is currently no official stable fink version of Gramps. (As at February 2012)

Installing from source code on Windows

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 and the Windows Installer, so the future looks promising. But please, use this at your own risk. The developers of GRAMPS provide the space for this install page, but are not responsible for it.

If the dependencies are in place, the development version can be tested by getting the source (see above), renaming the file const.py.in to const.py, and executing "python gramps.py" from within the src directory. Of course, this is a development version on an unsupported platform, so warnings apply even more to this case than when using the installer. (I have not managed to get a localized build working this way.)

Installing from source code on Solaris

Version 3.0.1 has been successfully installed from source on both Solaris 10 (SPARC) and OpenSolaris X86 (2008.05). Please see the Solaris page for step-by-step details.

GRAMPS on handhelds

GRAMPS can run fine on some small-factor devices. Users have been successfull in using GRAMPS on: