Troubleshoot Gramps on Mac M1?

Hi, I’ve just started using Gramps having downloaded onto my M1 MBP. However it seems to be a bit glitchy… occasional black screens, and I seem to have to click buttons twice to get them to work. Mouse will not work in drop down menus…
Is there a specific version of the software for M1 Macs? - couldn’t see anything on the download site so downloaded the intel version… Apologies if I’ve missed something obvious…N

Hi Neil,

Let’s start by with a rundown of your software configuration. Could you install the Prerequisites Checker Add-on gramplet and post a copy’n’paste of the readout?

Gramps is written in Python with absolutely no assembly anywhere. Consequently, it should work on any platform where Python is installed. But, in order not to reinvent the wheel, it uses many “external” libraries like gtk+, cairo, pango, … You can have the list of these libraries by running the following command in a terminal

gramps -v

If some are missing, you must install them.

1 Like

MacIona:~ Iona$ gramps -v

-bash: gramps: command not found

MacIona:~ Iona$ gramps-v

-bash: gramps-v: command not found

MacIona:~ Iona$ gramps -v

-bash: gramps: command not found

MacIona:~ Iona$

thanks for responding -
Diagnostic Gramplet to help evaluate if Gramps has all prerequisites installed.

You have Gramps 5.1.5 installed; an unreleased development version. Thank you for contributing and testing; please report any issues. Backups are your friend.

The following packages MUST be installed (Requires the minimum version or greater.):

  • Python 3.9.2 (Passed: version 3.3.0 or greater installed.)
  • GTK+ 3.24.30 (Passed: version 3.12.0 or greater installed.)
  • PyGObject 3.40.1 (Passed: version 3.12.0 or greater installed.)
  • Cairo 1.16.0 (Passed: version 1.13.1 or greater installed.)
  • Pycairo 1.20.0 (Passed: version 1.13.3 or greater installed.)
  • Pango 1.50.3 (Passed: version 1.29.3 or greater installed.)
  • PangoCairo 1.0
  • Berkeley Database library (bsddb3: 4.8.30) (Python-bsddb3 : 6.2.9)
  • SQLite Database library (sqlite3: 3.39.4) (Python-sqlite3: 2.6.0)
  • xdg-utils (Manual check see instructions link)
  • librsvg2 (Manual check see instructions link)
  • language-pack-gnome-xx (Manual check see instructions link) for your Language

The following packages are STRONGLY RECOMMENDED to be installed (needed for geography and charts):

  • osmgpsmap 1.0 (Passed: version 1.0 or greater installed.)
  • Graphviz 2.47
  • PyICU 2.7.2(ICU 68.2)
  • Ghostscript Ghostscript not in system PATH
  • python-fontconfig 0.5.0 (Passed: version 0.5.x is installed.)

The following packages are optional:
Gtkspell enables spell checking in the notes.

  • GtkSpell 3.0 (Passed: version 3.0 or greater installed.) (enchant module: not found)
  • rcs installed TBD (Requires version 5.9.4 or greater installed. If not on Microsoft Windows)
    Python Image Library (PIL) is needed for cropping images and LaTeX output.
  • (PILLOW 8.2.0)
  • GExiv2 : 0.10 (Exiv2 library : not found)
  • geocodeglib 1.0 (Passed: version 1.0 or greater installed.)
    For addon Networkchart, font White Rabbit provides an extremely readable result.
  • Installed font: not found

Development & Translation Requirements
The following packages should be installed if you intend to translate or do any development (addons etc):

  • gettext (msgfmt): not found
  • intltool-update: not found
    Sphinx is a tool that builds the Gramps development documentation and man pages
  • Sphinx: not found

