Windows AIO themes

Example Dark GTK3 Theme

The Gramps theme on the Windows AIO(All in one) installation can be changed so long as the Gramps AIO is version 5.0.x or newer and uses Gtk 3.18 to 3.24 you can select a theme that MUST support those versions (also themes that are designed for a later version may not work).

GTK Themes

can be found in the GTK3/4 Themes section on gnome-look.org that provide Eyecandy for your GTK Desktop.

Example theme installation

For this example the MacTahoe-gtk-theme (By vinceliuice) provides a good looking dark theme.

• Start by download the file of latest release from https://github.com/vinceliuice/MacTahoe-gtk-theme/releases
• After downloading the theme file (often a tar.gz or a .zip ) decompress it using 7-zip of similar. In this example the filename was MacTahoe-gtk-theme-2025-08-22.zip

• Once decompressed look in the MacTahoe-gtk-theme-2025-08-22 folder for the release folder and you will see a list of sub themes select the MacTahoe-Dark.tar.xz file and decompress it, you should now have a folder named MacTahoe-Dark with various folders and files.
  • Copy the MacTahoe-Dark folder to the Windows users directory called .themes if it does not exist create it first "C:\Users\<username>\.themes" .

You should now see the files stored in "C:\Users\<username>\.themes" (replace <username> with your user name) so that the final directory structure looks like:

C:\Users\<username>\.themes\MacTahoe-Dark\
                                          ...
                                          gtk-3.0\
                                          ...

• Find your Gramps AIO installation folder and create/edit the settings.ini file in "C:\GrampsAIO64-6.0.5\etc\gtk-3.0\settings.ini"
  • In the [Settings] section add in a line that says gtk-theme-name = MacTahoe-Dark (or whatever your theme name is). The complete file may look like this:

[Settings]
gtk-theme-name = MacTahoe-Dark

• Start Gramps and you should see the resulting theme shown in the screenshot above.

Note: When starting Gramps with the new theme your console may show some Gtk-WARNING **: Theme parsing error messages. These are usually harmless, but if there are a lot, and your Gramps screen doesn't look right, then your theme may not be compatible with the version of Gtk Gramps AIO is using, remove and find a new theme.

Checking your Gramps AIO Gtk version

You can check the Gramps AIO Gtk version by starting Gramps from the console;

gramps -v

C:\Program Files\GrampsAIO64-6.0.5>gramps -v
Gramps Settings:
----------------
 gramps    : AIO64-6.0.5--1
 o.s.      : Windows

Required:
---------
 Python    : 3.12.11
 Gtk++     : 3.24.50
...

See also

• GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion
• GrampsAIO-cxfreeze-based
• Addon:Theme Preferences - a simpler way to use Gramps with a Dark theme as you only need to install this addon and select the [ ] Dark Variant checkbox.