https://blog.gramps-project.org/wiki/api.php?action=feedcontributions&user=Pvr4me&feedformat=atomGramps - User contributions [en]2024-03-28T18:32:06ZUser contributionsMediaWiki 1.31.3https://blog.gramps-project.org/wiki/index.php?title=Download&diff=93804Download2022-11-24T14:25:14Z<p>Pvr4me: /* MacPorts */ most packages are delivered as binaries rather than strictly being built from source</p>
<hr />
<div>{{languages|Download}}<br />
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
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.<br />
<br />
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2022-02-05'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as [https://www.python.org/doc/sunset-python-2/ Python 2 support dropped]. Uses GTK+ 3 GUI. Default database is now SQLite. Lot of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]{{-}}<br />
[[File:Linux_220x261.png|128px|link=Download#Linux]] [[File:windows_180x160.png|128px|link=Download#MS_Windows]] [[File:macos_200x200.png|128px|link=Download#macOS]] [[File:Bsd daemon.png|128px|link=Download#BSD]]}} <br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
Before upgrading your distribution: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]]. <br />
<br />
<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
Before downloading the All-In-One software installer bundle for Windows: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{man note|''The {{version_windows_AIO64}} and {{version_windows_AIO64}}-2 installers are the '''same version of the Gramps program'''. |Only the compilation of the installer was changed. The initial Windows installer was quickly recalled so that the 'dash two' update could restore some omitted dependency items.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>By default: new releases will be added in a new directory and earlier installations of Gramps will ''not'' be overwritten; the language will be a [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the back-up]] into this new Tree.<br />
<br />
Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO cx freeze-based|this page]] (English only). Or, you might want to look at the description of what is meant by an [[All_In_One_Gramps_Software_Bundle_for_Windows|All In One Bundle.]]<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
==== PortableApps.com ====<br />
A [https://portableapps.com/apps/education/gramps_portable '''PortableApps''' version] will run from an external device without the requirement of installing on the OS drive. PortableApps installations are <b><i>not</i></b> for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* the [https://portableapps.com/apps/education/gramps_portable Gramps Portable project] page in their [https://portableapps.com/apps/education/ Education] category. <br />
<br />
Note that '''PortableApps.com''' also has a Legacy 3.4.9 version of Gramps available -- although it is not recommended for general use; just for recovering older format databases.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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.'' '''[https://portableapps.com/forums/support/education Please report packaging issues here]'''<br />
<br />
==== Chocolatey NuGet Package ====<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
==== Gramps for Windows with MSYS2 ====<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
If you prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
Even your primary language is installed by default, you might anticipate the need to spellcheck Notes in other than the British dialect of English. Be certain to select the appropriate languages from '''Dictionaries'''. Gramps will not access your Operating System's native dictionary.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== macOS ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before downloading the ready-to-run stand-alone bundle: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 12 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_12:_%22Monterey%22 Monterey]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
</big><br />
<br />
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. (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.)<br />
<br />
<br />
Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the back-up]] into this new Tree.<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be built and installed on macOS using MacPorts.<br />
<br />
{{-}}<br />
==== MacPorts ====<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
==== Homebrew ====<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|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 [https://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, make it 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.}}<br />
<br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux and BSD distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
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.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.5<br />
* bookworm (testing): Gramps 5.1.5<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.5<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually 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 />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* Rawhide (Gramps 5.1.5)<br />
* Fedora 34 (Gramps 5.1.5)<br />
* Fedora 35 (Gramps 5.1.5)<br />
* Fedora 35 (Gramps 5.1.5)<br />
* Fedora 36 (Gramps 5.1.5)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.5<br />
* openSUSE Leap 15.3: Gramps 4.2.8 <!-- is expected to be maintained until end of November 2022 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 4.2.6<br />
* 14.1: Gramps 4.0.3<br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.5<br />
|<!-- Notes -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.4<br />
* Gramps 5.1.5 (testing)<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.5]<br />
|<!-- Notes --><br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* FreeBSD: Gramps 4.2.8<br />
* [https://www.freshports.org/science/gramps/ FreshPorts: Gramps 5.1.5]<br />
|<!-- Notes --><!--[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]--><br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.5<br />
|<!-- Notes -->[http://openports.se/misc/gramps available versions]<br />
|-<br />
|<!-- Distribution --><br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
|<!-- Notes --><br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
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.<br />
<br />
{{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.<br />
<br />
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.<br />
<br />
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 5.1.3 to 5.1.5), 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 4.y.z to 5.y.z), then the danger that it does not work properly is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb 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 ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{version}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package and gives you info about it.<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at Flathub.<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} an old version released 2010-11-17 and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''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, [https://rufus.ie/en/ Rufus]..). [[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 the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man note|Note|This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}<br />
<br />
You can also try an online demonstration of Gramps on rollApp:<br />
* https://www.rollapp.com/app/gramps<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
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]]<br />
<br />
== See also ==<br />
* [https://github.com/gramps-project/gramps/releases GitHub folder of Gramps releases]<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
[[Category:Documentation]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Download&diff=93803Download2022-11-24T14:23:05Z<p>Pvr4me: /* MacPorts */ for pre-reqs</p>
<hr />
<div>{{languages|Download}}<br />
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
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.<br />
<br />
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2022-02-05'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as [https://www.python.org/doc/sunset-python-2/ Python 2 support dropped]. Uses GTK+ 3 GUI. Default database is now SQLite. Lot of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]{{-}}<br />
[[File:Linux_220x261.png|128px|link=Download#Linux]] [[File:windows_180x160.png|128px|link=Download#MS_Windows]] [[File:macos_200x200.png|128px|link=Download#macOS]] [[File:Bsd daemon.png|128px|link=Download#BSD]]}} <br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
Before upgrading your distribution: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]]. <br />
<br />
<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
Before downloading the All-In-One software installer bundle for Windows: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{man note|''The {{version_windows_AIO64}} and {{version_windows_AIO64}}-2 installers are the '''same version of the Gramps program'''. |Only the compilation of the installer was changed. The initial Windows installer was quickly recalled so that the 'dash two' update could restore some omitted dependency items.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>By default: new releases will be added in a new directory and earlier installations of Gramps will ''not'' be overwritten; the language will be a [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the back-up]] into this new Tree.<br />
<br />
Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO cx freeze-based|this page]] (English only). Or, you might want to look at the description of what is meant by an [[All_In_One_Gramps_Software_Bundle_for_Windows|All In One Bundle.]]<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
==== PortableApps.com ====<br />
A [https://portableapps.com/apps/education/gramps_portable '''PortableApps''' version] will run from an external device without the requirement of installing on the OS drive. PortableApps installations are <b><i>not</i></b> for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* the [https://portableapps.com/apps/education/gramps_portable Gramps Portable project] page in their [https://portableapps.com/apps/education/ Education] category. <br />
<br />
Note that '''PortableApps.com''' also has a Legacy 3.4.9 version of Gramps available -- although it is not recommended for general use; just for recovering older format databases.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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.'' '''[https://portableapps.com/forums/support/education Please report packaging issues here]'''<br />
<br />
==== Chocolatey NuGet Package ====<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
==== Gramps for Windows with MSYS2 ====<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
If you prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
Even your primary language is installed by default, you might anticipate the need to spellcheck Notes in other than the British dialect of English. Be certain to select the appropriate languages from '''Dictionaries'''. Gramps will not access your Operating System's native dictionary.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== macOS ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before downloading the ready-to-run stand-alone bundle: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 12 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_12:_%22Monterey%22 Monterey]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
</big><br />
<br />
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. (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.)<br />
<br />
<br />
Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the back-up]] into this new Tree.<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be built and installed on macOS using MacPorts.<br />
<br />
{{-}}<br />
==== MacPorts ====<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
==== Homebrew ====<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|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 [https://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, make it 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.}}<br />
<br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux and BSD distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
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.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.5<br />
* bookworm (testing): Gramps 5.1.5<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.5<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually 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 />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* Rawhide (Gramps 5.1.5)<br />
* Fedora 34 (Gramps 5.1.5)<br />
* Fedora 35 (Gramps 5.1.5)<br />
* Fedora 35 (Gramps 5.1.5)<br />
* Fedora 36 (Gramps 5.1.5)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.5<br />
* openSUSE Leap 15.3: Gramps 4.2.8 <!-- is expected to be maintained until end of November 2022 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 4.2.6<br />
* 14.1: Gramps 4.0.3<br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.5<br />
|<!-- Notes -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.4<br />
* Gramps 5.1.5 (testing)<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.5]<br />
|<!-- Notes --><br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* FreeBSD: Gramps 4.2.8<br />
* [https://www.freshports.org/science/gramps/ FreshPorts: Gramps 5.1.5]<br />
|<!-- Notes --><!--[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]--><br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.5<br />
|<!-- Notes -->[http://openports.se/misc/gramps available versions]<br />
|-<br />
|<!-- Distribution --><br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
|<!-- Notes --><br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
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.<br />
<br />
{{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.<br />
<br />
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.<br />
<br />
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 5.1.3 to 5.1.5), 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 4.y.z to 5.y.z), then the danger that it does not work properly is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb 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 ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{version}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package and gives you info about it.<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at Flathub.<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} an old version released 2010-11-17 and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''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, [https://rufus.ie/en/ Rufus]..). [[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 the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man note|Note|This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}<br />
<br />
You can also try an online demonstration of Gramps on rollApp:<br />
* https://www.rollapp.com/app/gramps<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
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]]<br />
<br />
== See also ==<br />
* [https://github.com/gramps-project/gramps/releases GitHub folder of Gramps releases]<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
[[Category:Documentation]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Mac_OS_X:Build_from_source:MacPorts&diff=85273Mac OS X:Build from source:MacPorts2021-06-24T00:26:57Z<p>Pvr4me: mention that many other packages are available via MacPorts</p>
<hr />
<div>MacPorts is a package manager for Mac providing access to thousands of open source packages. It allows you to easily install, upgrade or even uninstall software onto your Mac.<br />
<br />
==Installing Gramps using MacPorts==<br />
<br />
Gramps version available from MacPorts is: {{version_MacPort}} ( https://ports.macports.org/port/gramps/ )<br />
<br />
# Download and install the latest Xcode tools from https://developer.apple.com/xcode/<br />
# Download and install Macports from http://www.macports.org/install.php<br />
# Open Terminal.app from /Applications/Utilities and enter these commands:<br />
sudo port selfupdate<br />
sudo port install gramps<br />
<br />
If you are running a recent version of OS X (Snow Leopard, or later, at this point), much of the support software is pre-compiled and will install as quickly as it is downloaded.<br />
<br />
==Running Gramps==<br />
<br />
Use Terminal to start gramps: <br />
gramps<br />
<br />
==Graphviz==<br />
<br />
You may wish to install Graphviz to handle some of the graphical reports that Gramps can produce. MacPorts can provide you with either graphical or command-line based versions of either a 'stable' or 'development' release of Graphviz. 'graphviz-gui' is recommended unless you know that you have a need for the development version. Install with:<br />
<br />
sudo port install graphviz-gui<br />
<br />
==Issues==<br />
<br />
Please don't hesitate to create a ticket if you find a problem that you believe is related to the MacPorts build process.<br />
<br />
<br />
[[Category:Developers/Packaging]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Download&diff=85272Download2021-06-24T00:22:31Z<p>Pvr4me: /* Notes */ Remove redundant MacPorts footnote</p>
<hr />
<div>{{languages|Download}}<br />
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
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.<br />
<br />
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2020-08-13'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as [https://www.python.org/doc/sunset-python-2/ Python 2 support dropped]. Uses GTK+ 3 GUI. Default database is now SQlite. Lot of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]{{-}}<br />
[[File:Linux_220x261.png|128px|link=Download#Linux]] [[File:windows_180x160.png|128px|link=Download#MS_Windows]] [[File:macos_200x200.png|128px|link=Download#macOS]] [[File:Bsd daemon.png|128px|link=Download#BSD]]}} <br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
Before downloading the [[All_In_One_Gramps_Software_Bundle_for_Windows|All-In-One software installer bundle for Windows]]: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<br />
After download: '''double-click to install Gramps'''. <br>By default: new releases will be added in a new directory and earlier installations of Gramps will ''not'' be overwritten; the language will be a [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the back-up]] into this new Tree.<br />
<br />
Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO cx freeze-based|this page]] (English only).<br />
<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
A [https://portableapps.com/apps/education/gramps_portable PortableApps version] will run from an external device without the requirement of installing on the OS drive. [[#2|PortableApps installations<sup>2</sup>]] are <b><i>not</i></b> for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives.<br />
<br />
You may also install using the alternative independent Gramps [[#3|Chocolatey NuGet Package<sup>3</sup>]].<br />
<br />
{{-}}<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
If you prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
Even your primary language is installed by default, you might anticipate the need to spellcheck Notes in other than the British dialect of English. Be certain to select the appropriate languages from '''Dictionaries'''. Gramps will not access your Operating System's native dictionary.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== macOS ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.5 ([https://wikipedia.org/wiki/Mac_OS_X_Leopard Leopard]) through 11 ([https://wikipedia.org/wiki/MacOS_Big_Sur Big Sur]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
</big> <br />
<br />
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. [[#4|[4]]].<br />
<br />
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.<br />
<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be installed on MacOS using either [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]] or [[#6|Homebrew<sup>5</sup>]] package manager systems.<br />
<br />
{{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 [https://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, make it 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.}}<br />
<br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux and BSD distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
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.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 8 ("jessie")(old old stable): Gramps 4.1.1<!-- Debian 8 EOL ~2020-06-30 https://wiki.debian.org/DebianReleases#Production_Releases / Extended Long Term Support until ~2022-06-30 --><br />
* Debian 9 ("stretch") (old stable): Gramps 4.2.5<br />
* Debian 9 ("stretch")([https://packages.debian.org/stretch-backports/gramps backports]): Gramps 5.0.1<br />
* Debian 10 ("buster") (stable): Gramps 5.0.1<br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* bullseye (testing): Gramps 5.1.3<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.3<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><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 />
* Bionic Beaver (18.04 LTS): Gramps: 5.0.0<br />
* Eoan (19.10): Gramps: 5.0.1<br />
* Focal (20.04 LTS): Gramps: 5.1.2<br />
* Groovy Gorilla (Development: 20.10): Gramps: 5.1.3<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 18.x(Gramps 4.2.2~dfsg-1)<br />
* 19.x(Gramps 4.2.8)<br />
* 20.x(Gramps 5.1.2)<br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually 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 />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* Rawhide (Gramps 5.1.3)<br />
* Fedora 31 (Gramps 5.1.3)<br />
* Fedora 32 (Gramps 5.1.3)<br />
* Fedora 32 (Gramps 5.1.3)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.3<br />
* Mageia 7.1: Gramps 5.0.1<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><br />
* openSUSE Tumbleweed: Gramps 5.1.3<br />
* openSUSE Leap 15.2: Gramps 4.2.8<br />
* openSUSE Leap 15.1: Gramps 4.2.8<br />
* openSUSE Leap 15.0: Gramps 4.2.8<br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 14.2: Gramps 4.2.6<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.1: Gramps 4.0.3<br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.3<br />
|<!-- Notes -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.3<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps3 Gramps 3.4.9]<br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.2]<br />
|<!-- Notes --><br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* FreeBSD: Gramps 4.2.8<br />
* [https://www.freshports.org/science/gramps/ FreshPorts: Gramps 5.1.1]<br />
|<!-- Notes -->[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.3<br />
|<!-- Notes -->[http://openports.se/misc/gramps available versions]<br />
|-<br />
|<!-- Distribution --><br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
|<!-- Notes --><br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
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.<br />
<br />
{{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.<br />
<br />
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.<br />
<br />
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.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') [{{github_url}}/releases/v{{version}} 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 ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{version}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about language support when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package and gives you info about it.<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps 5.1.3 is available in a flatpak at flathub.<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the 5.1.3 flatpak.}}<br />
<br />
First set up flatpak and the flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Live CD ==<br />
<br />
{{man warn|Note that both Live CD demonstrations use an old version of Gramps and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''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 the CD anytime you like.<br />
{{-}}<br />
<br />
=== Online Demonstration ===<br />
You can also try an online demonstration of Gramps on rollApp:<br />
* https://www.rollapp.com/app/gramps<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{man note|Note|This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
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]]<br />
<br />
[<span id="2">2</span>]<br />
{{man menu|You can download Gramps Portable version 5.1.3-2 from https://portableapps.com/apps/education/gramps_portable .}} Note that PortableApps.com also have available an old version of Gramps and it is not recommended for general use; 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)<br />
<br />
[<span id="3">3</span>]<br />
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]<br />
<br />
[<span id="4">4</span>]<br />
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.<br />
<br />
[<span id="5">5</span>]<br />
Homebrew is an open-source package manager for macOS (and Linux). See https://github.com/homebrew/.<br />
<br />
== See also ==<br />
* [[Previous releases of Gramps]]<br />
* [[User:Sam888#Gramps_Downloads_.28since:_2001.2F04.2F21.29|Rough download statistics]]<br />
<br />
[[Category:Documentation]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Download&diff=85271Download2021-06-24T00:21:25Z<p>Pvr4me: /* macOS */ just link to MacPorts install instructions</p>
<hr />
<div>{{languages|Download}}<br />
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
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.<br />
<br />
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2020-08-13'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as [https://www.python.org/doc/sunset-python-2/ Python 2 support dropped]. Uses GTK+ 3 GUI. Default database is now SQlite. Lot of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]{{-}}<br />
[[File:Linux_220x261.png|128px|link=Download#Linux]] [[File:windows_180x160.png|128px|link=Download#MS_Windows]] [[File:macos_200x200.png|128px|link=Download#macOS]] [[File:Bsd daemon.png|128px|link=Download#BSD]]}} <br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
Before downloading the [[All_In_One_Gramps_Software_Bundle_for_Windows|All-In-One software installer bundle for Windows]]: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<br />
After download: '''double-click to install Gramps'''. <br>By default: new releases will be added in a new directory and earlier installations of Gramps will ''not'' be overwritten; the language will be a [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the back-up]] into this new Tree.<br />
<br />
Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO cx freeze-based|this page]] (English only).<br />
<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
A [https://portableapps.com/apps/education/gramps_portable PortableApps version] will run from an external device without the requirement of installing on the OS drive. [[#2|PortableApps installations<sup>2</sup>]] are <b><i>not</i></b> for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives.<br />
<br />
You may also install using the alternative independent Gramps [[#3|Chocolatey NuGet Package<sup>3</sup>]].<br />
<br />
{{-}}<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
If you prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
Even your primary language is installed by default, you might anticipate the need to spellcheck Notes in other than the British dialect of English. Be certain to select the appropriate languages from '''Dictionaries'''. Gramps will not access your Operating System's native dictionary.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== macOS ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before download: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.5 ([https://wikipedia.org/wiki/Mac_OS_X_Leopard Leopard]) through 11 ([https://wikipedia.org/wiki/MacOS_Big_Sur Big Sur]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
</big> <br />
<br />
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. [[#4|[4]]].<br />
<br />
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.<br />
<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be installed on MacOS using either [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]] or [[#6|Homebrew<sup>5</sup>]] package manager systems.<br />
<br />
{{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 [https://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, make it 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.}}<br />
<br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux and BSD distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
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.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 8 ("jessie")(old old stable): Gramps 4.1.1<!-- Debian 8 EOL ~2020-06-30 https://wiki.debian.org/DebianReleases#Production_Releases / Extended Long Term Support until ~2022-06-30 --><br />
* Debian 9 ("stretch") (old stable): Gramps 4.2.5<br />
* Debian 9 ("stretch")([https://packages.debian.org/stretch-backports/gramps backports]): Gramps 5.0.1<br />
* Debian 10 ("buster") (stable): Gramps 5.0.1<br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* bullseye (testing): Gramps 5.1.3<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.3<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><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 />
* Bionic Beaver (18.04 LTS): Gramps: 5.0.0<br />
* Eoan (19.10): Gramps: 5.0.1<br />
* Focal (20.04 LTS): Gramps: 5.1.2<br />
* Groovy Gorilla (Development: 20.10): Gramps: 5.1.3<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 18.x(Gramps 4.2.2~dfsg-1)<br />
* 19.x(Gramps 4.2.8)<br />
* 20.x(Gramps 5.1.2)<br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually 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 />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* Rawhide (Gramps 5.1.3)<br />
* Fedora 31 (Gramps 5.1.3)<br />
* Fedora 32 (Gramps 5.1.3)<br />
* Fedora 32 (Gramps 5.1.3)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.3<br />
* Mageia 7.1: Gramps 5.0.1<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><br />
* openSUSE Tumbleweed: Gramps 5.1.3<br />
* openSUSE Leap 15.2: Gramps 4.2.8<br />
* openSUSE Leap 15.1: Gramps 4.2.8<br />
* openSUSE Leap 15.0: Gramps 4.2.8<br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 14.2: Gramps 4.2.6<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.1: Gramps 4.0.3<br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.3<br />
|<!-- Notes -->[https://www.archlinux.org/packages/community/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.3<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps3 Gramps 3.4.9]<br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.2]<br />
|<!-- Notes --><br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* FreeBSD: Gramps 4.2.8<br />
* [https://www.freshports.org/science/gramps/ FreshPorts: Gramps 5.1.1]<br />
|<!-- Notes -->[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.3<br />
|<!-- Notes -->[http://openports.se/misc/gramps available versions]<br />
|-<br />
|<!-- Distribution --><br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
|<!-- Notes --><br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
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.<br />
<br />
{{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.<br />
<br />
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.<br />
<br />
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.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') [{{github_url}}/releases/v{{version}} 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 ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{version}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about language support when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package and gives you info about it.<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps 5.1.3 is available in a flatpak at flathub.<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the 5.1.3 flatpak.}}<br />
<br />
First set up flatpak and the flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Live CD ==<br />
<br />
{{man warn|Note that both Live CD demonstrations use an old version of Gramps and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''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 the CD anytime you like.<br />
{{-}}<br />
<br />
=== Online Demonstration ===<br />
You can also try an online demonstration of Gramps on rollApp:<br />
* https://www.rollapp.com/app/gramps<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{man note|Note|This is a commercial limited trial and not endorsed by the Gramps-project. Beware of third parties having your genealogical data.}}<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
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]]<br />
<br />
[<span id="2">2</span>]<br />
{{man menu|You can download Gramps Portable version 5.1.3-2 from https://portableapps.com/apps/education/gramps_portable .}} Note that PortableApps.com also have available an old version of Gramps and it is not recommended for general use; 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)<br />
<br />
[<span id="3">3</span>]<br />
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]<br />
<br />
[<span id="4">4</span>]<br />
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.<br />
<br />
[<span id="5">5</span>]<br />
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: <code>port install gramps</code> see: [[Mac OS X:Build from source:MacPorts]]<br />
<br />
[<span id="6">6</span>]<br />
Homebrew is an open-source package manager for macOS (and Linux). See https://github.com/homebrew/.<br />
<br />
== See also ==<br />
* [[Previous releases of Gramps]]<br />
* [[User:Sam888#Gramps_Downloads_.28since:_2001.2F04.2F21.29|Rough download statistics]]<br />
<br />
[[Category:Documentation]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Talk:Mac_OS_X:Build_from_source:MacPorts&diff=84817Talk:Mac OS X:Build from source:MacPorts2021-05-31T15:54:01Z<p>Pvr4me: Delete years-old reports of problems that were fixed long ago.</p>
<hr />
<div></div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Template:Version_MacPort&diff=84816Template:Version MacPort2021-05-31T15:49:33Z<p>Pvr4me: </p>
<hr />
<div>5.1.3<noinclude><br />
[[Category:Developers/Packaging ]]<br />
[[Category:Versions]]<br />
[[Category:Templates]]<br />
</noinclude></div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Mac_OS_X:Build_from_source:MacPorts&diff=80383Mac OS X:Build from source:MacPorts2020-08-15T19:44:47Z<p>Pvr4me: /* Issues */ Redundant info--all available through the Gramps port page, linked above.</p>
<hr />
<div>MacPorts is a package manager for Mac. It allows you to easily install and uninstall open-source software onto your Mac.<br />
<br />
==Installing Gramps using MacPorts==<br />
<br />
Gramps version available from MacPorts is: {{version_MacPort}} ( https://ports.macports.org/port/gramps/ )<br />
<br />
# Download and install the latest Xcode tools from https://developer.apple.com/xcode/<br />
# Download and install Macports from http://www.macports.org/install.php<br />
# Open Terminal.app from /Applications/Utilities and enter these commands:<br />
sudo port selfupdate<br />
sudo port install gramps<br />
<br />
If you are running a recent version of OS X (Snow Leopard, or later, at this point), much of the support software is pre-compiled and will install as quickly as it is downloaded.<br />
<br />
==Running Gramps==<br />
<br />
Use Terminal to start gramps: <br />
gramps<br />
<br />
==Graphviz==<br />
<br />
You may wish to install Graphviz to handle some of the graphical reports that Gramps can produce. MacPorts can provide you with either graphical or command-line based versions of either a 'stable' or 'development' release of Graphviz. 'graphviz-gui' is recommended unless you know that you have a need for the development version. Install with:<br />
<br />
sudo port install graphviz-gui<br />
<br />
==Issues==<br />
<br />
Please don't hesitate to create a ticket if you find a problem that you believe is related to the MacPorts build process.<br />
<br />
<br />
[[Category:Developers/Packaging]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=File:ImportFamilyTree_5.1.1_macOS_MacPorts.png&diff=80382File:ImportFamilyTree 5.1.1 macOS MacPorts.png2020-08-15T19:34:51Z<p>Pvr4me: Import Family Tree - dialog example: Gramps 5.1.1 on macOS via MacPorts</p>
<hr />
<div>== Summary ==<br />
Import Family Tree - dialog example: Gramps 5.1.1 on macOS via MacPorts</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=User:Pvr4me&diff=57086User:Pvr4me2015-08-13T14:53:54Z<p>Pvr4me: </p>
<hr />
<div>Researching: Treleaven, Franks, Johnstone, Fowler, Caird, MacLean, MacKay, Crich<br />
<br />
Using MacPorts version of Gramps on OS X 10.10.4. Maintainer of MythTV ports on MacPorts.<br />
<br />
[[Category:User|P]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Mac_OS_X:Build_from_source:MacPorts&diff=57085Mac OS X:Build from source:MacPorts2015-08-13T14:52:35Z<p>Pvr4me: /* Installing Gramps using MacPorts */ separate ports for gramps (version 4) and gramps3</p>
<hr />
<div>{{languages}}<br />
==Installing Gramps using MacPorts==<br />
<br />
Current version available from MacPorts is: {{version_MacPort}}<br />
<br />
# Download and install the latest Xcode tools from http://developer.apple.com/technology/Xcode.html <br />
# Download and install Macports from http://www.macports.org/install.php<br />
# Open Terminal.app from /Applications/Utilities and enter these commands:<br />
sudo port selfupdate<br />
sudo port install gramps<br />
<br />
If you are running a recent version of OS X (Snow Leopard, or later, at this point), much of the support software is pre-compiled and will install as quickly as it is downloaded.<br />
<br />
If you have been using Version 3 of Gramps and are not ready to upgrade, the most recent version available is 3.49. You can install it with:<br />
<br />
sudo port install gramps3<br />
<br />
Note that gramps3 will be retired at some point in the not too distant future.<br />
<br />
==Running Gramps==<br />
<br />
Use Terminal to start gramps: <br />
gramps<br />
<br />
==GraphViz==<br />
<br />
You may wish to install GraphViz to handle some of the graphical reports that Gramps can produce. MacPorts can provide you with either graphical or command-line based versions of either a 'stable' or 'development' release of GraphViz. 'graphviz-gui' is recommended unless you know that you have a need for the development version. Install with:<br />
<br />
sudo port install graphviz-gui<br />
<br />
==Issues==<br />
<br />
You can search the MacPorts bug tracker for any issues related to the Gramps port:<br />
<br />
https://trac.macports.org/search?portsummarysearch=on<br />
<br />
Please don't hesitate to create a ticket if you find a problem that you believe is related to the MacPorts build process.<br />
<br />
<br />
[[Category:Developers/Packaging]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Template:Version_MacPort&diff=57084Template:Version MacPort2015-08-13T14:48:23Z<p>Pvr4me: Use this to track Version 4 updates, now</p>
<hr />
<div>4.2.0</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Gramps_4.2_Wiki_Manual_-_Main_Window&diff=57083Gramps 4.2 Wiki Manual - Main Window2015-08-13T14:39:18Z<p>Pvr4me: /* Mac OS X */ -- be explicit about finding the Console app.</p>
<hr />
<div>{{grampsmanualcopyright}}<br />
<br />
{{man index|Gramps 4.2 Wiki Manual - Getting Started|Gramps 4.2 Wiki Manual - Categories|4.2}}<br />
<br />
{{languages|Gramps 4.2 Wiki Manual - Main Window}}<br />
<br />
{{#vardefine:chapter|3}}<br />
{{#vardefine:figure|0}}<br />
<br />
Elements of Gramps main window.<br />
<br />
== Main Window ==<br />
<br />
When you open a Family Tree database (either existing or new), the main Gramps window is displayed (Fig. {{#var:chapter}}.{{#expr:{{#var:figure}}+1}}):<br />
<br />
[[File:MainWindow-annotated-41.png|800px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps Main Window]]<br />
<br />
{{-}}<br />
<br />
The main Gramps window contains the following elements:<br />
<br />
===Window Title Bar===<br />
*Window Title Bar shows the name of selected Family Tree, Gramps application name and buttons to minimize, maximize and close Gramps. The window can also be dragged from the Title Bar.<br />
<br />
=== Menubar ===<br />
*Menubar: The menubar (Main Menu) is located at the very top of the window (right below the window title) and provides access to all the features of Gramps.<br />
<br />
=== Toolbar ===<br />
*Toolbar: The toolbar is located right below the menubar. It gives you access to the most frequently used functions of Gramps. You can set options that control how it appears by going to the menu {{man menu|Edit ->Preferences}}.<br />
The Toolbar can be hidden or revealed by the option in menu {{man menu|View ->Toolbar}}.<br />
<br />
=== Navigator ===<br />
*Navigator: The navigator is located at the left of the window and allows selection of the different categories. See [[Gramps_4.2_Wiki_Manual_-_Categories#Categories_of_the_Navigator|Categories of the Navigator]]<br />
The Navigator can be hidden or revealed by the options in menu {{man menu|View ->Navigator}}.<br />
<br />
=== Display area ===<br />
*Display area: The area in the center of the Gramps window is the display area. What it displays depends on the currently selected View. We will discuss Views in detail below.<br />
<br />
=== Status Bar and Progress Bar ===<br />
*Status Bar and Progress Bar: These are located at the very bottom of the Gramps window.<br />
** The Progress Bar is located in the lower left corner of the Gramps window. It displays the progress of time consuming operations, such as opening and saving large Family Tree databases, importing and exporting to other formats, generating web sites, etc. When you are not doing these types of operations, the Progress Bar is not shown. <br />
** The Status Bar is located to the right of the Progress Bar. It displays information about current Gramps activity and contextual information about the selected items.<br />
<br />
=== Bottombar and Sidebar ===<br />
*Bottombar: The bottombar is located below the display area.<br />
<br />
*Sidebar: The sidebar is located to the right of the display area.<br />
<br />
The Bottombar and the Sidebar allow [[Gramps_4.2_Wiki_Manual_-_Gramplets|gramplets]] and [[Gramps_4.2_Wiki_Manual_-_Main_Window#Filters|filters]] to be displayed alongside a view.<br />
<br />
The Sidebar and Bottombar can be individually hidden or revealed by options in menu {{man menu|View}}. If the Sidebar is not displayed, then the {{man label|Search bar}} is displayed instead.<br />
<br />
[[File:MainWindowSearchbar-annotated-41.png|750px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps Main Window showing Search Bar]]<br />
<br />
{{-}}<br />
<br />
== Switching Navigator modes ==<br />
<br />
If there is more than one navigator mode installed, you can choose the navigator mode from the drop down list.<br />
<br />
The navigator modes are '''"Category"'''(Default), "Drop-Down" and "Expander"<br />
<br />
[[File:Navigator-mode-selection-dropdownlist-41.png|left|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Navigator mode selection drop down list]]<br />
<br />
[[Image:Mainwin-40.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Category navigator mode]]<br />
{{-}}<br />
[[Image:Drop-Down.png|right|thumb|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Drop-Down navigator mode]]<br />
<br />
[[Image:Expander.png|left|thumb|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Expander navigator mode]]<br />
{{-}}<br />
{{man note|Note|In the Plugin Manager, Navigator modes are called Sidebar plugins, but this is inconsistent,because the {{man menu|View->Sidebar}} menu item removes the ''right-hand'' filter/gramplet sidebar, not the ''left-hand'' category sidebar.}}<br />
{{-}}<br />
<br />
== Switching Categories ==<br />
<br />
Gramps comes with number of different categories as standard. The built-in categories are described in [[Gramps_4.2_Wiki_Manual_-_Categories#Categories_of_the_Navigator|categories]]. You can [[Plugins4.2|download addon]] 'Gramps View's via the Preferences menu. If the view is a new or updated view for an existing category, then the view is added to that category. However, if the view is a view for a ''new'' category, then the new category is added to the navigator. <br />
<br />
The way you change the currently displayed category depends on the navigator mode. Normally (for most navigator modes) you can select the category you want by clicking one of the navigator icons.<br />
<br />
Alternatively you can use the keyboard shortcuts {{man key press|CTRL|P}} and {{man key press|CTRL|N}} go to the previous or next category respectively. If you have turned off the [[Gramps_4.2_Wiki_Manual_-_Main_Window#Navigator|navigator]] this will be the only way to change categories (unless you turn the navigator on again).<br />
<br />
{{-}}<br />
<br />
== Switching Views ==<br />
<br />
A category can contain different ways of presenting the data, called a View. If there are several views, you can switch between the views. The way you change between the views depends on the viewing mode. In some viewing modes, there is an icon button on the toolbar to switch to a different view. You can also switch via the menu {{man menu|View}}, or by pressing {{man key press|CTRL|<number>}}, where <number> is the view you want in this category.<br />
<br />
{{-}}<br />
<br />
== Column Editor ==<br />
<br />
{{man note| Column Editor |The Column Editor is available in all Views and works the same way in each.}}<br />
<br />
[[Image:Column-editor-40.png|right|thumb|250px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Column Editor Dialog]]<br />
<br />
By default, the View List, displays several columns of information about the repective category. You can add or remove columns to and from the display by calling up the {{man label|Column Editor}} dialog from the menu {{man menu|View -> Configure View...}} or click on toolbar {{man button|Configure View...}} button and then checking or unchecking the boxes listed. You can also change the position of a column in People View by clicking and dragging it to a new position in the Editor ([http://en.wikipedia.org/wiki/Drag-and-drop ''drag and drop'']). Once you have made the changes you want, click {{man button|OK}} to exit the Editor and see your changes in the View.<br />
<br />
The default sort key for the view [always ascending] is the left-most field [i.e. at the top in the Column Editor], so changing which field is in that position affects default sorting.<br />
<br />
{{-}}<br />
<br />
== Filters ==<br />
<br />
[[Image:SidebarFilter-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Filter Controls Displayed]]<br />
<br />
Genealogical databases can contain information on many people, families, places, and objects. It is therefore possible for a View to contain a long list of data that is difficult to work with. Gramps gives you two different means for controlling this condition by allowing you to filter a list to a more manageable size. <br />
<br />
These methods are '''Search''' and '''Filtering'''. <br />
<br />
A search will search the text displayed in list, whereas filters display people whose data match the criteria of the filter.<br />
<br />
Search is a simple but fast method of searching the columns displayed on the screen. When the [[Gramps_4.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|sidebar]] is '''not''' displayed, the {{man label|Search bar}} is displayed. Typing the characters into the {{man label|Search bar}} and clicking the {{man button|Find}} button will display only lines that match the text.<br />
<br />
Alternatively, you can enable a filter in either the [[Gramps_4.2_Wiki_Manual_-_Main_Window#Bottombar_and_Sidebar|bottombar or the sidebar]]. When the filter sidebar is displayed, the {{man label|Search bar}} is not displayed. The Filter allows you to interactively build a set of filter rules that can be applied to the display. The filter is applied based on the rules and the data, not on the screen display. Filters of the displayed category can also be constructed by clicking on the corresponding 'editor' button in the {{man menu|Edit}} menu.<br />
<br />
Further details of how filters work is given in the [[Gramps_4.2_Wiki_Manual_-_Filters|Filters Chapter]]<br />
<br />
{{-}}<br />
<br />
{{man tip| Searching vs. Filtering |Searching only searches for exact text matches. If the date displayed is "Jan 1, 2000", a search of "1/1/2000" will fail, but a filter of "1/1/2000" will match.}}<br />
<br />
When Gramps opens a database, no filtering is in effect. In People View, for example, all people in the database are listed by default.<br />
<br />
== Sorting columns ==<br />
<br />
[[Image:Sortpeoplecolumn-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sort Column]]<br />
<br />
Clicking once sorts in ascending order, clicking again sorts in descending order. The {{man label|Column Editor}} dialog can be used to add, remove and rearrange the displayed columns, or to change the default sorting of the view [though always ascending].<br />
<br />
{{-}}<br />
<br />
== When something goes wrong ==<br />
<br />
Sometimes something goes wrong, either because you have asked to do something that Gramps doesn't know how to do, or because something has happened that the developers of Gramps did not anticipate, or because there is a mistake in the coding of Gramps.<br />
<br />
This section explains what to do when something unexpected happens.<br />
<br />
{{man warn| Warning |Sometimes all the errors do not appear on the screen. If something unexpected happens, you may need to [[Gramps_4.2_Wiki_Manual_-_Main_Window#Seeing_all_the_error_messages|see all the error messages]]}}<br />
<br />
=== Alerts ===<br />
<br />
An alert is a dialog that appears when Gramps needs to give you an important message about an error condition or warn you about potentially hazardous situations or consequences.<br />
<br />
Most alerts are self explanatory, and the same type of alerts that you might get with any application. These are not discussed further here.<br />
<br />
However, some alerts require more complicated actions, so they are described below.<br />
----<br />
[[Image:Need_to_upgrade_alert.png|300px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dialogue showing DB Upgrade Required Error]]<br />
<br />
This dialogue appears if you try to open a Family Tree created with a previous version of Gramps with a newer version of Gramps. If you still have the older version of Gramps available, then you should:<br />
* cancel this dialogue,<br />
* open the Family Tree with the previous version of Gramps,<br />
* export your family tree in Gramps XML database export format or Gramps package export format (see [[Gramps_4.2_Wiki_Manual_-_Manage_Family_Trees#Export_into_Gramps_formats|Export into Gramps formats]]),<br />
* open the Family Tree in the new version of Gramps and click {{man button|Upgrade now}} in this dialogue<br />
{{-}}<br />
----<br />
[[Image:Cannot_open_database.png|300px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dialogue showing DB Environment Error]]<br />
<br />
As explained in the dialogue, the Family Tree was probably created with an old version of the Berkeley database program. This is not quite the same thing as an old version of the Gramps program, because the version of the Gramps program and the version of the Berkeley database are independent. However, the effect is somewhat the same. As suggested in the dialogue, if you have the old version of Gramps and its support software, then you should:<br />
* cancel this dialogue,<br />
* open the Family Tree with the previous version of Gramps,<br />
* export your family tree in Gramps XML database export format or Gramps package export format (see [[Gramps_4.2_Wiki_Manual_-_Manage_Family_Trees#Export_into_Gramps_formats|Export into Gramps formats]]),<br />
* start the new version of Gramps,<br />
* open the 'Manage Family Tree' dialogue,<br />
* click on {{man button|new}} and create a new Family Tree,<br />
* load the new Family Tree<br />
* Import the Gramps XML or Gramps package.<br />
<br />
Alternatively, it may be possible to use the recovery tools. See 'obtain the bsddb recovery tools' under [[Recover corrupted family tree]]<br />
{{-}}<br />
----<br />
[[Image:Low_level_database_corruption.png|300px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dialogue showing DB Error Dialogue]]<br />
<br />
This dialogue appears when a problem is detected with the underlying database that supports Family Trees.<br />
* close the dialogue,<br />
* click on the Family Tree Manager,<br />
* select the Family Tree you were trying to open,<br />
* the {{man button|Repair}} button should be available; click on it,<br />
* once the Family Tree has been repaired it should be possible to open it in the normal way.<br />
<br />
If this does not work, try 'obtain the bsddb recovery tools' under [[Recover corrupted family tree]]<br />
{{-}}<br />
----<br />
[[Image:DbDowngradeError.png|300px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dialogue showing DB Downgrade Error]]<br />
<br />
Carry out suggested action.<br />
{{-}}<br />
----<br />
[[Image:DbVersionError.png|300px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dialogue showing DB Version Error]]<br />
<br />
Carry out suggested action.<br />
{{-}}<br />
----<br />
[[Image:RunDatabaseRepair.png|300px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dialogue showing Run Database Repair]]<br />
<br />
Carry out suggested action.<br />
{{-}}<br />
<br />
=== Warnings ===<br />
<br />
If Gramps detects a minor error, or wishes to notify you about an occurrence within the program, then Gramps may display a warning button, as shown below. This button is only displayed for 180 seconds, so if you see it you should immediately click on it if you want to see the messages.<br />
<br />
[[Image:Warning_button.jpg|750px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps Main Window showing Warning button]]<br />
<br />
{{-}}<br />
<br />
If you click the warning button, then a dialogue box appears showing the last 20 messages received. [[Logging_system|More details]]<br />
[[Image:Warning_messages.jpg|750px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramps Main Window showing Warning messages]]<br />
{{-}}<br />
<br />
Some of the warnings that may appear are described below:<br />
<br />
==== Locale warnings ====<br />
<br />
Sometimes there is a problem with the language you have chosen. <br />
<br />
If you have installed Gramps using your platform's standard installation method (Package manager/AIO installer/Application package) and are using your platform's built-in mechanism (System Setting/Control Panel/System Preferences) to choose the language/sort order/formats you are running in, then these errors should not occur, and may mean there is a problem in Gramps.<br />
<br />
However, if you have set the language/sort order/formats manually by setting the 'environment' see [[Gramps_4.2_Wiki_Manual_-_Getting_started#Languages| languages]], particularly if you are running Gramps from the command line, then there may be a problem with what you have typed in. The message (only part of which is shown below) should help you to understand where the error is.<br />
<br />
* "Date parser for '%s' not available, using default"<br />
* "Date displayer for '%s' not available, using default"<br />
* "Family relationship translator not available for language '%s'. Using 'english' instead."<br />
* 'Unable to determine your Locale, using English'<br />
* "Localization library libintl not on %PATH%, localization will be incomplete"<br />
* "No translations for %s were found, setting localization to U.S. English"<br />
* "Unable to create collator: %s"<br />
* "No language provided, using US English"<br />
* "No usable languages found in list, using US English"<br />
* "None of the requested languages (%s) were available, using %s instead"<br />
<br />
==== Module not loaded warnings ====<br />
<br />
The Gramps application contains many different 'modules'. Some of these modules are required for Gramps to run at all; some are 'strongly recommend', and some are optional.<br />
<br />
If you have installed Gramps using your platform's standard installation method (Package manager/AIO installer/Application package) then the builder of that package will have decided which modules are present. He must include all the required modules, because otherwise Gramps will not run, but he can choose which of the recommended and optional packages he includes. Consult the documentation for your package (‘Ha Ha Only Kidding’) to determine which modules are included.<br />
<br />
If you try to do something that needs a module that is not included, then you will get a warning like the ones below (only the first part of the message is included). What you can do about it depends on your platform:<br />
<br />
'''Linux'''<br />
You should be able to install the package using your distribution's standard Package Manager or the GUI interface to the Package Manager. However, in some cases you will need to build the module from source.<br />
<br />
'''MS Windows and Mac OS X'''<br />
The MS Windows AIO installer and the Max OS X Application bundle come with certain modules built in. It is not possible for the normal user to add further modules. Therefore, if you find a module that you particularly feel should be included you should post on the Gramps [[Contact#Mailing_lists|mailing list]] (probably the devel list) explaining why you feel its omission is a mistake.<br />
<br />
* "WARNING: PIL module not loaded. "<br />
* "ICU not loaded because %s. Localization will be impaired. "<br />
* "OsmGpsMap module not loaded. "<br />
* "GExiv2 module not loaded. "<br />
* "Webkit module not loaded. "<br />
* "PIL (Python Imaging Library) not loaded. "<br />
* "GtkSpell not loaded. "<br />
<br />
==== Configuration warnings ====<br />
<br />
Sometimes it is worth just deleting the old configuration files. TBD instructions on how to do this.<br />
<br />
* "Importing old key file 'keys.ini'..."<br />
* "Done importing old key file 'keys.ini'"<br />
* "Can't find filter %s in the defined custom filters" <br />
* "Number of arguments does not match number of " +<br />
* "Value '%(val)s' not found for option '%(opt)s'"<br />
* "Unable to open recent file %s because %s",<br />
* "WARNING: ignoring old key '%s'"<br />
* "WARNING: ignoring key with wrong type "<br />
* "Failed to parse doc options"<br />
* "Skipped a line in the addon listing: " <br />
* "Failed to load gramplets from %s because %s"<br />
<br />
<br />
====Other warnings ====<br />
<br />
TBD<br />
<br />
=== Errors ===<br />
<br />
More serious problems cause an error dialogue to appear which will describe the actions you should take. tbd. give example of the program error dialogue. Also explain what to do if Gramps suddenly quits, or if Gramps just won't start.<br />
<br />
[[Image:Unexpected_error.png|300px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dialogue showing Unexpected error]]<br />
<br />
This dialogue appears whenever something has happened in the Gramps application that the programmers did not expect.<br />
<br />
Have a look at [[How to create a good bug report]]. If you think you know how the Gramps developers might reproduce the bug, then by all means click on the 'Report' button. This will take you to the 'Report a bug' dialogue, and you can then follow the instructions.<br />
<br />
[[Image:Report_a_bug.png|800px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dialogue showing reporting wizard]]<br />
<br />
<br />
{{-}}<br />
==== Seeing all the error messages ====<br />
Sometimes, not all the information needed to understand what has gone wrong will appear on the screen. For example, if you start Gramps with an invalid language setting (and some missing components) then the message that appears in the Warning dialogue is:<br />
<br />
[[Image:Warning_message_GExiv2.png|800px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dialogue showing limited warnings]]<br />
{{-}}<br />
However, the full set of warning messages is:<br />
(process:10929): Gtk-WARNING **: Locale not supported by C library.<br />
Using the fallback 'C' locale.<br />
2013-03-13 18:49:04.376: WARNING: __init__.py: line 69: Date parser for 'xx_XX.UTF-8' not available, using default<br />
2013-03-13 18:49:04.547: WARNING: __init__.py: line 85: Date displayer for 'xx_XX.UTF-8' not available, using default<br />
2013-03-13 18:49:05.949: WARNING: spell.py: line 74: Spelling checker is not installed<br />
2013-03-13 18:49:14.223: WARNING: gramplet.gpr.py: line 400: WARNING: GExiv2 module not loaded. Image metadata functionality will not be available.<br />
<br />
Sometimes Gramps just doesn't start and nothing appears on the screen, or Gramps suddenly quits so you don't see anything on the screen. In all these cases you may need to do something special to see all the errors.<br />
<br />
===== Linux =====<br />
<br />
You can start Gramps from the Command Line, as described in the note [[Gramps_4.2_Wiki_Manual_-_Getting_started#Linux| here]]. You will then see all the diagnostic information on the terminal.<br />
<br />
===== MS Windows =====<br />
<br />
{{man warn|tbd}}<br />
<br />
===== Mac OS X =====<br />
<br />
You can look at log messages from Gramps using the Console application. Console application is located in your Mac's Utilities folder, which is found in the Applications folder. (A shortcut on recent versions of Mac OS X is to press Command and the space bar to start a Spotlight search. In the resulting pop up window, enter the first few characters of the word "Console" and then select the Console application.)<br />
<br />
For example, one of the early alpha releases of Gramps 4.2.0 just would not start and displayed nothing on the screen. However by opening the Console application, and typing Gramps in the filter at the top right hand corner some diagnostic information appeared. (Actually we typed "gramps[" because there were some other messages that were not relevant, but it wouldn't matter if they were included as well).<br />
[[Image:Console_output.png|1000px|thumb|left|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Console output]]<br />
{{-}}<br />
By shift clicking to select all the relevant messages and copying them we get:<br />
01/03/2013 00:08:02 [0x0-0x88088].org.gramps-project.gramps[1867] 2939: ERROR: importer.py: line 51: Could not find any typelib for Gtk <br />
01/03/2013 00:08:05 [0x0-0x88088].org.gramps-project.gramps[1867] Gtk typelib not installed. Install Gnome Introspection, and pygobject version 3.3.2 or later. <br />
01/03/2013 00:08:05 [0x0-0x88088].org.gramps-project.gramps[1867] Gramps will terminate now. <br />
<br />
In this particular case, this was enough to help the developer discover the problem.<br />
{{-}}<br />
<br />
{{man index|Gramps 4.2 Wiki Manual - Getting Started|Gramps 4.2 Wiki Manual - Categories|4.2}}<br />
<br />
{{languages|Gramps 4.2 Wiki Manual - Main Window}}<br />
<br />
[[Category:Documentation]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Template:Version_MacPort&diff=48407Template:Version MacPort2014-02-20T13:38:38Z<p>Pvr4me: Updated recently</p>
<hr />
<div>3.4.7</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Template:Version_MacPort&diff=46027Template:Version MacPort2013-05-24T11:23:13Z<p>Pvr4me: </p>
<hr />
<div>3.4.5</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Template:Version_MacPort&diff=45089Template:Version MacPort2013-03-25T23:18:58Z<p>Pvr4me: Updated to 3.4.2 today</p>
<hr />
<div>3.4.3<br />
<br />
[[Category:Developers/Packaging|M]]<br />
<noinclude>[[Category:Versions|T]]</noinclude><br />
<noinclude>[[Category:templates|M]]</noinclude></div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=User:Pvr4me&diff=44592User:Pvr4me2013-02-19T19:36:11Z<p>Pvr4me: Info about me</p>
<hr />
<div>Researching: Treleaven, Franks, Johnstone, Fowler, Caird, MacLean, MacKay, Crich<br />
<br />
Using MacPorts version of Gramps on OS X 10.6.8. Maintainer of MythTV ports on MacPorts.</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Mac_OS_X:Build_from_source:MacPorts&diff=44591Mac OS X:Build from source:MacPorts2013-02-19T19:30:19Z<p>Pvr4me: MacPorts version</p>
<hr />
<div>{{languages}}<br />
==Installing Gramps using MacPorts==<br />
<br />
Current version available from MacPorts is: {{version_MacPort}}<br />
<br />
# Download and install the latest Xcode tools from http://developer.apple.com/technology/Xcode.html <br />
# Download and install Macports from http://www.macports.org/install.php<br />
# Open Terminal.app from /Applications/Utilities and enter these commands:<br />
sudo port selfupdate<br />
sudo port install gramps<br />
<br />
If you are running a recent version of OS X (Snow Leopard, Lion or Mountain Lion, at this point), much of the support software is pre-compiled and will install as quickly as it is downloaded.<br />
<br />
==Running Gramps==<br />
<br />
Use Terminal to start gramps: <br />
gramps<br />
<br />
==GraphViz==<br />
<br />
You may wish to install GraphViz to handle some of the graphical reports that Gramps can produce. MacPorts can provide you with either graphical or command-line based versions of either a 'stable' or 'development' release of GraphViz. 'graphviz-gui' is recommended unless you know that you have a need for the development version. Install with:<br />
<br />
sudo port install graphviz-gui<br />
<br />
==Issues==<br />
<br />
You can search the MacPorts bug tracker for any issues related to the Gramps port:<br />
<br />
https://trac.macports.org/search?portsummarysearch=on<br />
<br />
Please don't hesitate to create a ticket if you find a problem that you believe is related to the MacPorts build process.<br />
<br />
<br />
[[Category:Developers/Packaging]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Talk:Mac_OS_X:Build_from_source:MacPorts&diff=44590Talk:Mac OS X:Build from source:MacPorts2013-02-19T19:23:37Z<p>Pvr4me: Easier, indeed</p>
<hr />
<div>==It's gotten easier==<br />
Updated the main page, WCT Feb 2013. Info was completely out of date and misleading. Next step should be to delete most of THIS page.<br />
<br />
I think this page may change drastically as MacPorts corrects its bugs. I've finally gotten GRAMPS installed from MacPorts on OSX 10.4.11 and it was a lot easier than in the article. I don't know whether I should replace this article, or just put in a new dated section.<br />
Here were my steps; they will need to be elaborated for a wider audience.<br />
<br />
1. Started with a clean MacPorts install (that is, I completely deleted /opt/local). It might suffice to update everything instead, but I wanted to be safe. If you're already using MacPorts then you might want to try updating all out-of-date packages first.<br />
<br />
2. "sudo port install gtk2" (It might not be necessary to do this first, but it's what I did and it worked.)<br />
<br />
3. "port activate -f python25" because the previous command stopped in the middle of the process, saying that it couldn't install python25. <br />
<br />
4. "sudo port install gtk2" again to finish installing gtk2.<br />
<br />
5. "sudo port install gramps" which finished without a hitch.<br />
<br />
6. Type "launchctl load /Library/LaunchAgents/org.freedesktop.dbus-session.plist" into the terminal. This is necessary for the package dbus to work, and it actually tells you to do it back in the many pages of output from the installation, but of course you probably weren't watching the installation. :) Make sure that you DON'T put sudo in front of this.<br />
<br />
7. Run GRAMPS from X11/<br />
<br />
--[[User:Lihtox|Lihtox]] 18:57, 4 February 2009 (UTC)<br />
<br />
== I wish I'd read this page! ==<br />
<br />
I installed gramps 3.0.4.1 on a brand new iMac with OSX 10.5.6 on 14 March 2009 by reading the article at this page without ever reading the discussion. Life would have been a lot easier if I'd read the discussion page first!<br />
<br />
I'm not brave enough, just like the last user, to edit the article to remove the hints directly. I will edit the article to add some other things I had to do, though. [[User:Emrys|Emrys]] 12:31, 19 March 2009 (UTC)<br />
<br />
== Old stuff removed from article ==<br />
<br />
Copied here in case it's useful to anyone, but I think it probably belongs on a mailing list or somebody's blog rather than a how-to article.<br />
<br />
--[[User:Richardsmith|Richardsmith]] 06:45, 29 July 2009 (UTC)<br />
<br />
==== This is what used to happen ====<br />
<br />
So, assuming you have MacPorts installed and updated, you might as well try:<br />
<code><br />
sudo port install gramps</code><br />
Now, if you're like me and didn't have GNOME or anything like that installed, calling that command will attempt to go through all of the dependencies and install them all. This will take a while, and you might be at this installing gramps for a couple hours (there are a lot of dependencies)<br />
<br />
What I did instead was run <code><br />
port deps gramps</code>, which listed the major dependencies that gramps has. Then, I installed each separately. They are:<br />
<code><br />
shared-mime-info<br />
py-gnome<br />
py-bsddb</code><br />
I installed them in the following order:<br />
# shared-mime-info<br />
# py-bsddb<br />
# py-gnome (the tough one)<br />
<br />
=== shared-mime-info ===<br />
In order to successfully install this, I first had to run:<code><br />
sudo port install p5-xml-sax<br />
sudo port install p5-xml-sax-expat</code><br />
After that, things installed smoothly<br />
<br />
=== py-bsddb === <br />
This actually installed smoothly on my computer. <br />
<br />
=== py-gnome ===<br />
For now, I merely list the libraries and what I did to fix the problem.<br />
# py-gtk2<br />
#* I had to make sure to upgrade expat. After that, it installed fine.<br />
#* ''I had a real difficulty getting this to fully install. It kept choking on Cairo. After updating XTools to 2.5, Cairo installed without a problem.'' --[[User:A.southern.yankee|A.southern.yankee]] 23:46, 1 May 2008 (EDT)<br />
# py-orbit<br />
#* This installed without any problems for me. <br />
# libzvt<br />
#* This package needs "dbus" which in turn needs "xmlto". It appears, however, that "xmlto" is not listed as a dependent of "dbus". Hence, I ran <code>sudo port install xmlto</code> by hand. This installed without any problems on my computer. <br />
#* After installing that, and upgrading gtk2 (do this first), this seems to be installing correctly. <br />
# gnome-desktop<br />
#* This was the next problem for me. I installed ''p5-libxml-perl, p5-xml-simple, py-xml'' by hand, cleaned ''gnome-desktop'', and then tried the installation again. Worked fine!<br />
# gstreamer<br />
#* This was the next problem for me. I installed ''p5-xml-libxslt, py-libxslt by hand'', cleaned gstreamer, and then tried the installation again. Worked fine!<br />
#liboil<br />
#* First, I ran <code>sudo port upgrade gtk-doc</code><br />
#* Then, I installed the newest version of the liboil library from [http://liboil.freedesktop.org/download/] and then tried to make the liboil library again. (From the manual download). This worked. I would assume it would work for the port version as well. <br />
# nautilus<br />
#* This was the last problem for me. To get around the error, I had to create a soft link for the ''libintl.3.dylib'' file in my /opt/local/lib/ directory.<br />
<br />
==== And this is another error message that happened in March 2009 ====<br />
<br />
When I did<br />
sudo port install gnome-desktop<br />
I saw<br />
Error: Target org.macports.activate returned: Image error: /opt/local/bin/nosetests<br />
is being used by the active py-nose port. Please deactivate this port first, <br />
or use the -f flag to force the activation.<br />
Error: The following dependencies failed to build: py25-gnome py25-gtk py25-cairo <br />
py25-numpy py25-nose py25-gobject py25-orbit startup-notification xorg-libsm xorg-libice<br />
Error: Status 1 encountered during processing.<br />
<br />
and I have no idea what it means or what deactivating a port implies. I typed<br />
sudo port -f install gnome-desktop<br />
and got<br />
Registry error: py25-nose @0.10.4_0 already registered as installed. <br />
Please uninstall it first.<br />
so I typed<br />
sudo port uninstall py25-nose<br />
sudo port -f install gnome-desktop<br />
and that seemed to work. Goodness knows what chaos I caused!<br />
<br />
=== Finishing ===<br />
As well as OpenOffice, [http://www.graphviz.org/ Graphviz] is needed to view reports. You have to download and install this separately from gramps but it's a simple click-to-install procedure. Once it's installed, the graphviz application appears in finder - applications, and running that gives a menu bar that allows the report.dot file to be opened and displayed. The command line version of graphviz, dot, documented at the graphviz website, works too.<br />
<br />
=== Conclusion ===<br />
It seems that the missing packages that one may trip over when installing via MacPorts vary depending on just who has last modified all the installation scripts. There may be some; it's easy to fix by guesswork; it's odd that the computer doesn't just go ahead and fix them by itself because it sure does everything else! In fact the whole process of installing xCode and MacPorts and then gramps is an astonishing ''tour de force'' and a tribute to the good architecture of the Linux and unix software development system. But it is scary!<br />
<br />
== Glitches ==<br />
<br />
There are some problems. An update of Mac OS X on about 15 May 2009 changed gramps's behaviour in several ways, too. Presumably, these changes are the results of fixing bugs in the Apple X11 implementation. After 15 May 2009, this was "XQuartz 2.1.6 (xorg-server 1.4.2-apple33)", running on Mac OS X 10.5.7; this program annoyingly broke copy-and-paste. Now, on 9 Jun 2009, without any action on my part, my iMac changed to "XQuartz 2.3.3.2 (xorg-server 1.4.2-apple42)". That added more tabs to the X11 preferences screen. The new "X11 - Preferences - Pasteboard" screen selects various functionality in the convoluted copy-and-paste system used for running X11 linux applications on Mac OS. I ticked all boxes on that screen ''except'' "Update Pasteboard immediately when new text is selected" and copy and paste worked again between Gramps and other Mac applications.<br />
<br />
* Following the 15 May 2009 update, the font used in the gramps window is too large and too bold for convenience.<br />
* Gramps on Mac uses ctrl-x, ctrl-c, ctrl-v for cut, copy, paste. The standard for mac programs, including X11 programs, is cmd-x, cmd-c, cmd-v. To make paste work between other mac programs and gramps, set the X11 pasteboard preferences as described above<br />
* Before 15 May 2009, Some text pasted in - notably the contents of a cell from an Openoffice spreadsheet, but possibly other as well - had an <LF> character at the end, unexpectedly. After 9 Jun 2009, pasting text from openoffice to gramps works fine, with no spurious <LF>, but it's no longer possible to <copy> an openoffice spreadsheet cell and <paste> it direct into gramps. Instead, you have to first <copy> the cell in openoffice, then use openoffice - edit - paste-special - to paste the text (not the formula) into another openoffice cell. Then click on that cell and the text pops up in the openoffice edit box. Select that text and you can <copy> it in openoffice. Then <paste> it in Gramps, and that works. (Pity, pasting the cell used to work, except for the LF!) <br />
* Double clicking an image in the media reference editor doen't bring up an external viewer to show the picture full size. In fact, there seems to be no way to do this from within gramps on Mac.<br />
* Switching to another user, using the OS X fast user switching feature, gramps can mess up the display on returning to the original user. The cure is to quit gramps and restart it.<br />
* It is not possible to start Gramps by double clicking on a Mac OS icon, nor by double clicking on a Gramps database that is associated with the application. (It should be possible to create an installation that allows this, just as it is available for OpenOffice).<br />
* The PdfDoc.py plugin cannot be installed because ReportLab is not installed.<br />
** Note, using macports, run <code> sudo port install py-reportlab </code>. This will take care of this problem. <br />
** For fink, run <code>fink install reportlab-py25</code> (py24 or py23, for earlier versions of python).<br />
* The LPRDoc.py plugin cannot be loaded because the python bindings for GNOME print are not installed.<br />
* Spell checking does not work (on starting Gramps, an error warning "Spelling checker is not installed" appears on the xterm). The python "bindings for [GNOME print and spell checking] are probably in fink's gnome-python2-desktop-py24 and gnome-python2-extras-py24 packages. Or would be, if fink had them at all, which we don't. They are only viable for for newer versions of gnome itself than fink presently has, or have other dependencies that are not yet satisfiable within fink. We're working on it".<br />
* All ODF (ODT) output failed with a "Could not create file" error on an Gramps installed via Macports as described above, on a 'virgin' Mac. Benny Malengier forwarded the suggestion from guylinton that <code>zlib</code> should be installed: with <code> sudo port install py25-zlib </code> all ODT output jumped into action.<br />
<br />
In the past the following have been noted on Mac systems, but they worked fine when I tried them:<br />
<br />
* Help does not work (clicking Help or FAQ etc on the Help menu does nothing).<br />
* 'Enter' or 'return' does not act as OK for closing windows (the button has to be pressed with the mouse). However Esc does work to exit from the window.<br />
* The browser and email links under the help menu do nothing.<br />
* Before the 15 May 2009 update: Little popup yellow help notices notices which are supposed to appear when you hover over a button do appear, but do so even when the gramps window isn't in focus and there's a window from another application covering it up. After the 15 May 2009 update, this seems to be fixed, and popup notices only appear when the gramps window is in focus.</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Mac_OS_X:Build_from_source:MacPorts&diff=44589Mac OS X:Build from source:MacPorts2013-02-19T19:19:32Z<p>Pvr4me: Remove ancient instructions/problems, mention GraphViz install</p>
<hr />
<div>{{languages}}<br />
==Installing Gramps using MacPorts==<br />
# Download and install the latest Xcode tools from http://developer.apple.com/technology/Xcode.html <br />
# Download and install Macports from http://www.macports.org/install.php<br />
# Open Terminal.app from /Applications/Utilities and enter these commands:<br />
sudo port selfupdate<br />
sudo port install gramps<br />
<br />
If you are running a recent version of OS X (Snow Leopard, Lion or Mountain Lion, at this point), much of the support software is pre-compiled and will install as quickly as it is downloaded. <br />
<br />
==Running Gramps==<br />
<br />
Use Terminal to start gramps: <br />
gramps<br />
<br />
==GraphViz==<br />
<br />
You may wish to install GraphViz to handle some of the graphical reports that Gramps can produce. MacPorts can provide you with either graphical or command-line based versions of either a 'stable' or 'development' release of GraphViz. 'graphviz-gui' is recommended unless you know that you have a need for the development version. Install with:<br />
<br />
sudo port install graphviz-gui<br />
<br />
==Issues==<br />
<br />
You can search the MacPorts bug tracker for any issues related to the Gramps port:<br />
<br />
https://trac.macports.org/search?portsummarysearch=on<br />
<br />
Please don't hesitate to create a ticket if you find a problem that you believe is related to the MacPorts build process.<br />
<br />
<br />
[[Category:Developers/Packaging]]</div>Pvr4mehttps://blog.gramps-project.org/wiki/index.php?title=Template:Version_MacPort&diff=44586Template:Version MacPort2013-02-19T18:45:08Z<p>Pvr4me: </p>
<hr />
<div>3.4.2<br />
<br />
[[Category:Developers/Packaging|M]]<br />
<noinclude>[[Category:Versions|T]]</noinclude><br />
<noinclude>[[Category:templates|M]]</noinclude></div>Pvr4me