Difference between revisions of "Download"

From Gramps
Jump to: navigation, search
(Start the download page)
(5.2.1 released)
(853 intermediate revisions by 44 users not shown)
Line 1: Line 1:
==Easy download and install of GRAMPS 2.2.6==
+
{{languages|Download}}
Before downloading, check if the version of GRAMPS in your distribution is not current:
+
'''Research, organize and share your family tree with Gramps.'''
* Debian, (K,X,Edu)Ubuntu, Mepis, Suse: <code>apt-get install gramps</code>
 
* Fedora: <code>yum install gramps</code>
 
  
==Live CD==
+
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2024-03-24'''}}|For a list of updates see: ''[[Gramps 5.2 Wiki Manual - What's new?|What's new?]]}}
If you are interested in GRAMPS, but afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), try out our live cd: [[Linux Genealogy CD]]. It does not install on the hard disk and contains a collection of open source, free, genealogy programs. You can install [[http://ubuntu.com|Ubuntu 6.06 LTS]] and GRAMPS from the CD anytime you like.
 
  
==Upgrading to latest version==
+
{{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 [[#1|hardy and portable XML format]].}}
If your version of GRAMPS is not current, some users offer up to date packages for some distributions:
 
  
# Ubuntu: On sourceforge, Download gramps_zzz.deb and gramps-help_zzz.deb, and install with your package manager.
+
<hr />
# SuSE: Richard Bos has been providing the GRAMPS releases for SuSE's apt repository. They are always last release in his repository. See also this forum entry.
+
<span style="font-size:120%">Linux</span>
# Mandriva: Packages for Mandriva are available for use with urpmi from SeerOfSouls.com.
+
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]
# Fedora: The alternative to installing from source (described below) is to build a package from an rpm spec file, or install a binary from fedora testing. Both these processes are outlined on the developers wiki page
+
For Linux, we recommend installing and upgrading Gramps using the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[Installing_Gramps_for_Linux_computers#Linux_distributions|distribution]] or by installing a [https://wikipedia.org/wiki/Flatpak FlatPak] available from [[Installing_Gramps_for_Linux_computers#Flathub|Flathub]].
# Debian: the latest version is installed directly into unstable and can be upgraded from your package manager. Testing is updated 10 days later (except near a new stable release).
 
  
 +
For advanced users, a source package and Debian package are available:
 +
<big>
 +
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u>
 +
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big>
 +
Instructions for how to [[Linux:Build from source|build from source]] or [[Installing_Gramps_for_Linux_computers#Debian_package|install a Debian package]] are available in the wiki.
  
''Note: Some Linux distributions may have a slightly different way to download and install packages for GRAMPS. Please read the installation instructions specific to your distribution before downloading.''
+
{{-}}
 +
<hr />
 +
<span style="font-size:120%">Microsoft Windows</span>
 +
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]
 +
This executable installer supports Microsoft Windows in versions 8, 10, 11 (64-bit Only) 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'''.
  
 +
