Changes

[[Category:Documentation]][[Category:Developers/Packaging]]{{languages|Windows installer}}{{man warn|These are the original instructions for installation on Windows of Gramps 3.4.x and earlier|They were written when a Windows user also had to (manually) install various other programs ("dependencies") in order to get Gramps to work.<br>'''GRAMPS A much easier way to install Gramps on Windows is not ''designed'' to run on Microsoft use the "all-in-one" [[All In One Gramps Software Bundle for Windows and should be regarded as experimental.|installer]], since it has all the needed programs ("bundled")''' . {{man menu|[[Download#MS_Windows]]}}}} {{stub}} Because it ''Gramps has'' been designed to use the and written in multi-platform toolsets resources (including Python and GTK), a few volunteers we have created test a Windows installer packages that some users report has been reported to work without too many any obvious issues. But this is not formally tested and you may find GRAMPS behavior on Windows becomes suddenly unstable or subtly compromises your data over a period of time without you noticing. And each new version may have errors different than  We do suggest the one before. So if you choose to use these under Windows please rememberfollowing:

* Work with ''a copy '' of your main database and keep regular backups in the GRAMPS [[Gramps XML ]] format.* Do not recommend it to Windows users as a stable or usable genealogy application.* Join the [https://lists.sourceforge.net/lists/listinfo/gramps-windows GRAMPS Windows users Gramps Users mailing list] to share your experiences or , 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.

1The essential dependencies that Gramps requires to run are:* Python 2. GRAMPS depends on the following software packages6.x or later (Gramps trunk has been ported to Python 3.x and has different dependancies)* GTK runtime* GTK python bindings (PyGTK, PyGObject, we have had best results by installing the packages in the order below.PyCairo)

* Python 2.5 => [http://www.python.org/ftp/python/2.5/python== Dependencies -2.5.msi python-2The easy way ===Select the correct version of Python dependent on your operating system.5.msi] (10.4 MB, from [http://www.python.org python.org])* GTK+ 2.8.20 => [http{{man tip|Tip://prdownloads.sourceforge.net/gladewin32/gtk-2.8.20-win32-1.exe?download gtk-2.8.20-win32-1.exe] |The (5.5 MB, from [http://gladewin32.sf.net/ gladewin32], includes glade)* pygtk 2.8.6 => [http://ftp.acc.umu.se/pub/GNOME/binaries/win32/pygtk/2.8/pygtk2011-2.8.6-1.win32-py2.5.exe pygtk-2.8.6-1.win32-py2.5.exe] (631 KB, from [http://www.acc.umu.se www.acc.umu.se]20)* pycairo 1.2.2 => [http://ftp.acc.umu.se/pub/GNOME/binaries/win32/pycairo/1.2/pycairo-1.2.2-2.win32-py2.5.exe pycairo-1.2.2-2.win32-py2.5.exe] (82 KBminimal installer only came as a '''32 bit''' version, from [http://www.acc.umu.se/ www.acc.umu.se])if you are running on a 64 bit operating system '''select a 32 bit Python installer'''}}

;For Gramps 3. 1.x to 3.4.x{| {{prettytable}}!Order!Package Name!Download!Size!From!Comment|-|<!--Order-->1|<!--Package Name-->Python 2.6.6or 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/projectprojects/gramps/files/showfilesSourceForge].php?group_id === Dependencies - The hard way ===25770'''1.''' Close any gtk-based applications that are running, such as the GIMP or Pidgin. See ''Common Problems'' below. '''2.''' Install the packages in the following order: ;For Gramps 3.1.x to 3.4.x{| {{prettytable}}!Order!Package Name!Download!Size!From!Comment|-|<!--Order-->1|<!--Package Name-->Python 2.6.6or 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-->GTK+ 2.16.6 or later|<!--Download-->[http://downloads.sourceforge.net/gtk-win/gtk2-runtime-2.16.6-2010-02-24-ash.exe GTK+ 2.16.6] |<!--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.16.0 or later|<!--Download-->[http://ftp.gnome.org/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://ftp.gnome.org/ ftp.gnome.org]|<!--Comment-->See ''Common Problems'' and ''Note'' below. "Run as admin" on Vista &package_id=109309later.|-|<!--Order-->4|<!--Package Name-->pygobject 2.20.0 or later|<!--Download-->[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://ftp.gnome.org/ ftp.gnome.org]|<!--Comment-->"Run as admin" on Vista &release_id=482337 grampslater.|-|<!--Order-->5|<!--Package Name-->pycairo 1.4.12or later|<!--Download-->[http://ftp.gnome.org/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://ftp.gnome.org/ ftp.gnome.org]|<!--Comment-->"Run as admin" on Vista & later.|-|<!--Order-->6|<!--Package Name-->Validate Install|<!--Download-->NA|<!--Size-->NA|<!--From-->NA|<!--Comment-->The following recommendations are for the validation of the proper installation of the above listed Gramps software prerequisites.  After installing the items above on a VISTA 64 bit Ultimate System; Gramps could not locate any of the above software except for Python. This caused the installer to not install Gramps. After some time researching the issue I found the solution to my problem in a post by "steve geo at [http://old.nabble.com/3.1.1-install-program-problem-td22636394.html old.nabble.com]". NOTE:These steps should validate an installation on XP, Vista and Windows 7 with the caveat that the command window on Vista and Windows 7 should be opened using the "Run as Administrator" (Set your mouse pointer over the command prompt icon and right-click your mouse button to display the menu. Click on the "Run as Administrator" item.) 1. Open up command window (see note above) 2. If you installed the gtk-runtime software in row 2 above (SKIP to ahead to 3.) Type gtk-demo and press the enter key.  a) If the gtk demo program does not load then it is likely you do not have the gtk bin directory in your path correctly. (Add your installation directory to your path environment variable) 3. Change to the directory where you installed the Python application. By default it is likely installed at C:\Python26. Once in this folder type python and press the enter key  a) Your command window should show you information about the version of Python installed on your computer and your prompt should be different and will likely look like ">>>" b) If you do not have a "drive:\[your python install directory]" you should run the python installation program. c) If your prompt does not change. Re-install python and watch closely for errors or a different drive and directory for the installation.  4. At the Python prompt - likely ">>>"  a) import pygtk b) import gtk c) import gobject The above items should complete without errors.5. If you are updating from a prevous GTK version, make sure you have "Graphviz" folder path AFTER the "GTK2 runtime 2.16" folder.It should look like this (in this order) PATH=... C:\Program files\GTK2 Runtime\bin;C:\Program files\Graphviz2.26\bin;C:\Program files\GS\GS8.64\bin. If "Graphviz" is located before "GTK2 Runtime 2.16" in the PATH folder order Gramps will not start. 6. Reboot your computer. After reboot run Gramps install.|-|<!--Order-->Optional|<!--Package Name-->Graphviz|<!--Download-->[http://www.graphviz.org/pub/graphviz/stable/windows/graphviz-2.26.msi graphviz-2.26.msi]|<!--Size-->31 MB|<!--From-->[http://www.graphviz.org/ graphviz.org]|<!--Comment-->Needed to be able to generate relationship graphs (single page PDFs only)|-|<!--Order-->Optional|<!--Package Name-->GhostScript|<!--Download-->[http://mirror.cs.wisc.edu/pub/mirrors/ghost/GPL/gs864/gs864w32.exegs864w32.exe]|<!--Size-->11.9 MB|<!--From-->[http://pages.cs.wisc.edu/~ghost/ pages.cs.wisc.edu/~ghost] |<!-- Comment-->Needed to be able to generate PDFs through Ghostscript (multiple pages PDFs) Need to add manually gs\gs8.64\bin folder to system path!|} '''Note''': For Gramps 3.0.x and earlier use:* GTK+ 2.10.11 => [http://downloads.sourceforge.net/gladewin32/gtk-dev-2.10.11-win32-1.exe?download gtk-dev-2.10.11-win32-1.exe] (11.9 MB) * pygtk 2.10.6 => [http://ftp.acc.umu.se/pub/GNOME/binaries/win32/pygtk/2.10/pygtk-2.10.6-1.win32-py2.5.exe pygtk-2.10.6-1.win32-py2.5.exe] (1.8 MB, from [http://www.acc.umu.se www.acc.umu.se]) GRAMPS one '''3.''' Re-click installer boot the computer after installing the above dependencies, prior to installing Gramps. '''4.''' Install Gramps for Windows, with support for 20 languages. NoteYou can download the most recent stable version from [https: The //sourceforge.net/projects/gramps/files/ SourceForge]. ==Common problems== ===Installer complains pygtk is missing===This is a very common error to see when all dependencies are not installed or installed correctly. Please make sure that each of the packages required have installed correctly, and re-boot the computer prior to running the Gramps installer . We often complains see users attempting to use other packages to satisfy these requirements that omit something necessary (e.g., glade) which produce this error. In rare occasions, the installer will complain that pygtk is not installedeven though everything is correct. Cancelling Canceling and re-running the installer seems to fix this problem, although if it happens repeatedly, the error is the more severe situation discussed above. (Anyone know why? Please tell us on the [https://lists.sourceforge.net/lists/listinfo/gramps-windows gramps-windows email list].) ===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===In some environments Gramps may be unresponsive after displaying its window after being started, particularly after the first time. This can be worked around by running Gramps via a BAT file which first sets GRAMPSHOME to an accessible directory, as discussed on the [[Gramps_and_Windows#Setting_the_configuration_path|''Gramps and Windows'' page]]. ==Additional plugins== There are some features of Gramps that need additional programs to work. There are several different kinds of reports, and the following features need extra configuration to work on Windows.  * The Relationship Graph reports (both graph and code output formats) need an installation of [http://www.graphviz.org Graphviz]. There is a bug in the current stable release, see this [[Howto:_Make_a_relationship_chart#Example_3.2C_Generating_the_graph_by_using_the_Graphviz_command_line_tool |example]].* The Relationship Graph can not use PDF as output format unless there is an installation of [https://www.ghostscript.com/ Ghostscript]. After installation, if gswin32.exe or gswin32c.exe is in the path, PDF should appear as one of the formats in the graphical Relationship Graph report.* '''Spell-checking:'''*# For spell-checking to work you first need [https://abiword.github.io/enchant/ Enchant library] and python bindings [https://pypi.python.org/pypi/pyenchant/ PyEnchant]. Enchant appears to be a generic spell checking library. You can request dictionaries from it, ask if a word is correctly spelled, get corrections for a misspelled word, etc... PyEnchant is a set of language bindings and some wrapper classes to make the excellent Enchant spellchecker available as a Python module. Both are available for windows as single setup file:*#* [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.6.zip|PyGTKSpell-2.25.3.win32-py2.6.exe]] or [http://nascent-project.org/barts/Spellchecker_for_Gramps_Portable_3.2.5_Development_Test_1.paf.exe pyenchant 1.5.3, PyGTKSpell 2.25.3] 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]].

At When this timeminimal Windows installer was first written, there is was no intent to package all the dependencies and the GRAMPS Gramps package into one installer. This creates a It is very complex coordination condition to coordinate dependencies between GRAMPS Gramps and these other projects. It also means a single 19 30+ MB download every version change. However, later such a package was created and many people find it easier than personally installing all the dependencies; see [[All In One Gramps Software Bundle for Windows| GrampsAIO]] for more information.

There has recently have been discussion 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 has not yet been completednever progressed beyond discussion. More discussion For more about this and other Windows issues can be found on , see the [https://lists.sourceforge.net/lists/listinfo/gramps-windows email list(List gone)] archive. On Windows Vista you will need to save the executable using "save as" and run it as administrator, otherwise the programs will not be able to write to the registry on installation. To do that right click the saved file and choose "run as administrator". == See also ==* [[Gramps and Windows]] describes users experiences using Gramps on Windows.* [https://lists.sourceforge.net/lists/listinfo/gramps-users Gramps users mailing list]* [[Gramps for Windows with MSYS2]]  [[Category:Documentation]][[Category:Developers/Packaging]]