4,861
edits
Changes
m
[[Category:Documentation]][[Category:Developers/Installation]][[Category:Developers/Packaging]]
See the [[download]] page for the ''Windows installer'', ensure you have downloaded and installed the [[Windows_installer#Installation |Windows dependencies first.]]
====ReadyA ready-built binary 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 a previous version of Gramps).
A new port 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 Macs. Mac for Gramps is described Please read the installation instructions at [[Using Gramps on Apple Mac]]. ====Building from source==== The pre-built binary version is also available as a build environment and can be built from scratch by any Mac with 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 [[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.
svn co https://gramps.svn.sourceforge.net/svnroot/gramps grampsor svn co https://gramps.svn.sourceforge.net/svnroot/gramps/tags/gramps-3.2.5 gramps for the most recent development version, see [[Running a development version of Gramps]]. '''3. Tarball from SVN''' You can get tarball for last sources. * [http://gramps.svn.sourceforge4.net/viewvc/1 gramps/branches/maintenance/gramps32/?view=tar 3.2.x]
* for the most recent development version, see [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 Getting started with GRAMPS Trunk]].
→Obtaining the source: no longer an option
{{languages}}
== Latest released version ==
The latest released version is '''GRAMPS''' {{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 GRAMPS''' from a previous version you should first:follow these intructions.}}
If you are '''Upgrading Gramps''' from a previous version you 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''' on in the Exporter Assistantin 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 datain this Family Tree
==Additional software GRAMPS can benefit from==
Other packages might also be useful:
* '''[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
==Linux==
===Automatic download and install of GRAMPS===
Before downloading 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 stable on Sourceforge] and look at the version number of the top package.
To check what is available specifically for your Linux operating system some methods are listed below:
====Ubuntu and derivatives====
Repository packages for '''Ubuntu''' and derivatives (Kubuntu, Mephis, LinuxMint, ...): are available on [http://sourceforge.net/projects/gramps/files/Stable/ GRAMPS download page].
{{cleanup}}
{|{{prettytable}}
|-
|<!-- Ubuntu (Version) --> (10.10)
|<!-- GRAMPS<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]
|-
|<!-- Ubuntu (Version) --> (10.04)
|<!-- GRAMPS<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]
|-
|<!-- Ubuntu (Version) --> (9.10)
|<!-- GRAMPS<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]
|-
|<!-- Ubuntu (Version) -->Jaunty Jackalope (9.04)
|<!-- GRAMPS<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]
|-
|<!-- Ubuntu (Version) -->Intrepid Ibex (8.10)
====Fedora====
'''Fedora''': For Fedora Core look on the [http://sourceforge.net/projectprojects/gramps/files/showfiles.php?group_id=25770 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====
Different GNU/Linux distributions have other 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 [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.
===Gnome and KDE===
===GRAMPS on handhelds===
GRAMPS can run fine on some small-factor devices. Users have been successful in using 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]
===Live Genealogy CD===
==Windows, FreeBSD, Mac OS X, Solaris==
===Windows===
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 mush 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 is has the lowest barrier of entry, see [[ All 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 more information.* GRAMPS installer (minimal) - Stable installer, however it requires you to install all of GRAMPS dependencies prior to installing GRAMPS. see [[ Windows_installer#Installation | Installing Windows installer dependencies first.]]* GRAMPS Portable - more info required More information of each of these installation methods can be seen on the [[download]] page.
*Additional information for Windows users is on page [[GRAMPS and Windows]].
===Mac OS X===
===Free/OpenBSD and Solaris===
|
| Django
| Required for http://gramps-connect.org[[Gramps-Connect: Introduction|Gramps-Connect]]
|-
| python-pyexiv2
| osm-gps-map
| Required for the Geography views
|-
| gtk2-engines-pixbuf
|
| Solves issue with 'Unable to locate theme engine in module_path: "pixmap"'
|}
'''1. Download a stable version'''
* The latest stable version of GRAMPS can be downloaded from the [http://sourceforge.net/projects/gramps /files/ GRAMPS SourceForge pagefile area]. Eg: gramps-{{version}}.tar.gz. Extract this file into a directory:
<code>
tar xzvf gramps-zzz.tar.gz
You can get a branch version (similar as above) or the latest bleeding-edge version through SVN, such as:
====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>
make uninstall</code>
Local installation without root privileges is possible, instructions are available on the INSTALL file, most importantly one needs to supply a <code>--prefix=</code> and a <code>--with-mime-dir=</code> argument to <code>autogen.sh</code>.
==== See also ====
* $GRAMPSHOME on [[Gramps 3.4 Wiki Manual - Command Line#Environment variables]]
* [[Translating_GRAMPS#.24GRAMPSI18N_.28for_your_locale.29| $GRAMPSI18N (for your locale) ]]
* [[Installation_alternatives]]
* [[Translating_GRAMPS#Installing_your_translation]]
* [[Howto:Change_the_language_of_reports#Run_GRAMPS_in_a_different_language]]
===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]].
[[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]]
An older build approach is given at [[Mac OS X:Build from source:Native OS X]].
[[Category:Documentation]]
[[Category:Developers/Installation]]
[[Category:Developers/Packaging]]