Alternatives to the All-In-One installer include the [[Installing_Gramps_for_Windows_computers#PortableApps.com|PortableApps.com]] and [[Installing_Gramps_for_Windows_computers#Chocolatey_NuGet_Package|Chocolatey NuGet Package]]. Advanced users can install Gramps from source using the [[Gramps_for_Windows_with_MSYS2|MSYS2]] build environment.
  
In all other cases, you must download the source package zzz.tar.gz, and install GRAMPS manually. See below for details.
+
Older versions available for  (Windows 7 64-bit: [https://portableapps.com/downloading/?a=GrampsPortableLegacyWin7&s=s&p=&d=pa&n=Gramps%20Portable&f=GrampsPortableLegacyWin7_5.1.6_Rev_2.paf.exe 5.1.6], Windows 7/8/10 32-bit: [https://portableapps.com/downloading/?a=GrampsPortableLegacyx86&s=s&p=&d=pa&n=Gramps%20Portable&f=GrampsPortableLegacyx86_5.1.5.paf.exe 5.1.5], Windows XP/Vista: [https://portableapps.com/downloading/?a=GrampsPortableLegacy3&s=s&p=&d=sfpa&n=Gramps%20Portable&f=GrampsPortableLegacy3_3.4.9.paf.exe 3.4.9])
 +
{{-}}
 +
<hr />
 +
<span style="font-size:120%">Apple macOS</span>
 +
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]
 +
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.
 +
<big>
 +
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u>
 +
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u>
 +
</big>
 +
After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next, drag the Gramps application to your application folder and double-click to launch it.
  
==Windows, BSD, MacOs, Solaris==
+
Alternatives to the [[Mac_OS_X:Application_package|application package]] include the [[Installing_Gramps_for_macOS_computers#MacPorts|MacPorts]] and [[Installing_Gramps_for_macOS_computers#Homebrew|Homebrew]] package managers.
For Windows, there is an experimental installer. For more recent versions of GRAMPS in Windows, you need to wait untill a new installer is made available.
+
{{-}}
 +
<hr />
 +
<span style="font-size:120%">BSD platforms</span>
 +
[[File:Bsd daemon.png|128px|left|link=BSD platforms]]
  
For BSD, MacOS, Solaris there are experimental install instructions on the wiki as well as below.
+
For BSD, we recommend installing and upgrading Gramps using the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[BSD platforms#BSD_distributions|distribution]].
  
==Gnome - KDE==
+
Advanced users can [[Linux:Build from source|build from source]] using the link in the Linux section.
You can use both, but GRAMPS fits in better with GNOME. For KDE there are some minor issues due to some (GTK) issues outside of GRAMPS. Check the wiki KDE page to know what these problems might be.
 
  
=Additional software GRAMPS can benefit from=
+
Further information can be found on the [[BSD platforms]] page in the wiki.
GRAMPS does not rely on the following programs, however, having them will increase your productivity:
+
{{-}}
 +
<hr />
  
* '''Gnome-print''': It adds the ability to directly print, to preview, and to generate fully internationalized PS and PDF output. At this time, one needs to install gnome-python-desktop to obtain this package (it might be known under different names, eg on debian python-gnome2-desktop).
+
{{man tip|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 backup]] into this new Family Tree.}}
* '''Spell checking''': Installing python-gnome2-extras provides the gtkspell module, which adds spell checking in the notes
+
{{-}}
* '''Graphviz''', '''Inkscape''': Gramps can make nice Genealogical trees (relationship graphs). These are generated by the Graphviz package, which defines a code (dot), as well as programs to produce graphs (dotty, to be called from command line). This gives you as researcher most power over how your tree will look, but has a learning curve. An alternative is to make a graphical report, converting the tree to an svg file, which you then can open/edit/refine in eg Inkscape.
+
<br />
* '''ttf-freefont''': Useful as a font that supports a large subset of the unicode and is a true type. This works well with both gnomeprint and graphviz output.
+
{{-}}
 +
== 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>
  
 +
[[File:Menubar-FamilyTrees-overview-example-50.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]
  
Other packages might also be usefull:
+
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.
  
* '''Yelp''': Gnome help browser. This allows to call and read the GRAMPS documentation on your computer.
+
See: [[How to make a backup]]
  
 +
== See also ==
 +
* Installer [[Team#Package_Maintainers|package maintainers]]
  
=Installing from source=
+
===Installing Gramps for Desktops===
==General Requirements==
+
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.
  
GRAMPS 2.0 requires python 2.3 and the gnome-python and pygtk2 packages. The gnome-python module should be 2.6.0 or greater. The pygtk package should be version 2.5.0 or greater.
+
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps -->
 +
:* [{{github_url}}/releases/v{{version}} {{version}} version]
 +
:* [{{github_url}}/releases/ Archive of Gramps releases]
 +
Wiki pages
 +
* [[Previous releases of Gramps]]
 +
* [[:Category:Versions|Versions on various platforms]]
  
==Downloading the source==
+
===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]
  
# The lastest stable version of GRAMPS can be downloaded from the GRAMPS SourceForge page. As of writing this is gramps-2.2.6.tar.gz. Extract this file in a directory: tar xzvf gramps-zzz.tar.gz, and go into this directory: cd gramps.
 
# If you are interested in testing out the latest development version of GRAMPS, it can be obtained from SVN, see the wiki entry. The SVN version of GRAMPS is potentially very dangerous as it has not been extensively tested. It may be prone to crashing and cause extensive data loss. Please use with caution.
 
  
 
+
[[Category:Documentation]]
Please, now is the time to read the INSTALL and README files accompanying the code. They come with the most recent information.
 
 
 
==Installing from source code on Linux==
 
 
 
GRAMPS provides a script that can be used to prepare the code for building. This script automatically calls the standard configure script.
 
 
 
./autogen.sh
 
 
 
This script will report any missing dependencies. Install these (see also INSTALL file). Building from source code typically requires that the development versions of the required libraries be installed. You might consider setting a prefix path with autogen.sh, see the INSTALL file for instructions. Standard install is in
 
 
 
Once a successful run of autogen.sh has been completed, you can run the typical make procedure.
 
 
 
make
 
make install
 
 
 
==Installing from source code on BSD==
 
 
 
Installing on BSD is as straithforward as on linux, apart from some minor issues like tools having different names. See the dedicated wiki page.
 
 
 
==Installing from source code on Mac OS X==
 
 
 
Some users have successfully installed GRAMPS on Mac OS X. See the dedicated wiki page. Please, add to the wiki if you successfully installed GRAMPS on OS X.
 
 
 
==Installing from source code on Windows==
 
 
 
Due to the dependencies, it is difficult to install GRAMPS on Windows. Fortunately some users have made an installer hiding all these details. See the Windows page. Use this at your own risk! The developers of GRAMPS provide the space for this install page, but are not responsible for it!
 
 
 
==Installing from source code in Solaris==
 
 
 
Previous versions of GRAMPS have run on Solaris. No recent cases are know to us however. Should you have successfully installed GRAMPS on solaris, please update the wiki.
 

Revision as of 00:46, 25 March 2024

Research, organize and share your family tree with Gramps.

Gramps-notes.png
Gramps Current version: 5.2.2 Released: 2024-03-24

For a list of updates see: What's new?

Gnome-important.png
Before upgrading your distribution

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


Linux

Linux 220x261.png

For Linux, we recommend installing and upgrading Gramps using the package manager provided by your distribution or by installing a FlatPak available from Flathub.

For advanced users, a source package and Debian package are available:

Instructions for how to build from source or install a Debian package are available in the wiki.



Microsoft Windows

Windows 180x160.png

This executable installer supports Microsoft Windows in versions 8, 10, 11 (64-bit Only) and later.

After download: double-click to install Gramps.

Alternatives to the All-In-One installer include the PortableApps.com and Chocolatey NuGet Package. Advanced users can install Gramps from source using the MSYS2 build environment.

Older versions available for (Windows 7 64-bit: 5.1.6, Windows 7/8/10 32-bit: 5.1.5, Windows XP/Vista: 3.4.9)


Apple macOS

Macos 200x200.png

Before downloading read the before installation instructions.

After download: Double-click the .dmg file to mount the disk (note: your browser may do this for you automatically). Next, drag the Gramps application to your application folder and double-click to launch it.

Alternatives to the application package include the MacPorts and Homebrew package managers.


BSD platforms

Bsd daemon.png

For BSD, we recommend installing and upgrading Gramps using the package manager provided by your distribution.

Advanced users can build from source using the link in the Linux section.

Further information can be found on the BSD platforms page in the wiki.


Tango-Dialog-information.png
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 backup into this new Family Tree.




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