132
edits
Changes
→MacPorts: No hypen shown on "Third-party Addons" page stick to one spelling.
{{languages|Download}}'''Research, organize and share your family tree with Installing Gramps.''' {{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2023-06-29'''}}|For a list of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]for macOS computers}}
{{man warn|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>]].}}
[[File:macos_200x200.png|128px248px|left|link=Download#Mac_OS_X]]Before downloading read the [[Mac OS X:Application package|before installation]] instructions.<big>* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u>* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}right]</u></big>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.{{-}}<hr /> 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 />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor-->
== macOS Application package ==
</span>
The [[FileMac_OS_X:macos_200x200.png|128px|leftApplication_package|link=Download#Mac_OS_Xapplication package]] is the recommended way of installing Gramps on macOS.
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 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''
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.)
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.
{{-}} === Alternative independent installation Adding additional Spell Checking languages on macOS ==={{man tip|[[FileMac_OS_X:Gramps-release.pngApplication_package#Dictionaries|leftSpell Checking:]]Alternatively|Gramps uses a different spell checker than the one provided by Mac OS X, Gramps with different spelling dictionary requirements. We can also be built '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 on macOS using MacPortsif you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}
{{-}}
MacPorts is a package manager for Apple Mac.
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]
Why use the version from MacPorts? Certain plugins or add-ons addons 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.
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons addons have been installed that require such additional software.
{{-}}
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.
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux).
See https://github.com/homebrew/
{{-}}
== Notes ==
<span id="1">Backup to '''Gramps XML''' format when updating. ''Although Gramps reads and writes '''GEDCOM 5.5.1''' format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML format.</span>
[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]
You will find a [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup...}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps versions. Alternately, use [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|Export...}}]] in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.
== See also ==
===Installing Gramps for Desktops===
===Installing GitHub Gramps Web for online collaborationDesktops Releases===* Docker GitHub Releases <!--github_url template = https://github.com/gramps-project/gramps -->
:* [{{github_url}}/releases/v{{version}} {{version}} version]
:* [{{github_url}}/releases/ Archive of Gramps releases]
* [[Previous releases of Gramps]]
* [[:Category:Versions|Versions on various platforms]]
===Installing Gramps Web for online collaboration===
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps
* [https://www.grampsweb.org/Deployment/ Docker]
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]
[[Category:Documentation]]