Difference between revisions of "Installing Gramps for Windows computers"

From Gramps
(stub for Windows installer)
 
(Missing other languages)
 
(19 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{languages|Download}}
+
{{languages|Installing Gramps for Windows computers}}
'''Research, organize and share your family tree with Gramps.'''
 
 
 
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2023-06-29'''}}|For a list of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]}}  
 
  
 
{{man warn|Before upgrading your distribution|Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]].}}
 
{{man warn|Before upgrading your distribution|Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]].}}
  
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]
+
== All-In-One installer ==
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.
 
<big>
 
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u>
 
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big>
 
After download: '''double-click to install Gramps'''.
 
{{-}}
 
<hr />
 
 
Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. Should this fail for any reason, '''Create''' a new Family Tree and [[How_to_restore_a_backup|'''Import''' the back-up]] into this new Tree.
 
{{-}}
 
<br />
 
 
 
 
== MS Windows ==
 
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]
 
 
 
 
Before downloading the All-In-One software installer bundle for Windows: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]].  
 
Before downloading the All-In-One software installer bundle for Windows: Use your '''earlier version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees to the hardy and portable [[#1|XML format<sup>1</sup>]].  
  
Line 29: Line 10:
 
(''Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16'')
 
(''Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16'')
  
<big>
 
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u>
 
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big>
 
 
<!-- preserve in case an installer rebuild is needed in the future
 
<!-- preserve in case an installer rebuild is needed in the future
 
{{man note|''The {{version_windows_AIO64}} and {{version_windows_AIO64}}-2 installers are the '''same version of the Gramps program'''. |Only the compilation of the installer was changed. The initial Windows installer was quickly recalled so that the 'dash two' update could restore some omitted dependency items.''}}
 
{{man note|''The {{version_windows_AIO64}} and {{version_windows_AIO64}}-2 installers are the '''same version of the Gramps program'''. |Only the compilation of the installer was changed. The initial Windows installer was quickly recalled so that the 'dash two' update could restore some omitted dependency items.''}}
Line 44: Line 22:
 
Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO cx freeze-based|this page]] (English only). Or, you might want to look at the description of what is meant by an [[All_In_One_Gramps_Software_Bundle_for_Windows|All In One Bundle.]]
 
Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at [[GrampsAIO cx freeze-based|this page]] (English only). Or, you might want to look at the description of what is meant by an [[All_In_One_Gramps_Software_Bundle_for_Windows|All In One Bundle.]]
  
=== Alternative independent installation ===
+
=== Missing other languages ===
[[File:Gramps-release.png|left]]
+
[[File:MicrosoftWindowGrampsAIO-Installer-ChooseComponents-Selection-example-60.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]
If needed, there are alternatives to the All-In-One installer.
+
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary.  
  
==== PortableApps.com ====
+
If you prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation.
 +
 
 +
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.
 +
 
 +
Even your primary language is installed by default, you might anticipate the need to spellcheck Notes in other than the British dialect of English. Be certain to select the appropriate languages from '''Dictionaries'''. Gramps will not access your Operating System's native dictionary.
 +
 
 +
There is no simple facility for adding interface or dictionary languages after installation.
 +
{{-}}
 +
 
 +
== PortableApps.com ==
 
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]
 
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]
 