Optional packages required by Third-party Addons
Prerequistes required for the following Third-party Addons to work:

  1. Addon:Family Sheet : (PILLOW 8.2.0)
  2. Addon:Graph View : (GooCanvas:2.0)(PyGoocanvas: TBD?)(Graphviz 2.47)
  3. Addon:PedigreeChart : (NumPy : not found )
  4. Addon:Network Chart : (networkx not installed)(Graphviz 2.47)
    and one of either: (pydotplus: not installed) or (pygraphviz: not installed)
  5. Addon:GenealogyTree : (lualatex :not found)(PILLOW 8.2.0)
  6. Addon:HTMLView : (Webkit: not installed )
  7. Addon:GoogleMapKML : (Google Earth on Desktop : not found.)
  8. Addon:Webconnect Pack : (libwebconnect : Installed)(Passed)
  9. Addon:TMG Importer : (DBF not found.)(Requires version 0.96.8 or greater installed.)
  10. Addon:PostgreSQL Database library Support : (PostgreSQL not found.)(psycopg2 : not found.)
  11. Addon:Edit Image Exif Metadata : (PILLOW 8.2.0) GExiv2 : 0.10 (Exiv2 library : not found)
  12. Addon:Photo Tagging Gramplet : (NumPy: not found.)(OpenCV facedetection: not found.)
  13. Addon:Lxml Gramplet : (lxml: not found. Requires version 3.3.3 or greater installed.)
  14. Addon:MongoDB : * Requires: MongoDB TBD / pymongo TBD

Diagnostic checks
Check for potential issues.

Environment settings:

  • Operating System: darwin
    kernel: 22.1.0

Locale Settings:

  • LANG: en_GB.UTF-8
  • LC_MESSAGES: not set
  • LC_TIME: not set

Gramps Environment variables:

  • GRAMPSI18N: /Applications/
  • GRAMPSHOME: not set
  • GRAMPSDIR: /Applications/
  • GRAMPS_RESOURCES: /Applications/

Locales available:

Installed Locales\Translations (If only English is listed please re-install Gramps again and make sure to select all the Translations and Dictionaries)

sq : Albanian
ar : Arabic
bg : Bulgarian
ca : Catalan
zh_HK : Chinese (Hong Kong)
zh_CN : Chinese (Simplified)
zh_TW : Chinese (Traditional)
hr : Croatian
cs : Czech
da : Danish
nl : Dutch
en_GB : English
en : English (USA)
eo : Esperanto
fi : Finnish
fr : French
de : German
el : Greek
he : Hebrew
hu : Hungarian
is : Icelandic
it : Italian
ja : Japanese
lt : Lithuanian
nb : Norwegian Bokmal
nn : Norwegian Nynorsk
pl : Polish
pt_BR : Portuguese (Brazil)
pt_PT : Portuguese (Portugal)
ru : Russian
sr : Serbian
sk : Slovak
sl : Slovenian
es : Spanish
sv : Swedish
ta : Tamil
tr : Turkish
uk : Ukrainian
vi : Vietnamese

Back Up Your Genealogy Files.
Time to back up your genealogy files, and then test your backups!
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.

  • Backups can be made at any time and at least on the first day of every month, if not more often.
  • Before any upgrade it is strongly recommended to backup each of your Family Trees.
  • Test your backups by creating a new Family Tree and importing the backup.

In a terminal window, cd to the Gramps app. Then go down the Contents/MacOS folder. From there, run the gramps -v.

For instance, I have the Gramps app on my desktop

cd ~/Desktop/Gramps\
./Gramps -v

I have a macbook air with an M1 running Monterey OS and have no issues.

I do not have a GRAMPS_RESOURCES set. The other env are the same.

I do see that you are using en_GB and I am using en_US. But I set to GB and it made no difference.

I don’t have an Apple-silicone machine (Yet!) but…

I experience the issue of needing to click twice on my Intel Mac. In certain situations, a dialog box will open but you need to click it once for it to get ‘focus’. Then click again to do whatever it was you wanted to do in the first place. Sorry, I can’t quickly find an example of this behaviour to illustrate.

I believe that this is an inherent flaw in the GTK software that Gramps employs to power the user interface. I’ve also played with the Geany text editor and had the same sort of thing happen. Annoying but not enough that I’ve tried to report a bug, etc.


There’s a another click behavior idiosyncrasy in Gtk’s File Chooser.

In most file choosers, double-click initiates the dialog’s action (open, save, import, etc.) but the Gtk.FileChooser perform the action upon a click on a selected item. A much fussier implementation that makes unintended actions very likely…