16,602
edits
Changes
m
At When this timeminimal Windows installer was first written, there is was no intent to package all the dependencies and the GRAMPS package into one installer. This creates a It is very complex coordination condition to coordinate dependencies between GRAMPS and these other projects. It also means a single 30+ MB download every version change. However work is started to create installable , later such a package was created and many people find it easier than personally installing all the dependencies; see [[Gramps_Software_Bundle_for_Windows All In One Gramps Software Bundle for Windows| bundleGrampsAIO]] of core dependenciesfor more information.
* [http://apps.sourceforge.net/mediawiki/gramps4win/index.php?title=Main_Page GRAMPS for Windows] Wiki and Downloads - SourceForge.net* [https://lists.sourceforge.net/lists/listinfo/gramps-windows users GRAMPS Windows users mailing list]
→Dependencies - The easy way
* Work with ''a copy'' of your main database and keep regular backups in the [[GRAMPS_XML|GRAMPS XML]] format.
* Join the [https://lists.sourceforge.net/lists/listinfo/gramps-windows users GRAMPS Windows Users mailing list] to share your experiences, especially if you are a developer able to contribute to a Windows port.* See also [[GRAMPS and Windows]] for a collection of hints to run GRAMPS on MS Windows.
* Report any issues you find to help make Gramps better.
==Installation==
These instructions are specific to the GRAMPS (minimal) installer, which requires you to independently install GRAMPS dependencies prior to installing GRAMPS. Please ignore these instructions if you are using either the GRAMPS AIO installer or Portable GRAMPS application.
(The GRAMPS AIO ("all-in-one") installer contains all the dependencies GRAMPS needs and many people find it much easier to install GRAMPS that way. See [[All In One Gramps Software Bundle for Windows|GrampsAIO]] for more information.)
When you need to install the dependencies for GRAMPS there is the easy way and the hard way. You would only use the hard way if you have specific requirements ( such as specific versions ) that are not covered by the easy way.
The essential dependencies that GRAMPS requires to run are:
* Python 2.6.x or later (GRAMPS has not yet been ported to Python 3.x)
* GTK runtime
* GTK python bindings (PyGTK, PyGObject, PyCairo)
=== Dependencies - The easy way ===
Select the correct version of Python dependent on your operating system.
{{man tip|Tip: |Currently (2011-6-20) the minimal installer only comes in a '''32 bit''' version, if you are running on a 64 bit operating system '''select a 32 bit Python installer'''}}
;For Gramps 3.1.x and later
{| {{prettytable}}
!Order
!Package Name
!Download
!Size
!From
!Comment
|-
|<!--Order-->1
|<!--Package Name-->Python 2.6.6
or later
|<!--Download-->[http://www.python.org/ftp/python/2.6.6/python-2.6.6.msi python-2.6.6.msi]
|<!--Size-->11 MB
|<!--From-->[http://www.python.org python.org]
|<!--Comment-->Python 2.6 has performance issues for some people.
|-
|<!--Order-->2
|<!--Package Name-->PyGTK-all-in-one
|<!--Download-->[http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.22/ PyGTK-all-in-one GTK 2.22]
|<!--Size-->Approx 32M
|<!--From-->[http://www.pygtk.org/downloads.html PyGTK]
|<!--Comment--> Select the version that matches your version of python. Note: while pygtk-all-in-one-2.24.x.win32-py2.x has been released it is recommended to still use pygtk-all-in-one-2.22.6.win32-py2.x due to bugs in gtk version 2.24.
|}
'''3.''' Install GRAMPS for Windows. You can download the most recent stable version from [https://sourceforge.net/projects/gramps/files/ SourceForge].
=== Dependencies - The hard way ===
'''1.''' Close any gtk-based applications that are running, such as the GIMP or Pidgin. See ''Common Problems'' below.
|-
|<!--Order-->1
|<!--Package Name-->Python 2.56.4 6
or later
|<!--Download-->[http://www.python.org/ftp/python/2.56.46/python-2.5.4.msi python-2.5.4.msi][http://www.python.org/ftp/python/2.6.5/python-2.6.5.msi python-2.6.56.msi]
|<!--Size-->11 MB
|<!--From-->[http://www.python.org python.org]
|<!--Comment-->Python 2.6 has performance issues for some people. If Gramps is slow use 2.5.4 version.|-|rowspan="2"|<!--Order-->2|rowspan="2"|<!--Package Name-->GTK+ 2.12.9 or later|<!--Download-->[http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe gtk-dev-2.12.9-win32-2.exe] |<!--Size-->17.17 MB|<!--From-->[http://gladewin32.sf.net/ gladewin32]|<!--Comment-->includes glade / See ''Common Problems'' and ''Note'' below. Glade is required for Gramps 3.1.x series and prior
|-
|<!--Order-->2|<!--Package Name-->GTK+ 2.16.6 or later|<!--Download-->[http://downloads.sourceforge.net/gtk-win/gtk2-runtime-2.16.6-2010-02-24-ash.exe gtk2-runtime-GTK+ 2.16.6-2010-02-24-ash.exe]
|<!--Size-->7MB
|<!--From-->[http://gtk-win.sourceforge.net gtk-win]
|<!--Comment-->From Gramps 3.2.0 onwards, Glade is no longer a requirement for Gramps. The windows GTK runtime listed here is a viable alternative to the gtk-dev package. Note: If you receive a "libglib-2.0-0.dll not found" error in step 6, you will need to rerun the GTK installer and select "Compatibility DLLs" when installing.
|-
|<!--Order-->3
|<!--Package Name-->pygtk 2.1216.1 0
or later
|<!--Download-->[http://ftp.accgnome.umu.se/pub/GNOME/binaries/win32/pygtk/2.12/pygtk-2.12.1-3.win32-py2.5.exe pygtk-2.12.1-3.win32-py2.5.exe][http://ftp.acc.umu.seorg/pub/GNOME/binaries/win32/pygtk/2.16/pygtk-2.16.0.win32-py2.6.exe pygtk-2.16.0.win32-py2.6.exe]
|<!--Size-->1.9 MB
|<!--From-->[http://wwwftp.accgnome.umuorg/ ftp.se accgnome.umu.seorg]
|<!--Comment-->See ''Common Problems'' and ''Note'' below. "Run as admin" on Vista & later.
|-
|<!--Order-->4
|<!--Package Name-->pygobject 2.1220.3 0
or later
|<!--Download-->[http://ftp.gnome.org/pub/GNOME/binaries/win32/pygobject/2.12/pygobject-2.12.3-1.win32-py2.5.exe pygobject-2.12.3-1.win32-py2.5.exe][http://ftp.gnome.org/pub/GNOME/binaries/win32/pygobject/2.20/pygobject-2.20.0.win32-py2.6.exe pygobject-2.20.0.win32-py2.6.exe]
|<!--Size-->163 KB
|<!--From-->[http://wwwftp.gnome.org / ftp.gnome.org]
|<!--Comment-->"Run as admin" on Vista & later.
|-
|<!--Order-->5
|<!--Package Name-->pycairo 1.24.6 12
or later
|<!--Download-->[http://ftp.accgnome.umu.se/pub/GNOME/binaries/win32/pycairo/1.2/pycairo-1.2.6-1.win32-py2.5.exe pycairo-1.2.6-1.win32-py2.5.exe][http://ftp.acc.umu.seorg/pub/GNOME/binaries/win32/pycairo/1.4/pycairo-1.4.12-2.win32-py2.6.exe pycairo-1.4.12-2.win32-py2.6.exe]
|<!--Size-->86 KB
|<!--From-->[http://wwwftp.accgnome.umu.seorg/ accftp.umugnome.seorg]
|<!--Comment-->"Run as admin" on Vista & later.
|-
===GTK+ installer error===
If you already have GTK+ installed, perhaps because you have installed [http://gimp-win.sourceforge.net/stable.html The GIMP], [http://www.pidgin.im/ Pidgin], or [http://gnucash.org Gnu Cash], the GTK+ installer will not be able to write to some files if one of those applications is running. If you see errors with the GTK+ installer, select Cancel, shut down the other GTK+ applications and run the installer again. (This issue has been reported as [http://sourceforge.net/tracker/index.php?func=detail&aid=1852930&group_id=98754&atid=621933 GTK+ Installer doesn't handle locked files well] to the kind people who make the GTK+ installer for windows.)
===ImportError: DLL load failed:===
This error is becoming increasingly common on recent GTK+/Windows combinations. Gramps does not have DLL's itself, it is usually caused by one of Gramps dependencies (Most likely Gtk+ runtime, not finding a required dependency). As this issue is more complicated to diagnose we have another page [[ImportError: DLL load failed| ''ImportError: DLL load failed'']] dedicated to discussing the issue.
===Hang when started===
*#* [http://pypi.python.org/packages/any/p/pyenchant/pyenchant-1.5.3.win32.exe pyenchant-1.5.3.win32.exe]
*# Secondly you need [http://www.pygtk.org/pygtkspell/ PyGTKSpell] from [http://www.pygtk.org/about.html gnome-python-extras] which is bindings allowing to run Python programs using the [http://gtkspell.sourceforge.net/ GtkSpell library], that extends GTK+'s GtkTextView widget with support for spell-checking. Depending of yours Python version download and install one of these:
*#* [[Media:PyGTKSpell-2.25.3.win32-py2.56.zip|PyGTKSpell-2.25.3.win32-py2.56.exe]] for Python 2.5*#* [or [Mediahttp:PyGTKSpell//nascent-project.org/barts/Spellchecker_for_Gramps_Portable_3.2.255_Development_Test_1.3paf.win32-py2exe pyenchant 1.65.zip|3, PyGTKSpell-2.25.3.win32-py2.6.exe]] for Python 2.6
*# To install additional dictionaries read tutorial on PyEnchant site:
*#* http://www.rfk.id.au/software/pyenchant/tutorial.html#installation-dicts
* GeoView needs WebKit and python-WebKit.
Experimental versions are available [[GeoView#windows_XP.2FVista|for tests with python 2.6 under Windows]].
==Limitations==
There have been discussions about trying to install compiled distillations (dynamic link libraries) of these core dependencies to avoid having to install the entire Python and GTK environment, but this work never progressed beyond discussion. For more about this and other Windows issues, see the [https://lists.sourceforge.net/lists/listinfo/gramps-windows email list] archive.
== See also ==
* [[GRAMPS and Windows]] describes users experiences using GRAMPS on Windows.
[[Category:Documentation]][[Category:Developers/Packaging]]