A [https://portableapps.com/apps/education/gramps_portable '''PortableApps''' version] will run from an external device without the requirement of installing on the OS drive. PortableApps installations are <b><i>not</i></b> for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives.
 
A [https://portableapps.com/apps/education/gramps_portable '''PortableApps''' version] will run from an external device without the requirement of installing on the OS drive. PortableApps installations are <b><i>not</i></b> for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives.
  
 
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:
 
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:
* the [https://portableapps.com/apps/education/gramps_portable Gramps Portable project] page in their [https://portableapps.com/apps/education/ Education] category. On 64bit systems, the {{Version_windows_portable}} version will install but 32bit systems will install the legacy GrampsPortable 5.1.5 version. See the [https://portableapps.com/comment/254354#comment-254354 PortableApps notice] for more details.
+
* the [https://portableapps.com/apps/education/gramps_portable Gramps Portable project] page in their [https://portableapps.com/apps/education/ Education] category.  
 +
 
 +
 
 +
===Critical legacy versions:===
 +
On 64bit systems, the {{Version_windows_portable}} version will install. But '''32bit''' systems will need to install the legacy GrampsPortable 5.1.5 version. Fortunately, '''PortableApps.com''' also provides access to [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ Legacy versions of GrampsPortable] downloads.
 +
 
 +
* [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/GrampsPortable_5.2.2.paf.exe/download GrampsPortable_5.2.2.paf.exe] (106.5 MB) &mdash; final version supporting pickled blobs in the database backend
 +
* [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/GrampsPortableLegacyx86_5.1.5.paf.exe/download GrampsPortableLegacyx86_5.1.5.paf.exe] (68.0 MB) &mdash; final version for 32bit processors, XP/Vista/7, full support for BSDDB database backend
 +
* [https://sourceforge.net/projects/portableapps/files/Gramps%20Portable/GrampsPortable_3.4.9.paf.exe/download GrampsPortable_3.4.9.paf.exe] (29.0 MB) &mdash; although it is not recommended for general use; however it is very useful for recovering some of the earliest formats of Gramps databases.
  
Note that '''PortableApps.com''' also has a Legacy 3.4.9 version of Gramps available -- although it is not recommended for general use; just for recovering older format databases.
+
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path to which you installed it) or make a shortcut to that file on your desktop or start-menu.'' '''[https://portableapps.com/forums/support/education Please report packaging issues here]'''
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB)
+
{{-}}
  
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] includes all dependencies required for Windows. ''Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path you installed it to) or make a shortcut to that file on your desktop or start-menu.'' '''[https://portableapps.com/forums/support/education Please report packaging issues here]'''
+
=== See also ===
 +
* PortableApps.com Project on SourceForge : [https://sourceforge.net/projects/portableapps/files/Source/Gramps/ gramps source]
 +
* [https://portableapps.com/forums/support/education PortableApps forum: Education Apps Support]
 +
* [https://portableapps.com/forums/general/request_apps App requests]
 +
* [https://portableapps.com/development/outdated Outdated Official Portable Applications]
  
==== Chocolatey NuGet Package ====
+
== Chocolatey NuGet Package ==
 
You may also install using the alternative independent Gramps Chocolatey NuGet Package
 
You may also install using the alternative independent Gramps Chocolatey NuGet Package
  
Line 67: Line 66:
 
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]
 
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]
  
==== Gramps for Windows with MSYS2 ====
+
== Gramps for Windows with MSYS2 ==
  
 
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.
 
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.
Line 73: Line 72:
 
* [[Gramps for Windows with MSYS2]]
 
* [[Gramps for Windows with MSYS2]]
  
{{-}}
 
 
=== Missing other languages ===
 
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]
 
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary.
 
 
If you prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation.
 
 
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.
 
 
Even your primary language is installed by default, you might anticipate the need to spellcheck Notes in other than the British dialect of English. Be certain to select the appropriate languages from '''Dictionaries'''. Gramps will not access your Operating System's native dictionary.
 
 
There is no simple facility for adding interface or dictionary languages after installation.
 
 
{{-}}
 
{{-}}
  
 
== Notes ==
 
== Notes ==
 
<span id="1">Backup to '''Gramps XML''' format when updating. ''Although Gramps reads and writes '''GEDCOM 5.5.1''' format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML format.</span>  
 
<span id="1">Backup to '''Gramps XML''' format when updating. ''Although Gramps reads and writes '''GEDCOM 5.5.1''' format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data.'' Always backup with the more robust Gramps XML format.</span>  
 +
 +
[[File:Menubar-FamilyTrees-overview-FamilyTree-Loaded-example-60.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]
  
 
You will find a [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup...}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps versions. Alternately, use [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|Export...}}]] in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.  
 
