Difference between revisions of "Windows AIO themes"

From Gramps
m (Example theme installation: missing letter)
 
(34 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[File:Dark-theme.jpg|thumb|right|450px|Example Dark GTK3 Theme]]
+
[[File:Dark-theme-example-60.png|thumb|right|450px|Example Dark GTK3 Theme]]
  
It is possible to change the Gramps theme on the Windows AIO.
+
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).
  
As of this writing, the AIO uses Gtk 3.18, so a theme MUST be selected that supports that version (themes that are designed for a later version may not work).
+
;GTK Themes:can be found in the '''[https://www.gnome-look.org/browse?cat=135&ord=latest GTK3/4 Themes]''' section on '''gnome-look.org''' that provide '''Eyecandy for your GTK Desktop'''.
  
One choice that provides a pretty good looking dark theme is https://www.gnome-look.org/p/1206053/ the "OlliFri Gtk 3.18 Dark Blue Gradient".
+
__FORCETOC__
 +
=Example theme installation=
 +
For this example the '''[https://www.gnome-look.org/p/2299211 MacTahoe-gtk-theme]''' (By vinceliuice) provides a good looking dark theme.
  
Download the theme file (often a tar.gz) and if necessary decompress it using 7-zip of similar.
+
* 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''
  
The decompressed files should be stored in "C:\Users\you\.themes" (replacing 'you' with your user name) so that the final directory structure looks like:
+
* 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.
C:\Users\you\.themes
+
** Copy the '''MacTahoe-Dark''' folder to the Windows users directory called '''.themes''' if it does not exist create it first "C:\Users\<username>\.themes" .
    Ollis-Gtk-3.18-Dark-Grad
 
      Gtk-2.0
 
      Gtk-3.0
 
      ...
 
  
Find your AIO installation and edit the file in "C:\GrampsAIO64-4.2.6\etc\gtk-3.0\settings.ini".
+
You should now see the files stored in "<code>C:\Users\<username>\.themes</code>" (replace <username> with your user name) so that the final directory structure looks like:
 +
C:\Users\<username>\.themes\MacTahoe-Dark\
 +
                                          ...
 +
                                          gtk-3.0\
 +
                                          ...
  
Add in a line that says "gtk-theme-name = Ollis-Gtk-3.18-Dark-Grad" (or whatever your theme name is).  The complete file should look like this:
+
* 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]
 
  [Settings]
  gtk-theme-name = Ollis-Gtk-3.18-Dark-Grad
+
  gtk-theme-name = MacTahoe-Dark
gtk-xft-antialias=1
 
gtk-xft-hinting=1
 
gtk-xft-hintstyle=hintfull
 
gtk-xft-rgba=rgb
 
  
Note: when you start Gramps, 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.
+
* Start Gramps and you should see the resulting theme shown in the screenshot above.
  
You can check the Gramps Gtk version by starting Gramps from the console;
+
{{man note|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.}}
  Gramps -v
 
  
 +
==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 Settings:
 
  ----------------
 
  ----------------
   python   : 3.5.2
+
   gramps   : AIO64-6.0.5--1
   gramps   : GrampsAIO64-4.2.6
+
  o.s.     : Windows
   gtk++    : 3.18.9
+
  ...
+
Required:
 +
---------
 +
   Python   : 3.12.11
 +
   Gtk++    : 3.24.50
 +
...
  
==See also==
+
=See also=
 
* [[GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme|GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion]]
 
* [[GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme|GTK 3 theme - GEPS 029: GTK3-GObject introspection Conversion]]
* [[GrampsAIO-cxfreeze-based]]
+
* [[GrampsAIO_cx_freeze-based|GrampsAIO-cxfreeze-based]]
 +
* [[Addon:ThemePreferences|Addon:Theme Preferences]] - a simpler way to use Gramps with a Dark theme as you only need to install this addon and select the {{man label|[ ] Dark Variant}} checkbox.
  
 
[[Category:GEPS|T]]
 
[[Category:GEPS|T]]
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]

Latest revision as of 08:48, 14 October 2025

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.

  • 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.
Gramps-notes.png
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