The This page describes the installation of the ready-to-run Gramps application for Mac OS X. This is also known as the GTK-OSX port of GRAMPS Gramps for Mac . It is a single, stand-alone bundle which uses the native quartz windowing system of Mac OS X instead of X11.

=== OSX '''MacOS versions''' Gramps 5.0 requires Mac OS X 10.9 (Mavericks) and later. Gramps 5.1 requires at least Mac OS X 10.10(Yosemite).7 Lion ===

'''Back up your databases:''' If you're using Time Machine, that's already taken care of. (You do test your Time Machine backups periodically, right?) But it doesn't hurt to have a spare copy set aside before starting up a new version. If you've been using the Gtk-OSX build, version 3.2.4 or later, just copy Library/Application Support/gramps/grampsdb. (Right click/option click and select "Make a copy" from the menu. It will be named grampsdb(2). '''New Version Notice:''' If you are upgrading from the pre-built Gramps Application version 3.2.3or earlier (or a build from source version) and you want to keep your old database and settings, you'll need to create a Library/Application Support/gramps folder with your existing data in it. Unless you've changed the location in Preferences, the data is in a hidden folder in your home directory called ".gramps". Select a Finder window and select Go>Go to Folder from the menu. Type "/Users/yourname/.1 runs correctly gramps" in the dialog box that opens up, and click on Lion"Go". (Yes, subsitute your userid for "yourname".) The hidden folder will appear, highlighted and open. Earlier versions do Option-drag the whole thing to Library/Application Support (the one in your home folder, notthe one in your boot drive's "root" directory). Slow-double-click on the new copy so that you can edit the name and delete the '.' at the beginning to unhide it. == Installing Gramps == From the '''[[Download#Mac_OS_X]]''' page download the dmg. Once it's downloaded, you can open the file (just double click on it in Finder if your browser doesn't open it automatically) and drag the Gramps application wherever you like. Once installed on your computer, except for it opens like any other application. '''Links with other programs:''' Double clicking an image in the media reference editor should bring up Apple Preview (or a special beta package provided whatever program you've set as the default to edit that kind of image) to view the image. Clicking the view button in an interim measureinternet reference should bring up the URL in the default browser. All Lion users Clicking the Google Maps button in the Places display should upgrade bring up the map in the browser. Gramps doesn't use the X11 Mac package. It's useful to 3install [http://www.documentfoundation.org/download/ LibreOffice], [http://www.calligra-suite.org/ Calligra] (or [http://www.3neooffice.1 as soon as pracicalorg/ NeoOffice], a more mac-friendly version) to work on your reports after saving them from Gramps.

== How to Download and run the binary GRAMPS application for Mac What goes where ==

'''File structure:''' GRAMPS Gramps database and settings files can be found at the following places in the Mac file system (GRAMPS Gramps Version 3.2.5 and later):<br>* The GRAMPS Gramps database with the user's genealogical information is stored under /Users/<username>/Library/Application Support/gramps/grampsdb.<br>

* Start-up settings for GRAMPS Gramps (for e. g. the environment variable LANG) can be accessed through Gramps.app (generally in /Applications): Right click on "Gramps.app", select "Show Package Content" from the menu, the start-up settings are found in the file Contents/MacOS/Gramps.

'''Back up your databases:''' If you're using Time MachineGramps has the appropriate translation, calendar, etc. it will honor the settings in System Preferences>Language and Region provided that's already taken care ofthe combination results in a locale that exists in /usr/share/locale. (You do test your Time Machine backups periodically, right?) But It will always fall back to English if it doesncan't hurt to have a spare copy set aside before starting up a new versionfigure out your Language & Region settings. If you've been using the Gtk-OSX buildSome examples: French and France, Belgium, version 3.2.4 or laterCanada work fine, just copy Library/Application Support/gramps/grampsdbas do German and Germany or Switzerland and Dutch and Netherlands or Belgium. (Right click/option click German and France doesn't work, nor does Dutch and select "Make a copy" from the menu. It will be named grampsdb(2)Switzerland.

'''New Version Notice:''' The new (3.2.4 and later) builds will default to using your Library/Application Support/gramps folder, which, if If you want to keep run Gramps with different locale settings than you use for your old database and system settings, you'll need to create. Unless you've changed can use the location in Preferences, they're in a hidden folder in your home directory called ".grampsdefaults". Select a Finder window and select Go>Go to Folder program from the menu. Type "/Users/yourname/.gramps" in the dialog box that opens up, and click on "Go"Terminal. app (Yes, subsitute your userid for "yourname"Applications:Utilities:Terminal.app) The hidden folder will appear, highlighted and open. Option: defaults write -drag the whole thing app Gramps AppleLocale "de_DE"to set Gramps to Library/Application Support (the one operate in your home folder, not the one in your boot drive's "root" directory). Slow-double-click on the new copy so that you can edit the name German with German calendar and delete the '.' at the beginning to unhide itformatting.

'''LanguageTo read the setting use: defaults read -app Grampsthis gave "Can''' Normally, GRAMPS sets up languages and formats from system preferences (Language and Text on Snow Leopard and Liont determine domain name for application Gramps; Internationalization on Leopard). There are three main settings: On the first pane (Languages) is a list of languages. GRAMPS will go down the list and select the first one for which it has a translation to select the language in which all menus, labels, and messages are presented. On the right side of that pane at the bottom is an defaults unchanged"Order for Sorted Lists" listbox which sets the way that lists are alphabetically sortedme; if you have problems you can use defaults read org. Finally, in the third pane (Formats) one can select a country which determines things like month and day names, whether a comma, dot, or space is used to separate thousands or decimal fractions, and so ongramps-project.gramps

If you want to run GRAMPS with different language or locale The settings than you use for your system settings, you can use the "defaults" program from Terminal.app (Applications:Utilities:Terminalare stored in ~/Library/Preferences/org.app): defaults write -app Gramps AppleLanguages "(de, en)" defaults write gramps-app Gramps AppleLocale "de_DE" defaults write -app Gramps AppleCollationOrder "de"AppleLanguages corresponds to the language list, AppleLocale to the Format country, and AppleCollationOrder selects the way that lists are sortedproject. You need not set them allgramps.plist

[[Howto:Change the language of reports]] has more information on language features in Gramps. When reading it, remember that AppleLanugages AppleLanguages (which corresponds to the language list on the Languages & Text system preference pane) sets the LANGUAGE environment variable and AppleLocale (Formats in the Languages & Test pane) sets the LANG variable.

'''Links with other programs=== Dictionaries === The spelling checker uses MySpell dictionaries -- the same ones that [http:''' Double clicking an image //www.documentfoundation.org/download/ LibreOffice] and NeoOffice use. Unfortunately, they bury them in the media reference editor should bring up Apple Previewtheir application bundles, or a similar programso you can download them [http://archive.services.openoffice.org/pub/mirror/OpenOffice.org/contrib/dictionaries/ here]. You need to install them in /Library/Dictionaries, and you'll need to view the imageauthenticate as an administrator to do so. Clicking If you have one of them installed and know how to make symbolic links from the view button command line, you'll find them in an internet reference should bring up the URL Contents/share/uno_packages/cache/uno_packages, scattered about in the default browserhash-named directories. Clicking You'll need to link both the Google Maps button in the Places display should bring up the map in the browseraff and dic files (e.g., en_US.aff and en_US.dic).

GRAMPS doesn't use the X11 Mac package. It's useful to install [http://www.documentfoundation.org/download/ LibreOffice], [http://www.calligra-suite.org/ Calligra] (or [http://www.neooffice.org/ NeoOffice], a more mac-friendly version) to work on your reports after saving them from Gramps. '''Dictionaries:''' The spelling checker uses MySpell dictionaries -- the same ones that [http://www.documentfoundation.org/download/ LibreOffice] and NeoOffice use. Unfortunately, they bury them in their application bundles, so you can download them [http://wiki.services.openoffice.org/wiki/Dictionaries here]. You need to install them in /Library/Dictionaries, and you'll need to authenticate as an administrator to do so. If you have one of them installed and know how to make symbolic links from the command line, you'll find them in Contents/share/uno_packages/cache/uno_packages, scattered about in the hash-named directories. You'll need to link both the aff and dic files (e.g., en_US.aff and en_US.dic).== Bugs ==

==Bugs== All of the known bugs in 3.1.2 previous version have been corrected in 3.2.4 Gramps {{Version_Mac}} and later. There will no doubt be new ones; report them in the usual way on [http://www.gramps-project.org/bugs/my_view_page.php Mantis] ([[Using the bug tracker]] instructions). When reporting what you're sure is an OSX specific bug, please set the Platform field to "mac" (no quotes, caps, or spaces!) so that I can find it easily. The 3.1.2 bugs are described at [[Mac gtk-osx port bugs]].