You will find a [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|{{Man menu|Make Backup...}}]] option in the {{Man menu|Family Trees}} menu of recent Gramps versions. Alternately, use [[Gramps_{{man version}}_Wiki_Manual_-_Manage_Family_Trees#Exporting_data|{{Man menu|Export...}}]] in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.  
Line 97: Line 85:
 
== See also ==
 
== See also ==
 
===Installing Gramps for Desktops===
 
===Installing Gramps for Desktops===
* on [[Installing Gramps for Linux computers|Linux distributions]]
+
Installation instructions specific to the different OSes are on the [[File:linux_32x32.png|link=Installing_Gramps_for_Linux_computers#Linux_distributions]], [[File:windows_32x32.png|link=Installing_Gramps_for_Windows_computers]],[[File:macos_200x200.png|32px|link=Installing_Gramps_for_macOS_computers]] and [[File:Bsd daemon.png|32px|link=BSD_platforms]] pages.
* [[Installing Gramps for macOS computers|macOS]]
 
* [[Installing Gramps for Windows computers|Windows]]
 
* [[Installing Gramps for Windows computers|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])
 
  
===Installing Gramps Web for online collaboration===
+
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps -->
* Docker
 
 
 
GitHub Releases <!--github_url template = https://github.com/gramps-project/gramps -->
 
 
:* [{{github_url}}/releases/v{{version}} {{version}} version]
 
:* [{{github_url}}/releases/v{{version}} {{version}} version]
 
:* [{{github_url}}/releases/ Archive of Gramps releases]  
 
:* [{{github_url}}/releases/ Archive of Gramps releases]  
Line 111: Line 93:
 
* [[Previous releases of Gramps]]
 
* [[Previous releases of Gramps]]
 
* [[:Category:Versions|Versions on various platforms]]  
 
* [[:Category:Versions|Versions on various platforms]]  
 +
 +
===Installing Gramps Web for online collaboration===
 +
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps
 +
* [https://www.grampsweb.org/Deployment/ Docker]
 +
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 23:18, 12 July 2025

Gnome-important.png
Before upgrading your distribution

Use your earlier version of Gramps to backup your Family Trees to the hardy and portable XML format1.

All-In-One installer

Before downloading the All-In-One software installer bundle for Windows: Use your earlier version of Gramps to backup your Family Trees to the hardy and portable XML format1.

This installer supports Microsoft Windows in all versions Vista/7 and later. The 64-bit versions of Windows allow more efficient access to more resources.

(Please note: Gramps prefers the Python-3.5 and Gtk-3.18 libraries and newer. Those libraries have dropped support for Windows XP. But Gramps can still be run on Windows XP with earlier library versions, i.e., Python3.4.4 and Gtk-3.16)


After download: double-click to install Gramps.
By default: new releases will be added in a new directory and earlier installations of Gramps will not be overwritten; the language will be a mix of British and US English.

Tango-Dialog-information.png
Shortcuts

During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu.
Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.
1) GrampsAIOXX 6.0.8 ← for normal use of Gramps
2)
GrampsAIOXX 6.0.8-console


Normally, when you try to load your old Family Tree you can allow it to be upgraded if necessary, and it will be opened. Should this fail for any reason, Create a new Family Tree and Import the back-up into this new Tree.

Use the Windows AIO (All-In-One) version, please use the download links above. For more information about individual versions, console and debug modes, release notes, etc., look at this page (English only). Or, you might want to look at the description of what is meant by an All In One Bundle.

Missing other languages

Microsoft Window Gramps AIO Installer Choose Components-Selection window.

The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary.

If you prefer a different language (or spell with the US or Australian dialects of English), please ensure that you pay special attention to the Choose Components phase of the installation.

To install a language other than English, select from both the Translations and Dictionaries during the Choose Components phase of the installation.

Even your primary language is installed by default, you might anticipate the need to spellcheck Notes in other than the British dialect of English. Be certain to select the appropriate languages from Dictionaries. Gramps will not access your Operating System's native dictionary.

There is no simple facility for adding interface or dictionary languages after installation.

PortableApps.com

When launching the PortableApps fork of Gramps, this splash screen appears.

A PortableApps version will run from an external device without the requirement of installing on the OS drive. PortableApps installations are not for touchscreen-based mobile devices. They just allow the application to run from external storage, USB thumbdrives.

You can download the 6.0.6 Gramps Portable version from:


Critical legacy versions:

On 64bit systems, the 6.0.6 version will install. But 32bit systems will need to install the legacy GrampsPortable 5.1.5 version. Fortunately, PortableApps.com also provides access to Legacy versions of GrampsPortable downloads.

Portable Gramps from PortableApps.com includes all dependencies required for Windows. Note:You can install it on C: then to run Gramps type C:\PortableApps\GrampsPortable\GrampsPortable.exe (Or the path to which you installed it) or make a shortcut to that file on your desktop or start-menu. Please report packaging issues here

See also

Chocolatey NuGet Package

You may also install using the alternative independent Gramps Chocolatey NuGet Package

Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.

Gramps for Windows with MSYS2

How to use MSYS2 to run latest Gramps development version from source in 64bit Windows.


Notes

Backup to Gramps XML format when updating. Although Gramps reads and writes GEDCOM 5.5.1 format fluently (because it is the de facto format for genealogical data interchange), never depend on such a rudimentary format for archiving your research. GEDCOM cannot store all the intricacies found in Gramps data. Always backup with the more robust Gramps XML format.

Menubar - "Family Trees > Make Backup..."

You will find a Make Backup... option in the Family Trees menu of recent Gramps versions. Alternately, use Export... in the same menu but deselect the privacy and filtering options in the Exporter Assistant to avoid omission of any data.

See: How to make a backup

See also

Installing Gramps for Desktops

Installation instructions specific to the different OSes are on the Linux 32x32.png, Windows 32x32.png,Macos 200x200.png and Bsd daemon.png pages.

GitHub Gramps for Desktops Releases

Wiki pages

Installing Gramps Web for online collaboration

Gramps Web is a frontend for a hosted instance of Gramps