https://gramps-project.org/wiki/api.php?action=feedcontributions&user=Nick+H&feedformat=atom
Gramps - User contributions [en]
2024-03-29T00:52:06Z
User contributions
MediaWiki 1.31.3
https://gramps-project.org/wiki/index.php?title=Template:Version_Mac&diff=103452
Template:Version Mac
2024-03-28T20:40:27Z
<p>Nick H: 5.2.1 released</p>
<hr />
<div>5.2.1<noinclude><br />
[[Category:Developers/Packaging ]]<br />
[[Category:Versions]]<br />
[[Category:Templates]]<br />
<br />
<br />
<!--<br />
<br />
https://github.com/gramps-project/gramps/releases/download/v5.2.0/Gramps-Arm-5.2.0-1.dmg<br />
https://github.com/gramps-project/gramps/releases/download/v5.2.0/Gramps-Intel-5.2.0-1.dmg<br />
<br />
--><br />
</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:Version_windows_AIO64&diff=103410
Template:Version windows AIO64
2024-03-26T15:48:01Z
<p>Nick H: 5.2.1 released</p>
<hr />
<div>5.2.1<noinclude><br />
[[Category:Developers/Packaging ]]<br />
[[Category:Versions]]<br />
[[Category:Templates]]<br />
</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=103403
Download
2024-03-25T00:46:03Z
<p>Nick H: 5.2.1 released</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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]].}}<br />
<br />
<hr /><br />
<span style="font-size:120%">Linux</span><br />
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]<br />
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]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
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.<br />
<br />
{{-}}<br />
<hr /><br />
<span style="font-size:120%">Microsoft Windows</span><br />
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]<br />
This executable installer supports Microsoft Windows in versions 8, 10, 11 (64-bit Only) and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
<br />
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.<br />
<br />
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])<br />
{{-}}<br />
<hr /><br />
<span style="font-size:120%">Apple macOS</span><br />
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]<br />
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
<br />
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. <br />
{{-}}<br />
<hr /><br />
<span style="font-size:120%">BSD platforms</span><br />
[[File:Bsd daemon.png|128px|left|link=BSD platforms]]<br />
<br />
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]].<br />
<br />
Advanced users can [[Linux:Build from source|build from source]] using the link in the Linux section.<br />
<br />
Further information can be found on the [[BSD platforms]] page in the wiki.<br />
{{-}}<br />
<hr /><br />
<br />
{{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.}}<br />
{{-}}<br />
<br /><br />
{{-}}<br />
== Notes ==<br />
<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> <br />
<br />
[[File:Menubar-FamilyTrees-overview-example-50.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]<br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
* Installer [[Team#Package_Maintainers|package maintainers]]<br />
<br />
===Installing Gramps for Desktops===<br />
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.<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps <br />
* [https://www.grampsweb.org/Deployment/ Docker] <br />
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]<br />
<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=HeadlineNews&diff=103402
HeadlineNews
2024-03-25T00:45:32Z
<p>Nick H: 5.2.1 released</p>
<hr />
<div>{{Announcement|Headline News| These are the latest announcements from the Gramps project.<br> They are updated once per day in the Gramps [[Addon:HeadlineNewsGramplet|Headline News Gramplet]].}}<br />
<br />
* [[Download|Gramps 5.2.1]] has been released.<br />
* New versions of [[Third-party Addons]] are ready!<br />
* Join the [[Contact#Forum|Forum]] or one of the [[Contact#Mailing_lists|Mailing Lists]]<br />
* [https://forum.gramps-project.org/ Discourse forum for Gramps]: You can use the forum to [https://gramps.discourse.group/t/tutorial-videos/126 discover tutorial videos], ask questions and get help from the Gramps community. It is also a great place to keep up-to-date with the latest development plans. Feel welcome to have a look anonymously or sign up for an account so that you can interact.<br />
* Make a [https://sourceforge.net/projects/gramps/donate financial contribution/donation to the Gramps project]<br />
* [[Gramps:Site_support|How Can I help?]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:Version&diff=103401
Template:Version
2024-03-25T00:43:32Z
<p>Nick H: 5.2.1 released</p>
<hr />
<div>5.2.1<noinclude><br />
==Usage==<br />
<nowiki>{{version}}</nowiki><br />
<br />
==See also==<br />
{{Version Templates}}<br />
<br />
</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Previous_releases_of_Gramps&diff=103400
Previous releases of Gramps
2024-03-25T00:42:30Z
<p>Nick H: 5.2.1 released</p>
<hr />
<div><!-- http://sourceforge.net/project/admin/editreleases.php?package_id=109309&group_id=25770 --><br />
{{man note|Looking for the most current release of Gramps?|You may download the Gramps genealogy program 'installer' from the [[Download]] page.}}<br />
This is a list of Gramps and its previous releases.<br />
{| class="wikitable sortable"<br />
|-<br />
!<br />
! Meaning<br />
|-<br />
| style="background-color:#A0E75A;" | Green<br />
| Current version. '''Recommended for all new installs'''<br />
|-<br />
| style="background-color:#f0e68c;" | Yellow<br />
| Still supported (Update to the last release for that version / Strongly Recommended you upgrade to the '''Current version''')<br />
|-<br />
| style="background-color:#66ccff;" | Blue<br />
| Current Public testing version (Unstable/Alpha/Beta/Release Candidate)<br />
|-<br />
| style="background-color:#C0C0C0;" | Silver<br />
| [[Portal:Developers|Development version]] (Git Version - Here be dragons - Recommended only for testing the future of Gramps)<br />
|-<br />
| style="background-color:#fa8072;" | Red<br />
| Not supported (Update to the last release for that version / Strongly Recommended you upgrade to the '''Current version''')<br />
|}<br />
<!-- RELEASE HISTORY - In reverse date order with newest releases at the top with git master as the first entry and oldest at bottom. --><br />
{| class="wikitable sortable"<br />
|-<br />
!Version<br />
!Release Date<br />
!Name<br />
!Notes<br />
!User Manual<br />
|-<br />
| style="background-color:#C0C0C0;" |[https://github.com/gramps-project/gramps Git]||N/A||N/A||Development version (Python 3.8+ only / GTK 3.24+ / SQLite3 / BSDDB 3 (Read-only for upgrades)) / [[:Category:Developers/Roadmap|Developers/Roadmap]] || N/A<br />
|-<br />
| style="background-color:#A0E75A;" |[[Template:Releases/5.2.1|5.2.1]]||2024-03-24|| ||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/5.2.0|5.2.0]]||2024-02-23|| || Python 3.8+ only / GTK 3.24+ / SQLite3 / BSDDB 3 (Read-only for upgrades) || [[Gramps_5.2_Wiki_Manual|5.2.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-rc1 5.2.0-rc1 (unstable)]||2024-02-09|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-beta2 5.2.0-beta2 (unstable)]||2023-08-25|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-beta1 5.2.0-beta1 (unstable)]||2023-08-01|| ||<br />
|-<br />
| style="background-color:#f0e68c;" |[[Template:Releases/5.1.6|5.1.6]]||2023-06-29|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.5|5.1.5]]||2022-02-05|| || [https://www.reddit.com/r/gramps/comments/zwx62y/new_native_download_of_gramps_515_for_macos_for/ New Native Download of Gramps 5.1.5] for macOS for [https://support.apple.com/en-au/HT211814 Apple Silicon (Arm, aarch64)]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.4|5.1.4]]||2021-07-26|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-dev2 5.2.0-dev2 (unstable)]||2020-09-17|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-dev1 5.2.0-dev1 (unstable)]||2020-09-17|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.3|5.1.3]]||2020-08-13|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.2|5.1.2]]||2020-01-10|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.1|5.1.1]]||2019-09-14|| ||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/5.1.0|5.1.0]]||2019-08-21|| || Python 3.3+ only / GTK 3.12+ / SQLite3 (Default backend) / BSDDB 3 (Legacy backend) || [[Gramps_5.1_Wiki_Manual|5.1.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.0.2|5.0.2]]||2019-08-08|| || Final maintenance release in the Gramps 5.0.x series.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.0.1|5.0.1]]||2018-12-20|| ||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/5.0.0|5.0.0]]||2018-07-24|| || (Python 3.2+ only / GTK 3.10+ / BSDDB 3 (Default backend) / SQLite3 (Experimental backend) ) || [[Gramps_5.0_Wiki_Manual|5.0.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-rc1 5.0.0-rc1 (unstable)]||2018-05-20|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-beta1 5.0.0-beta1 (unstable)]||2018-02-18|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.8|4.2.8]]||2018-02-09|| || A one-bug-fix release. It corrects the Geography views for bad 'dbstate.is_open()' Final maintenance release in the Gramps 4.2.x series.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.7|4.2.7]]||2018-02-08|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-alpha3 5.0.0-alpha3 (unstable)]||2017-09-02|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.6|4.2.6]]||2017-08-01|| ||In Memory of [https://github.com/johanpetter Peter Landgren]. The final Apple Mac PPC one-click-install package binary<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-alpha2 5.0.0-alpha2 (unstable)]||2017-06-10|| || [https://sourceforge.net/p/gramps/mailman/message/35887819/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.5|4.2.5]]||2016-12-15|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.4|4.2.4]]||2016-09-04|| ||[https://sourceforge.net/p/gramps/mailman/message/35340899/]<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-alpha1 5.0.0-alpha1 (unstable)]||2016-06-04|| || [https://sourceforge.net/p/gramps/mailman/message/35136256/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.3|4.2.3]]||2016-04-10||||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.2|4.2.2]]||2016-01-06||||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.1|4.2.1]]||2015-10-12||||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/4.2.0|4.2.0]]||2015-08-02|||| (Python 3.2+ only / GTK 3.10+ / BSDDB 3) || [[Gramps_4.2_Wiki_Manual|4.2.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.0beta2|4.2.0beta2 (unstable)]] ||2015-07-08|| || [https://sourceforge.net/p/gramps/mailman/message/34280945/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.0beta1|4.2.0beta1 (unstable)]] ||2015-06-21|| || [http://sourceforge.net/p/gramps/mailman/message/34226994/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.1.3|4.1.3]] ||2015-05-01||Thou shalt not count to five||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.9|3.4.9]] ||2015-04-30||I am no longer infected || Final maintenance release in the Gramps 3.4.x series.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.1.2|4.1.2]] ||2015-02-28||That's no ordinary rabbit ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.1.1|4.1.1]] ||2014-10-24||MachineThatGoes...Ping!||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/4.1.0|4.1.0]] ||2014-06-16||Name go in book|| (Full Python 3 support added) || [[Gramps_4.1_Wiki_Manual|4.1.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.8|3.4.8]] ||2014-05-29||Forget about your sin, give the audience a grin||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.4|4.0.4]] ||2014-05-22||Not the comfy chair||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.3|4.0.3]] ||2014-01-27||It's tomorrow, ask me now||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.7|3.4.7]] ||2014-01-27||Ask me tomorrow, but not today||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.2|4.0.2]] ||2013-11-08||Welcome to our humble abode||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.6|3.4.6]] ||2013-10-28||The Answer to the Ultimate Question||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.1|4.0.1]] ||2013-06-24||What is washing when we are on the verge of a great scientific breakthrough?||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.5|3.4.5]] ||2013-05-22||We have also developed a tomato which can eject itself when an accident is imminent||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/4.0.0|4.0.0]] ||2013-05-21||The Miracle Of Birth || (Python 2.7+ or Python 3.2+ / GTK 3.0+ / BSDDB ) || [[Gramps_4.0_Wiki_Manual|4.0.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.4|3.4.4]] ||2013-05-15||The Ministry of Silly Names||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0beta|4.0.0-beta]] (unstable)|| 2013-04-06 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.3|3.4.3]] || 2013-03-19 || Whenever life gets you down, Mrs. Brown ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha5|4.0.0-alpha5]] (unstable)|| 2013-03-06 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha4|4.0.0-alpha4]] (unstable)|| 2013-01-26 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha3|4.0.0-alpha3]] (unstable)|| 2013-01-03 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha2|4.0.0-alpha2]] (unstable)|| 2012-12-31 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha1|4.0.0-alpha1]] (unstable)|| 2012-12-21 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.2|3.4.2]] || 2012-10-28 || We're all individuals! || first [[Building_Gramps_AIO_cx_freeze-based|All-In-One]] (AIO) installer for Windows released by Josip<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.1|3.4.1]] || 2012-08-23 || A tiger? In Africa?! ||[https://gramps-project.org/blog/2012/07/in-memory-of-rob-g-healey/ In Memory of Rob G. Healey].<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.0|3.4.0]] || 2012-05-21 || The "always look on the bright side of life" feature release. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.3.2|3.3.2]] || 2012-05-18 || The Knights who say 'Ni' ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.3.1|3.3.1]] || 2011-10-01 || The Tenth Anniversary Edition ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.3.0|3.3.0]] || 2011-06-12 || Prelude to the next version ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.6|3.2.6]] || 2011-04-30 || So far, so good. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.5|3.2.5]] || 2010-11-17 || I intend to live forever. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.4|3.2.4]] || 2010-10-11 || Tententen || (Re-released due to missing .css file.)<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.4|3.2.4]] || 2010-10-10 || Tententen ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.3|3.2.3]] || 2010-05-16 || I used to eat there. Really good noodles. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.2|3.2.2]] || 2010-04-25 || Mea navis aëricumbens anguillis abundat ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.1|3.2.1]] || 2010-04-21 || One of those men is my father ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.0|3.2.0]] || 2010-03-15 || I am your father || {{bug|3355}}: Name change from GRAMPS to Gramps<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.1.3|3.1.3]] || 2009-12-06 || What Name? ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.1.2|3.1.2]] || 2009-06-06 || Skip the impersonations || The [https://sourceforge.net/p/gramps/mailman/message/23259622/ first] Apple Mac OS X PPC one-click-install Mac package binary [*.DMG] was released by [https://sourceforge.net/p/gramps/mailman/message/22816867/ Emrys Williams]. Previous versions could be installed from source on Apple Mac's using the [https://gramps-project.org/wiki/index.php/Mac_OS_X:Build_from_source:MacPorts MacPorts package manager].<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.1.1|3.1.1]] || 2009-03-09 || Spam, bacon, sausage and spam ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.1.0|3.1.0]] || 2009-03-07 || I am the director of a publishing company. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.0.4|3.0.4]] || 2008-12-06 || All the children sing ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.0.3|3.0.3]] || 2008-10-19 || I have this terrible feeling of déjà vu. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.0.2|3.0.2]] || 2008-09-27 || You look like a milkman to me. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.0.1|3.0.1]] || 2008-05-17 || Don't call me "Señor!" ||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/3.0.0|3.0.0]] || 2008-03-24 || It was just getting interesting. || (Python 2.5+ / PyGTK2 2.10+ / BSDDB ) || [[Gramps_3.0_Wiki_Manual|3.0.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.90.0|2.90.0 (unstable)]] || 2008-01-16 || || [https://sourceforge.net/p/gramps/mailman/message/18352433/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.10|2.2.10]] || 2008-01-13 || Lemon Curry? || Final stable version 2.x.x family of releases [https://web.archive.org/web/20131109141852/http://osdir.com/ml/genealogy.gramps.user/2006-10/msg00107.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.9|2.2.9]] || 2007-10-18 || Here's your ninepence || [https://sourceforge.net/p/gramps/mailman/message/243739/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.8|2.2.8]] || 2007-05-27 || You sons of a silly person || [https://sourceforge.net/p/gramps/mailman/message/243736/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.7|2.2.7]] || 2007-04-22 || Well, I didn't vote for you. || [https://sourceforge.net/p/gramps/mailman/message/243731/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.6|2.2.6]] || 2007-01-29 || Summarize Proust Competition || [https://sourceforge.net/p/gramps/mailman/message/243724/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.5|2.2.5]] || 2007-01-28 || Now go away or I shall taunt you a second time || [https://sourceforge.net/p/gramps/mailman/message/243721/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.4|2.2.4]] || 2006-12-24 || When you're chewing on life's gristle, Don't grumble, give a whistle || [https://sourceforge.net/p/gramps/mailman/message/243717/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.3|2.2.3]] || 2006-11-26 || My philosophy, like color television, is all there in black and white || [https://web.archive.org/web/20131109144033/http://osdir.com/ml/genealogy.gramps.user/2006-11/msg00069.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.2|2.2.2]] || 2006-11-02 || We interrupt this program to annoy you and make things generally irritating || [https://web.archive.org/web/20151011123437/http://osdir.com/ml/genealogy.gramps.user/2006-11/msg00008.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.1|2.2.1]] || 2006-10-29 || One, two, five! || [https://web.archive.org/web/20131109141852/http://osdir.com/ml/genealogy.gramps.user/2006-10/msg00107.html][https://sourceforge.net/p/gramps/mailman/message/243703/] (This release added support for MS-Windows.)[https://web.archive.org/web/20060618000811/http://gramps-project.org/whats_new/][https://gramps-project.org/blog/2006/10/a-major-milestone/]<br />
|-<br />
! style="background-color:#fa8072;" |2.2.0 || || || Due to a slight mistake in the numbering scheme, this version was never released the first 2.2.x version was 2.2.1 || [[User_manual_translations#Gramps_2.2.x_Manual|2.2.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.0rc2|2.2.0rc2 (unstable)]] || 2006-10-24 || What is your quest? || [https://sourceforge.net/p/gramps/mailman/message/11954133/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.0rc1|2.2.0rc1 (unstable)]] || 2006-10-12 || Help, Help! I'm being repressed!|| [https://sourceforge.net/p/gramps/mailman/message/10071193/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.1.95|2.1.95 (unstable)]] || 2006-08-27 || Listen! I can't give it to you now. It says, 'in the event of death'. Uh. Oh! Ah. Ah. Eh. || [https://sourceforge.net/p/gramps/mailman/message/10070989/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.1.91|2.1.91 (unstable)]] || 2006-08-13 || Strange women lying in ponds distributing swords is no basis for a system of government || [https://sourceforge.net/p/gramps/mailman/message/10070928/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.1.0|2.1.0 (unstable)]] || 2006-04-29 || What are you going to do, bleed on me? || [https://web.archive.org/web/20151011071118/http://osdir.com/ml/genealogy.gramps.user/2006-04/msg00080.html][https://sourceforge.net/p/gramps/mailman/message/243687/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.11|2.0.11]] || 2006-04-29 || I will not buy this record, it is scratched || [https://web.archive.org/web/20131109144031/http://osdir.com/ml/genealogy.gramps.user/2006-04/msg00078.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.10|2.0.10]] || 2006-02-27 || Holy Hand Grenade of Antioch || [https://web.archive.org/web/20091025213320/http://osdir.com/ml/genealogy.gramps.user/2006-02/msg00051.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.9|2.0.9]] || 2005-12-11 || Nobody expects the Spanish inquisition! || [https://web.archive.org/web/20131109141633/http://osdir.com/ml/genealogy.gramps.user/2005-12/msg00009.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.8|2.0.8]] || 2005-09-05 || Romani ite domum || [https://web.archive.org/web/20131109144029/http://osdir.com/ml/genealogy.gramps.user/2005-09/msg00010.html] (First port to Macintosh OSX [https://trac.macports.org/ticket/5094 posted to MacPorts]).<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.7|2.0.7]] || 2005-09-04 || Romanes eunt domus || [https://web.archive.org/web/20131109141557/http://osdir.com/ml/genealogy.gramps.user/2005-09/msg00003.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.6|2.0.6]] || 2005-08-15 || Just like my dear papa! || [https://web.archive.org/web/20131109141851/http://osdir.com/ml/genealogy.gramps.user/2005-08/msg00007.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.5|2.0.5]] || 2005-07-05 || It's certainly uncontaminated by cheese || [https://web.archive.org/web/20061005090805/http://gnomedesktop.org/node/2313] [https://web.archive.org/web/20131109141708/http://osdir.com/ml/genealogy.gramps.user/2005-07/msg00011.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.4|2.0.4]] || 2005-06-27 || That's enough music for now, lads. || [https://web.archive.org/web/20131109141815/http://osdir.com/ml/genealogy.gramps.user/2005-06/msg00039.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.3|2.0.3]] || 2005-06-04 || Mynd you, møøse bites Kan be pretty nasti... || [https://web.archive.org/web/20131109144107/http://osdir.com/ml/genealogy.gramps.user/2005-06/msg00010.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.2|2.0.2]] || 2005-06-04 || Little fermented curd will do the trick || [https://web.archive.org/web/20131109141743/http://osdir.com/ml/genealogy.gramps.user/2005-06/msg00007.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.1|2.0.1]] || 2005-05-23 || None shall pass || [https://web.archive.org/web/20131109141739/http://osdir.com/ml/genealogy.gramps.user/2005-05/msg00087.html]<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/2.0.0|2.0.0]] || 2005-05-10 || The bright side of life || [https://web.archive.org/web/20081120074751/http://gnomedesktop.org/node/2246] [https://web.archive.org/web/20131109141517/http://osdir.com/ml/genealogy.gramps.user/2005-05/msg00032.html] ( Python 2.3+ /Gnome 2.8+ /PyGTK2 2.4+ /Gnome-python 2.6 + / BSDDB ) || ??<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.99|1.1.99 (unstable)]] ||2005-04-24|| What… is your favourite colour? || [https://web.archive.org/web/20131109141519/http://osdir.com/ml/genealogy.gramps.devel/2005-04/msg00200.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.95|1.1.95 (unstable)]] ||2005-04-11|| When danger reared its ugly head, he bravely turned his tail and fled || [https://web.archive.org/web/20131109141710/http://osdir.com/ml/genealogy.gramps.user/2005-04/msg00026.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.11|1.0.11]] || 2005-03-19 || What have the Romans done for us? || Final stable version 1.x.x family of releases [https://web.archive.org/web/20131109141635/http://osdir.com/ml/genealogy.gramps.user/2005-03/msg00041.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.90|1.1.90 (unstable)]] ||2005-02-21|| Successful encyclopedia salesman || [https://web.archive.org/web/20131109141553/http://osdir.com/ml/genealogy.gramps.user/2005-02/msg00062.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.10|1.0.10]] || 2005-01-30 || Migrating coconuts || [https://web.archive.org/web/20131109141629/http://osdir.com/ml/genealogy.gramps.user/2005-01/msg00038.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.9|1.0.9]] || 2005-01-29 || Ekki-Ekki-Ekki-Ekki-PTANG. Zoom-Boing. Z'nourrwringmm || [https://web.archive.org/web/20131109141449/http://osdir.com/ml/genealogy.gramps.user/2005-01/msg00037.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.3|1.1.3 (unstable)]] ||2005-01-18 || Splunge: this is a great idea, but possibly lousy, and I’m not being indecisive || [https://web.archive.org/web/20131109144131/http://osdir.com/ml/genealogy.gramps.user/2005-01/msg00015.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.2|1.1.2 (unstable)]] ||2004-12-06|| Confuse-a-cat || [https://web.archive.org/web/20131109141447/http://osdir.com/ml/genealogy.gramps.user/2004-12/msg00024.html] Written completely in Python, so it is platform independent.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.8|1.0.8]] || 2004-10-31 || Sideways completely unexpected deposit || [https://web.archive.org/web/20131109144105/http://osdir.com/ml/genealogy.gramps.user/2004-10/msg00080.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.1|1.1.1 (unstable)]] || 2004-09-27 || Rat cake, rat sorbet, rat pudding, or strawberry tart || [https://web.archive.org/web/20131109144129/http://osdir.com/ml/genealogy.gramps.user/2004-09/msg00075.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.7|1.0.7]] || 2004-08-14 || Run away! Run away! || [https://web.archive.org/web/20131109141712/http://osdir.com/ml/genealogy.gramps.user/2004-08/msg00072.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.6|1.0.6]] || 2004-08-13 || Pink frilly edges || [https://web.archive.org/web/20151013174712/http://osdir.com/ml/genealogy.gramps.user/2004-08/msg00070.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.5|1.0.5]] || 2004-07-31 || Weighs the same as a duck || [https://web.archive.org/web/20131109141450/http://osdir.com/ml/genealogy.gramps.user/2004-07/msg00136.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.0|1.1.0 (unstable)]] || 2004-06-16 ||And now for something completely different || [https://web.archive.org/web/20131109141555/http://osdir.com/ml/genealogy.gramps.user/2004-06/msg00060.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.4|1.0.4]] || 2004-06-15 || Say no more! || [https://web.archive.org/web/20131109141706/http://osdir.com/ml/genealogy.gramps.user/2004-06/msg00049.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.3|1.0.3]] || 2004-04-22 || 'Tis but a scratch! || [https://sourceforge.net/p/gramps/mailman/message/9389641/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.2|1.0.2]] || 2004-04-02 || Pining for the fjords || [https://sourceforge.net/p/gramps/mailman/message/9389540/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.1|1.0.1]] || 2004-02-18 || Revenge of Ed Wood || [https://web.archive.org/web/20061005083907/http://gnomedesktop.org/node/1659]<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/1.0.0|1.0.0]] || 2004-02-11 || Stable as a tombstone || [https://sourceforge.net/p/gramps/mailman/message/243625/] (Python 1.5.2+, Gnome 1.2+, PyGnome 1.0.53+ / XML ) || ??<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.99|0.99]] || 2004-01-27 || || [https://sourceforge.net/p/gramps/mailman/message/7576008/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.98.0|0.98.0]] || 2003-12-08 || Round me off || [https://web.archive.org/web/20070309063026/http://gnomedesktop.org:80/node/1509][https://web.archive.org/web/20041114035829/http://sourceforge.net:80/project/shownotes.php?release_id=202314 0.98.0]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.5|0.9.5]] || 2003-10-07 || Fix me up || [https://web.archive.org/web/20061005085326/http://www.gnomedesktop.org/node/1385] The current "Fix me up" release is a one-bug-fix release. It corrects the nasty interface problem that slipped into 0.9.4. The bug surfaced after merging/deleting people. No data could be damaged by this bug, but it was inconvenient enough to justify a new release.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.4|0.9.4]] || 2003-09-29 || This used to bug me || [https://web.archive.org/web/20061005085041/http://gnomedesktop.org/node/1369][https://web.archive.org/web/20040921005402/http://sourceforge.net:80/project/shownotes.php?group_id=25770&release_id=187598 0.9.4]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.3|0.9.3]] || 2003-07-15 || || [https://sourceforge.net/p/gramps/mailman/message/243618/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.2|0.9.2]] || 2003-06-01 || || [https://sourceforge.net/p/gramps/mailman/message/243617/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.1|0.9.1]] || 2003-04-20 || || [https://sourceforge.net/p/gramps/mailman/message/243615/]requires GNOME 2.0 or greater<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.0|0.9.0]] || 2003-02-16 || || [https://web.archive.org/web/20100916062938/http://www.gnomedesktop.org:80/node/940] the first version for GNOME 2<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.8.1|0.8.1]] || 2002-12-01 || || [https://sourceforge.net/p/gramps/mailman/message/243613/]If your system is running<br />
GNOME 1.4 or earlier, you should use 0.8.1<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.8.0|0.8.0]] || 2002-08-20 || || [https://sourceforge.net/p/gramps/mailman/message/243611/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.7.3|0.7.3]] || 2002-05-06 || || [https://sourceforge.net/p/gramps/mailman/message/243610/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.7.2|0.7.2]] || 2002-03-16 || || [https://sourceforge.net/p/gramps/mailman/message/243608/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.7.1|0.7.1]] || 2002-01-26 || || [https://sourceforge.net/p/gramps/mailman/message/243607/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.7.0|0.7.0]] || 2001-12-24 || || [https://sourceforge.net/p/gramps/mailman/message/243605/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.6.2|0.6.2]] || 2001-11-18 || || [https://sourceforge.net/p/gramps/mailman/message/243604/]<br />
|- <br />
| style="background-color:#fa8072;" |[[Template:Releases/0.6.1|0.6.1]] || 2001-11-10 || || [https://sourceforge.net/p/gramps/mailman/message/243603/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.6.0|0.6.0]] || 2001-11-09 || || [https://sourceforge.net/p/gramps/mailman/message/243602/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.5.1|0.5.1]] || 2001-09-30 || || [https://sourceforge.net/p/gramps/mailman/message/243601/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.5.0|0.5.0]] || 2001-09-19 || || [https://sourceforge.net/p/gramps/mailman/message/243599/]first release to include online documentation[https://sourceforge.net/p/gramps/mailman/message/5247647/]<br />
|- <br />
| style="background-color:#fa8072;" |[[Template:Releases/0.4.1|0.4.1]] || 2001-08-13 || || [https://sourceforge.net/p/gramps/mailman/message/243598/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.4.0|0.4.0]] || 2001-08-09 || || [https://sourceforge.net/p/gramps/mailman/message/243597/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.3.2|0.3.2]] || 2001-07-06 || || [https://sourceforge.net/p/gramps/mailman/message/243596/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.3.1|0.3.1]] || 2001-06-23 || || [https://sourceforge.net/p/gramps/mailman/message/243595/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.3.0|0.3.0]] || 2001-06-17 || || [https://sourceforge.net/p/gramps/mailman/message/243594/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.2.0|0.2.0]] || 2001-06-03 || || [https://sourceforge.net/p/gramps/mailman/message/243592/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.5|0.1.5]] || 2001-05-26 || || [https://sourceforge.net/p/gramps/mailman/message/5247516/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.4|0.1.4]] || 2001-05-19 || || [https://sourceforge.net/p/gramps/mailman/message/5661822/]First release to support internationalization<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.3|0.1.3]] || 2001-05-05 || || [https://sourceforge.net/p/gramps/mailman/message/243588/]Added support for the ISO-8859-1 character and ANSEL encoding in GEDCOM files.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.2|0.1.2]] || 2001-04-27 || || <br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.1|0.1.1]] || 2001-04-21 || || This is the first release of GRAMPS! By [https://gramps-project.org/blog/2006/04/looking-back-over-5-years/ Don Allingham] (Don originally called the program ''Relativity'' before his father suggested the name GRAMPS (Genealogical Research and Analysis Management Programming System)). Created to run on a RedHat 7.X Linux system.<br />
|-|}<br />
<br />
== See also ==<br />
* [[News|Changelog]]<br />
* [[History of Gramps]]<br />
* [https://sourceforge.net/projects/gramps/files/Stable/ Archival stable versions of the Gramps application] on SourceForge<br />
* [[User_manual_translations#superseded|Archival editions of the Gramps Wiki Manual]]<br />
* [[Features#Checklist]] - table<br />
* [[Gramps XML]] - archival format definition (used as the database for the original 1.x.x versions.)<br />
* [[What to do for a release]]<br />
* [[User:Sam888#Gramps_Downloads_.28since:_2001.2F04.2F21.29|Rough download statistics]]<br />
<br />
[[Category:Community/General]]<br />
[[Category:Documentation]]<br />
[[Category:Versions|*]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=News&diff=103399
News
2024-03-25T00:34:54Z
<p>Nick H: 5.2.1 released</p>
<hr />
<div>{{languages|News|}}<br />
<section begin=news_mainpage /><br />
{{Releases/5.2.1}}<br />
{{Releases/5.2.0}}<br />
<section end=news_mainpage /><br />
<section begin=Archive /><br />
{{Releases/5.1.6}}<br />
{{Releases/5.1.5}}<br />
{{Releases/5.1.4}}<br />
{{Releases/5.1.3}}<br />
{{Releases/5.1.2}}<br />
{{Releases/5.1.1}}<br />
{{Releases/5.1.0}}<br />
{{Releases/5.0.2}}<br />
{{Releases/5.0.1}}<br />
{{Releases/5.0.0}}<br />
{{Releases/4.2.8}}<br />
{{Releases/4.2.7}}<br />
{{Releases/4.2.6}}<br />
{{Releases/4.2.5}}<br />
{{Releases/4.2.4}}<br />
{{Releases/4.2.3}}<br />
{{Releases/4.2.2}}<br />
{{Releases/4.2.1}}<br />
{{Releases/4.2.0}}<br />
{{Releases/4.1.3}}<br />
{{Releases/3.4.9}}<br />
{{Releases/4.1.2}}<br />
{{Releases/4.1.1}}<br />
{{Releases/4.1.0}}<br />
{{Releases/3.4.8}}<br />
{{Releases/4.0.4}}<br />
{{Releases/3.4.7}}<br />
{{Releases/4.0.3}}<br />
{{Releases/4.0.2}}<br />
{{Releases/3.4.6}}<br />
{{Releases/4.0.1}}<br />
{{Releases/3.4.5}}<br />
{{Releases/4.0.0}}<br />
{{Releases/3.4.4}}<br />
{{Releases/4.0.0beta}}<br />
{{Releases/3.4.3}}<br />
{{Releases/4.0.0alpha5}}<br />
{{Releases/4.0.0alpha4}}<br />
{{Releases/4.0.0alpha3}}<br />
{{Releases/4.0.0alpha2}}<br />
{{Releases/4.0.0alpha1}}<br />
{{Releases/3.4.2}}}<br />
{{Releases/3.4.1}}<br />
{{Releases/3.4.0}}<br />
{{Releases/3.3.2}}<br />
{{Announcements/20101204_LGCD}}<br />
{{Releases/3.3.1}}<br />
{{Releases/3.3.0}}<br />
{{Releases/3.2.6}}<br />
{{Releases/3.2.5}}<br />
{{Releases/3.2.4}}<br />
{{Releases/3.2.3}}<br />
{{Releases/3.2.2}}<br />
{{Releases/3.2.1}}<br />
{{Releases/3.2.0}}<br />
{{Releases/3.1.3}}<br />
{{Releases/3.1.2}}<br />
{{Releases/3.1.1}}<br />
{{Releases/3.1.0}}<br />
{{Releases/3.0.4}}<br />
{{Releases/3.0.3}}<br />
{{Releases/3.0.2}}<br />
{{Announcements/20080630 LGCD}}<br />
{{Releases/3.0.1}}<br />
{{Releases/3.0.0}}<br />
{{Releases/2.2.10}}<br />
{{Announcements/2007304 LGCD}}<br />
<section end=Archive /><br />
<br />
<noinclude>[[Category:Documentation]]</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:Releases/5.2.1&diff=103398
Template:Releases/5.2.1
2024-03-25T00:33:21Z
<p>Nick H: Created</p>
<hr />
<div>{{Release|5.2.1| '''2024.03.24'''<br />
<br />
Gramps team releases version '''5.2.1''', A '''new maintenance release'''. <br />
<br />
* Updated translations: de_AT, fi, fr, ga, he, it, nb_NO, pl, sk, sr, tr, uk, zh_Hans.<br />
* {{bug|13233}}: Fix error when installing an addon that will not be registered.<br />
* {{bug|13232}}: Allow experimental and beta plugins to be registered.<br />
* Tidy up the README file.<br />
* Fix fan charts on HiDPI screens.<br />
* {{bug|10016}}: Replace PIL with Pillow in the README.<br />
* {{bug|12579}}: Fix the Tag.is_empty() method. The `Tag.is_empty()` method was returning the inverse of the expected value.<br />
* {{bug|13228}}: Cannot create Place with coordinates via Geography.<br />
* {{bug|13222}}: Fix place title when place names use open spans.<br />
* {{bug|13221}}: Fix the addon translator language for core translations.<br />
* Update AIO minimum Windows version requirement to 8.1 64-bit.<br />
* Prevent unwanted output in unit test logs.<br />
* {{bug|13212}}: Fix unit tests when run with Python 3.12.<br />
* Revert Death fallback symbol from Latin Cross to "+".<br />
* {{bug|13194}}: Change the cross mark and check mark symbols used in the Addon Manager Requirements screen to be valid characters on Mac.<br />
* {{bug|13192}}: Fix display of invalid dates in editor citation tabs.<br />
* Include metainfo rather than appdata 'its' files.<br />
* Update AppStream MetaInfo file to conform to latest spec.<br />
* {{bug|13187}}: Fix filter rules missing the use_case parameter.<br />
* Rename metadata file to follow spec.<br />
* Add release information to appdata.<br />
* Package Gramps 5.2.0 on macOS.<br />
}}<br />
<br />
See the [https://gramps-project.org/bugs/changelog_page.php?version_id=112 Changelog].<br />
<noinclude>{{languages|Template:Releases/5.2.1}}</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=What_to_do_for_a_release&diff=103397
What to do for a release
2024-03-24T23:12:48Z
<p>Nick H: /* Working on VERSION */</p>
<hr />
<div>{{man note|Developer notes for '''What to do for a release '''}}<br />
<br />
Note that the main use of this page will be for making a normal "minor" release. If you are making a "major" release (e.g. x.y.0) then you will need to update this page first, to change the numbers. But if you are only making an "alpha" or "beta" release, some steps may be skipped, or altered slightly.<br />
<br />
Note also that there are additional necessary [[What_to_do_for_a_release#Post-release|Post release]] tasks which are related to making a new release. For instance, the wiki will require making a new release-section and updating [[Template:Version_Templates#General|"General" version templates]]. For the making a new release-section on the bug tracker. Or when making new Debian and Mac and Windows [[:Category:Developers/Packaging|packaging]], they will need to be coordinated with the appropriate [[Team#Package_Maintainers|package maintainers]] and updating the corresponding [[:Category:Versions|Versions]] : [[Template:Version_Templates|Templates]]. <br />
<br />
==Pre-release==<br />
===Agree a release timetable===<br />
<br />
Co-ordinate with the [[Team#Package_Maintainers|package maintainers]] to agree a release timetable.<br />
For a major release there may be a schedule on the [[5.2_Roadmap|Roadmap]]<br />
<br />
===Announce a feature freeze===<br />
For a major release, announce a feature freeze on the ''gramps-devel'' mailing list.<br />
This will usually be about 4 weeks before the release date.<br />
<br />
===Translation update===<br />
The translation template should be updated, if necessary, just before the string freeze is announced.<br />
* Check for new files since the last release:<br />
cd po<br />
intltool-update -m <br />
:That will create a file called <code>missing</code>in the <code>po</code> directory if there are new files that need to be scanned for translatable strings. Examine each of the files listed in <code>missing</code>, adding each to <code>POTFILES.in</code> if it contains translatable string constants and to <code>POTFILES.skip</code> if it does not.<br />
* Generate a new template file:<br />
python3 update_po.py -p # makes a new gramps.pot template file<br />
git diff gramps.pot<br />
:Examine the changes. If they're all just comments about where a string is found you need not commit the change (so the next line will restore the official file, instead of the one you just made):<br />
git restore gramps.pot<br />
:If there have been changes on <code>msgid</code> entries, you'll need to commit <code>gramps.pot</code> and ask translators to update their <tt>.po</tt> files before you can make a release:<br />
git add gramps.pot<br />
git commit -m "Update translation template for new release"<br />
<br />
* Check current translation files:<br />
python3 update_po.py -k all<br />
:There should be very few warnings or fatal errors. Warnings related to new languages using default values in their headers are acceptable. There will also be some fatal errors reported due to the non-standard way we handle inflected dates. See the section on [https://gramps-project.org/wiki/index.php/Date_Handler#Localizing_the_date_formats Localizing the date formats] in the [https://gramps-project.org/wiki/index.php/Date_Handler Date Handler] wiki page for further details. For example "{long_month}" may be translated as "{long_month.f[Р]}".<br />
:All other fatal errors should be fixed.<br />
Also see:<br />
* [[Template:Gramps_translations#INCOMPLETE_TRANSLATIONS]] - Update if any translation needs to be added or excluded due to not meeting the minimum 70% completion requirement.<br />
<br />
===Announce a string freeze===<br />
For a major release, announce a string freeze on the ''gramps-devel'' mailing list and on Weblate.<br />
This will usually be about 2 weeks before the release date.<br />
<br />
In the ''Program'' component on Weblate, select "Manage⟶Post announcement" from the menu. Enter an ''Expiry date'' the day before the release date, and select the ''Notify users'' checkbox to send a notification to all subscribed users.<br />
<br />
==Prepare your repository==<br />
* Check out the current stable branch:<br />
git checkout maintenance/gramps{{Stable_branch}}<br />
:That branch name assumes that you're using the same name as the Github repository; if you're not (perhaps you don't use <code>maintenance</code> in the name) use your local name.<br />
* Make sure that your local copy is clean:<br />
git status<br />
: If you have any uncommitted changes, either commit them now or stash them until after you've completed the release.<br />
* Clean up any untracked files and make sure that the local repo is up to date:<br />
git clean -fdx<br />
git pull --rebase<br />
:If you had commits that hadn't been pushed yet they'll show up as "applying" messages in the output of this command. If that's the case re-run the tests and push as usual.<br />
* Build and test to make sure that everything works, then clean the repo of all build products.<br />
<br />
===Check the About box year===<br />
<br />
Check if the year in the {{man label|About}} box needs to be updated<br />
<br />
eg:<br />
''© 2007-2023 The Gramps Developers'' <br />
to<br />
''© 2007-'''2024''' The Gramps Developers''.<br />
<br />
Found in <code>gramps/gen/const.py</code><br />
<br />
===API docs update year===<br />
If needed in the file:<br />
<br />
docs/conf.py<br />
<br />
<br />
Update the year for the copyright.<br />
<br />
copyright = '2001-2024, The Gramps Project'<br />
<br />
===Update Classifier in setup.py===<br />
Change [https://pypi.python.org/pypi?%3Aaction=list_classifiers Classifier] to the appropriate one in [https://github.com/gramps-project/gramps/blob/maintenance/gramps50/setup.py setup.py] (master is always the first one)<br />
<br />
<pre><br />
Development Status :: 1 - Planning<br />
Development Status :: 2 - Pre-Alpha<br />
Development Status :: 3 - Alpha<br />
Development Status :: 4 - Beta<br />
Development Status :: 5 - Production/Stable<br />
</pre><br />
<br />
Check if any additional language classifier needs to be added also.<br />
<br />
==Release name==<br />
Refer to (and update) the [[Previous releases of Gramps|list of previous releases]].<br />
<br />
Previously you needed to select an appropriate name but we have not named releases for several years now. You will still need to add the release though, including things like its relevant color.<br />
<br />
* [[Talk:Previous_releases_of_Gramps|Suggestions]] : For Gramps 5.0 <code>Just remember that you're standing on a planet that's evolving</code><br />
<br />
==Changelog and NEWS file==<br />
<br />
[https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html#section2 Section ''2a''] of the '''G'''eneral '''P'''ublic '''L'''icense says that if you distribute a modified version of a program: ''you must cause the modified files to carry prominent notices stating that you changed the files and the date of any change''. <br />
<br />
Note that the <code>{{version}}</code> below means the ''previous'' version, not the one you're about to release (which is the<br />
<code>..</code>).<br />
git log v{{version}}.. --pretty --numstat --summary --no-merges | git2cl > ChangeLog<br />
git log v{{version}}.. --pretty --numstat --summary --no-merges -- po/*.po | git2cl > po/ChangeLog<br />
git add ChangeLog<br />
git add po/ChangeLog<br />
*Edit and update the <code>NEWS</code> file using the new ChangeLog entries as a guide. If this is the first branch in a new series there will be no NEWS file, so look at a previous release and mimic the format.<br />
Commit the NEWS file:<br />
git add NEWS<br />
git commit -m "Update Changelog and NEWS files"<br />
<br />
==Working on VERSION==<br />
<br />
* Modify <code>[https://github.com/gramps-project/gramps/blob/master/gramps/version.py gramps/version.py]</code> to indicate an official release:<br />
- DEV_VERSION = True<br />
+ DEV_VERSION = False<br />
<br />
* Check that the <code>VERSION_TUPLE</code> reflects the release you're about to make. It should if the version was bumped after the last release. If not, fix it.<br />
<br />
* Add an entry to the [https://github.com/gramps-project/gramps/blob/maintenance/gramps52/data/org.gramps_project.Gramps.metainfo.xml.in org.gramps_project.Gramps.metainfo.xml.in] file.<br />
<br />
* Save the changes:<br />
git commit -am "Release Gramps {{version}}"<br />
<br />
* Check that the version number is correct:<br />
python3 Gramps.py -v<br />
<br />
* If everything looks good, push the changes:<br />
git push origin maintenance/gramps{{Stable_branch}}<br />
* If that fails then someone pushed a commit while you were working. Return to [[What_to_do_for_a_release#Prepare_your_repository|Prepare your repository]] and start over.<br />
<br />
==Create a tag==<br />
Create the release tag; note the '''v''' leading the actual tag.:<br />
git tag -am "Tag {{version}}" v{{version}}<br />
<br />
==Push to repository==<br />
Push the changes to the repository:<br />
git push origin v{{version}}<br />
<br />
===Move to the new release number on branch ===<br />
<br />
Bump the version number in <code>gramps/version.py</code><br />
<br />
Update the version for the release:<br />
VERSION_TUPLE = (4, 2, ...)<br />
<br />
Revert change on <code>DEV_VERSION</code> so that the git revision is appended to the reported version in non-release builds:<br />
- DEV_VERSION = False<br />
+ DEV_VERSION = True<br />
<br />
Save change:<br />
git commit -am "Bump to <new version number>"<br />
git push<br />
<br />
===Github===<br />
* Github generates a tarball automatically when we push a tag.<br />
* Go to [https://github.com/gramps-project/gramps Github] and log in if necessary.<br />
* Select '''NN Releases''' from the line of items just above the thick line ('''NN''' is the number of releases so far).<br />
* Find the tag you just pushed and click it, or click the "Draft a new release" button.<br />
* Copy the NEWS file contents into the '''Write''' tab. You can use the '''Preview''' tab to check your formatting.<br />
* Click '''Publish Release''' at the bottom of the edit area when you're satisfied with the contents.<br />
<br />
===SourceForge===<br />
* Go to [https://sourceforge.net/projects/gramps/files/ the SourceForge files page] and log in if necessary.<br />
* Click on '''Stable''' or '''Unstable''' depending on the class of the release you're making.<br />
* Click '''Add Folder''' and name the directory for the release version. Click "'Create'". Click your new folder to enter it.<br />
* You can either download the GitHub-generated tarball or create one locally:<br />
python3 setup.py sdist<br />
* Click '''Add File''' and drag the tarball to the drop area on the web page.<br />
* Copy the release notes from GitHub into a file called README.md and upload it.<br />
<br />
==Announcing the new release==<br />
* update mantisdb(Bug/issue database) and enable the new version via Admin:Projects item for reporting issues. (You will need a high-enough status on the bug tracker in order to do this, so you can ask an appropriate person if you aren't.)<br />
* announce on gramps-announce@lists.sourceforge.net, gramps-devel@lists.sourceforge.net and gramps-users@lists.sourceforge.net (You will need to be a member of all three lists first, to send to them.)<br />
* announce on the Discourse forum in the "[https://gramps.discourse.group/c/gramps-announce Announcements]" category.<br />
* announce on Gramps [https://gramps-project.org/blog/blog/ blog] (File under: [https://gramps-project.org/blog/category/releases/ Gramps Releases] and [https://gramps-project.org/blog/category/news/ News]) (not needed for an alpha or beta release)<br />
* update [[News]] section on this wiki (not needed for an alpha or beta release)<br />
* update the list of [[Previous releases of Gramps|previous releases]]<br />
* update reference to the new version on the [[Template:Version|wiki template]] (not needed for an alpha or beta release)<br />
* Verify other [[:Category:Versions|"version" Wiki templates]] values: Last version, Stable version, etc.<br />
* update [[HeadlineNews]] (not needed for an alpha or beta release)<br />
* update release date on the [[Download]] page (not needed for an alpha or beta release)<br />
* change the Matrix room title and IRC channel title (not needed for an alpha or beta release) <br />
* update the version number at [https://en.wikipedia.org/wiki/Gramps_(software) Wikipedia] (not needed for an alpha or beta release)<br />
<br />
==Post-release==<br />
* merge forward the <code>NEWS</code> file<br />
<br />
=See also=<br />
*Category [[:Category:Versions|Versions]] : [[Template:Version_Templates|Template]]<br />
*Building a distribution to share as on the [[Download]] page<br />
:[[File:Windows_32x32.png]] [[Building Gramps AIO cx freeze-based]] - Updating the MS-Windows 32-bit and 64-bit All-In-One packages<br />
<!--<br />
:[[File:Linux 32x32.png]] please add link to instructions on building Gramps installers for Linux. proofed while building v5.1.3 <br />
:[[File:Beastie 32x32.png]] please add link to instructions on building Gramps installer for BSD. proofed while building v5.1.3 <br />
:[[File:Apple logo black 32x32.png]] please add link to instructions on building Gramps installer for Apple. proofed while building v5.1.3 <br />
--><br />
* [[Brief introduction to Git]]<br />
* [[Running a development version of Gramps]]<br />
* [[:Category:Developers/Packaging]]<br />
* [[:Category:AppData]] - Screenshots used by Appdata - Debian<br />
* [[.dtd and .rng]]<br />
* [[Rollover_for_the_manual|Rollover for the Wiki]] - for major and minor releases. No rollover for maintenance releases.<br />
* [[Special:WhatLinksHere/Template:Bug|List of pages linked to Bug Report template]] - verify the reported issues still apply to the new release. Leave links in place for any issue fixed in maintenance releases. Simply add notations for the version where the fix was applied. Remove links for fixed issues in Rollovers.<br />
<br />
=External links=<br />
* https://github.com/gramps-project<br />
* https://gramps-project.org/cpanel<br />
* https://sourceforge.net/projects/gramps/<br />
<br />
[[Category:Developers/General]]<br />
[[Category:Developers/Packaging]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=What_to_do_for_a_release&diff=102595
What to do for a release
2024-03-11T22:08:48Z
<p>Nick H: /* Working on VERSION */</p>
<hr />
<div>{{man note|Developer notes for '''What to do for a release '''}}<br />
<br />
Note that the main use of this page will be for making a normal "minor" release. If you are making a "major" release (e.g. x.y.0) then you will need to update this page first, to change the numbers. But if you are only making an "alpha" or "beta" release, some steps may be skipped, or altered slightly.<br />
<br />
Note also that there are additional necessary [[What_to_do_for_a_release#Post-release|Post release]] tasks which are related to making a new release. For instance, the wiki will require making a new release-section and updating [[Template:Version_Templates#General|"General" version templates]]. For the making a new release-section on the bug tracker. Or when making new Debian and Mac and Windows [[:Category:Developers/Packaging|packaging]], they will need to be coordinated with the appropriate [[Team#Package_Maintainers|package maintainers]] and updating the corresponding [[:Category:Versions|Versions]] : [[Template:Version_Templates|Templates]]. <br />
<br />
==Pre-release==<br />
===Agree a release timetable===<br />
<br />
Co-ordinate with the [[Team#Package_Maintainers|package maintainers]] to agree a release timetable.<br />
For a major release there may be a schedule on the [[5.2_Roadmap|Roadmap]]<br />
<br />
===Announce a feature freeze===<br />
For a major release, announce a feature freeze on the ''gramps-devel'' mailing list.<br />
This will usually be about 4 weeks before the release date.<br />
<br />
===Translation update===<br />
The translation template should be updated, if necessary, just before the string freeze is announced.<br />
* Check for new files since the last release:<br />
cd po<br />
intltool-update -m <br />
:That will create a file called <code>missing</code>in the <code>po</code> directory if there are new files that need to be scanned for translatable strings. Examine each of the files listed in <code>missing</code>, adding each to <code>POTFILES.in</code> if it contains translatable string constants and to <code>POTFILES.skip</code> if it does not.<br />
* Generate a new template file:<br />
python3 update_po.py -p # makes a new gramps.pot template file<br />
git diff gramps.pot<br />
:Examine the changes. If they're all just comments about where a string is found you need not commit the change (so the next line will restore the official file, instead of the one you just made):<br />
git restore gramps.pot<br />
:If there have been changes on <code>msgid</code> entries, you'll need to commit <code>gramps.pot</code> and ask translators to update their <tt>.po</tt> files before you can make a release:<br />
git add gramps.pot<br />
git commit -m "Update translation template for new release"<br />
<br />
* Check current translation files:<br />
python3 update_po.py -k all<br />
:There should be very few warnings or fatal errors. Warnings related to new languages using default values in their headers are acceptable. There will also be some fatal errors reported due to the non-standard way we handle inflected dates. See the section on [https://gramps-project.org/wiki/index.php/Date_Handler#Localizing_the_date_formats Localizing the date formats] in the [https://gramps-project.org/wiki/index.php/Date_Handler Date Handler] wiki page for further details. For example "{long_month}" may be translated as "{long_month.f[Р]}".<br />
:All other fatal errors should be fixed.<br />
Also see:<br />
* [[Template:Gramps_translations#INCOMPLETE_TRANSLATIONS]] - Update if any translation needs to be added or excluded due to not meeting the minimum 70% completion requirement.<br />
<br />
===Announce a string freeze===<br />
For a major release, announce a string freeze on the ''gramps-devel'' mailing list and on Weblate.<br />
This will usually be about 2 weeks before the release date.<br />
<br />
In the ''Program'' component on Weblate, select "Manage⟶Post announcement" from the menu. Enter an ''Expiry date'' the day before the release date, and select the ''Notify users'' checkbox to send a notification to all subscribed users.<br />
<br />
==Prepare your repository==<br />
* Check out the current stable branch:<br />
git checkout maintenance/gramps{{Stable_branch}}<br />
:That branch name assumes that you're using the same name as the Github repository; if you're not (perhaps you don't use <code>maintenance</code> in the name) use your local name.<br />
* Make sure that your local copy is clean:<br />
git status<br />
: If you have any uncommitted changes, either commit them now or stash them until after you've completed the release.<br />
* Clean up any untracked files and make sure that the local repo is up to date:<br />
git clean -fdx<br />
git pull --rebase<br />
:If you had commits that hadn't been pushed yet they'll show up as "applying" messages in the output of this command. If that's the case re-run the tests and push as usual.<br />
* Build and test to make sure that everything works, then clean the repo of all build products.<br />
<br />
===Check the About box year===<br />
<br />
Check if the year in the {{man label|About}} box needs to be updated<br />
<br />
eg:<br />
''© 2007-2023 The Gramps Developers'' <br />
to<br />
''© 2007-'''2024''' The Gramps Developers''.<br />
<br />
Found in <code>gramps/gen/const.py</code><br />
<br />
===API docs update year===<br />
If needed in the file:<br />
<br />
docs/conf.py<br />
<br />
<br />
Update the year for the copyright.<br />
<br />
copyright = '2001-2024, The Gramps Project'<br />
<br />
===Update Classifier in setup.py===<br />
Change [https://pypi.python.org/pypi?%3Aaction=list_classifiers Classifier] to the appropriate one in [https://github.com/gramps-project/gramps/blob/maintenance/gramps50/setup.py setup.py] (master is always the first one)<br />
<br />
<pre><br />
Development Status :: 1 - Planning<br />
Development Status :: 2 - Pre-Alpha<br />
Development Status :: 3 - Alpha<br />
Development Status :: 4 - Beta<br />
Development Status :: 5 - Production/Stable<br />
</pre><br />
<br />
Check if any additional language classifier needs to be added also.<br />
<br />
==Release name==<br />
Refer to (and update) the [[Previous releases of Gramps|list of previous releases]].<br />
<br />
Previously you needed to select an appropriate name but we have not named releases for several years now. You will still need to add the release though, including things like its relevant color.<br />
<br />
* [[Talk:Previous_releases_of_Gramps|Suggestions]] : For Gramps 5.0 <code>Just remember that you're standing on a planet that's evolving</code><br />
<br />
==Changelog and NEWS file==<br />
<br />
[https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html#section2 Section ''2a''] of the '''G'''eneral '''P'''ublic '''L'''icense says that if you distribute a modified version of a program: ''you must cause the modified files to carry prominent notices stating that you changed the files and the date of any change''. <br />
<br />
Note that the <code>{{version}}</code> below means the ''previous'' version, not the one you're about to release (which is the<br />
<code>..</code>).<br />
git log v{{version}}.. --pretty --numstat --summary --no-merges | git2cl > ChangeLog<br />
git log v{{version}}.. --pretty --numstat --summary --no-merges -- po/*.po | git2cl > po/ChangeLog<br />
git add ChangeLog<br />
git add po/ChangeLog<br />
*Edit and update the <code>NEWS</code> file using the new ChangeLog entries as a guide. If this is the first branch in a new series there will be no NEWS file, so look at a previous release and mimic the format.<br />
Commit the NEWS file:<br />
git add NEWS<br />
git commit -m "Update Changelog and NEWS files"<br />
<br />
==Working on VERSION==<br />
<br />
* Modify <code>[https://github.com/gramps-project/gramps/blob/master/gramps/version.py gramps/version.py]</code> to indicate an official release:<br />
- DEV_VERSION = True<br />
+ DEV_VERSION = False<br />
<br />
* Check that the <code>VERSION_TUPLE</code> reflects the release you're about to make. It should if the version was bumped after the last release. If not, fix it.<br />
<br />
* Add an entry to the [https://github.com/gramps-project/gramps/blob/master/data/org.gramps_project.Gramps.appdata.xml.in org.gramps_project.Gramps.appdata.xml.in] file.<br />
<br />
* Save the changes:<br />
git commit -am "Release Gramps {{version}}"<br />
<br />
* Check that the version number is correct:<br />
python3 Gramps.py -v<br />
<br />
* If everything looks good, push the changes:<br />
git push origin maintenance/gramps{{Stable_branch}}<br />
* If that fails then someone pushed a commit while you were working. Return to [[What_to_do_for_a_release#Prepare_your_repository|Prepare your repository]] and start over.<br />
<br />
==Create a tag==<br />
Create the release tag; note the '''v''' leading the actual tag.:<br />
git tag -am "Tag {{version}}" v{{version}}<br />
<br />
==Push to repository==<br />
Push the changes to the repository:<br />
git push origin v{{version}}<br />
<br />
===Move to the new release number on branch ===<br />
<br />
Bump the version number in <code>gramps/version.py</code><br />
<br />
Update the version for the release:<br />
VERSION_TUPLE = (4, 2, ...)<br />
<br />
Revert change on <code>DEV_VERSION</code> so that the git revision is appended to the reported version in non-release builds:<br />
- DEV_VERSION = False<br />
+ DEV_VERSION = True<br />
<br />
Save change:<br />
git commit -am "Bump to <new version number>"<br />
git push<br />
<br />
===Github===<br />
* Github generates a tarball automatically when we push a tag.<br />
* Go to [https://github.com/gramps-project/gramps Github] and log in if necessary.<br />
* Select '''NN Releases''' from the line of items just above the thick line ('''NN''' is the number of releases so far).<br />
* Find the tag you just pushed and click it, or click the "Draft a new release" button.<br />
* Copy the NEWS file contents into the '''Write''' tab. You can use the '''Preview''' tab to check your formatting.<br />
* Click '''Publish Release''' at the bottom of the edit area when you're satisfied with the contents.<br />
<br />
===SourceForge===<br />
* Go to [https://sourceforge.net/projects/gramps/files/ the SourceForge files page] and log in if necessary.<br />
* Click on '''Stable''' or '''Unstable''' depending on the class of the release you're making.<br />
* Click '''Add Folder''' and name the directory for the release version. Click "'Create'". Click your new folder to enter it.<br />
* You can either download the GitHub-generated tarball or create one locally:<br />
python3 setup.py sdist<br />
* Click '''Add File''' and drag the tarball to the drop area on the web page.<br />
* Copy the release notes from GitHub into a file called README.md and upload it.<br />
<br />
==Announcing the new release==<br />
* update mantisdb(Bug/issue database) and enable the new version via Admin:Projects item for reporting issues. (You will need a high-enough status on the bug tracker in order to do this, so you can ask an appropriate person if you aren't.)<br />
* announce on gramps-announce@lists.sourceforge.net, gramps-devel@lists.sourceforge.net and gramps-users@lists.sourceforge.net (You will need to be a member of all three lists first, to send to them.)<br />
* announce on the Discourse forum in the "[https://gramps.discourse.group/c/gramps-announce Announcements]" category.<br />
* announce on Gramps [https://gramps-project.org/blog/blog/ blog] (File under: [https://gramps-project.org/blog/category/releases/ Gramps Releases] and [https://gramps-project.org/blog/category/news/ News]) (not needed for an alpha or beta release)<br />
* update [[News]] section on this wiki (not needed for an alpha or beta release)<br />
* update the list of [[Previous releases of Gramps|previous releases]]<br />
* update reference to the new version on the [[Template:Version|wiki template]] (not needed for an alpha or beta release)<br />
* Verify other [[:Category:Versions|"version" Wiki templates]] values: Last version, Stable version, etc.<br />
* update [[HeadlineNews]] (not needed for an alpha or beta release)<br />
* update release date on the [[Download]] page (not needed for an alpha or beta release)<br />
* change the Matrix room title and IRC channel title (not needed for an alpha or beta release) <br />
* update the version number at [https://en.wikipedia.org/wiki/Gramps_(software) Wikipedia] (not needed for an alpha or beta release)<br />
<br />
==Post-release==<br />
* merge forward the <code>NEWS</code> file<br />
<br />
=See also=<br />
*Category [[:Category:Versions|Versions]] : [[Template:Version_Templates|Template]]<br />
*Building a distribution to share as on the [[Download]] page<br />
:[[File:Windows_32x32.png]] [[Building Gramps AIO cx freeze-based]] - Updating the MS-Windows 32-bit and 64-bit All-In-One packages<br />
<!--<br />
:[[File:Linux 32x32.png]] please add link to instructions on building Gramps installers for Linux. proofed while building v5.1.3 <br />
:[[File:Beastie 32x32.png]] please add link to instructions on building Gramps installer for BSD. proofed while building v5.1.3 <br />
:[[File:Apple logo black 32x32.png]] please add link to instructions on building Gramps installer for Apple. proofed while building v5.1.3 <br />
--><br />
* [[Brief introduction to Git]]<br />
* [[Running a development version of Gramps]]<br />
* [[:Category:Developers/Packaging]]<br />
* [[:Category:AppData]] - Screenshots used by Appdata - Debian<br />
* [[.dtd and .rng]]<br />
* [[Rollover_for_the_manual|Rollover for the Wiki]] - for major and minor releases. No rollover for maintenance releases.<br />
* [[Special:WhatLinksHere/Template:Bug|List of pages linked to Bug Report template]] - verify the reported issues still apply to the new release. Leave links in place for any issue fixed in maintenance releases. Simply add notations for the version where the fix was applied. Remove links for fixed issues in Rollovers.<br />
<br />
=External links=<br />
* https://github.com/gramps-project<br />
* https://gramps-project.org/cpanel<br />
* https://sourceforge.net/projects/gramps/<br />
<br />
[[Category:Developers/General]]<br />
[[Category:Developers/Packaging]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101668
Download
2024-02-23T18:16:14Z
<p>Nick H: 5.2.0 released</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2024-02-23'''}}|For a list of updates see: ''[[Gramps 5.2 Wiki Manual - What's new?|What's new?]]}} <br />
<br />
{{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]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]<br />
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]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
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.<br />
<br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]<br />
This executable installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
<br />
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.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]<br />
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
<br />
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. <br />
{{-}}<br />
<hr /><br />
<br />
[[File:Bsd daemon.png|128px|left|link=BSD platforms]]<br />
<br />
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]].<br />
<br />
Advanced users can [[Linux:Build from source|build from source]] using the link in the Linux section.<br />
<br />
Further information can be found on the [[BSD platforms]] page in the wiki.<br />
{{-}}<br />
<hr /><br />
<br />
{{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.}}<br />
{{-}}<br />
<br /><br />
{{-}}<br />
== Notes ==<br />
<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> <br />
<br />
[[File:Menubar-FamilyTrees-overview-example-50.png|thumb|right|450px|Menubar - {{man menu|"Family Trees > Make Backup..."}}]]<br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
* Installer [[Team#Package_Maintainers|package maintainers]]<br />
<br />
===Installing Gramps for Desktops===<br />
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.<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps <br />
* [https://www.grampsweb.org/Deployment/ Docker] <br />
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]<br />
<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=HeadlineNews&diff=101667
HeadlineNews
2024-02-23T18:10:05Z
<p>Nick H: 5.2.0 released</p>
<hr />
<div>{{Announcement|Headline News| These are the latest announcements from the Gramps project.<br> They are updated once per day in the Gramps [[Addon:HeadlineNewsGramplet|Headline News Gramplet]].}}<br />
<br />
* [[Download|Gramps 5.2.0]] has been released.<br />
* New versions of [[Third-party Addons]] are ready!<br />
* Join the [[Contact#Forum|Forum]] or one of the [[Contact#Mailing_lists|Mailing Lists]]<br />
* [https://forum.gramps-project.org/ Discourse forum for Gramps]: You can use the forum to [https://gramps.discourse.group/t/tutorial-videos/126 discover tutorial videos], ask questions and get help from the Gramps community. It is also a great place to keep up-to-date with the latest development plans. Feel welcome to have a look anonymously or sign up for an account so that you can interact.<br />
* Make a [https://sourceforge.net/projects/gramps/donate financial contribution/donation to the Gramps project]<br />
* [[Gramps:Site_support|How Can I help?]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:Version_windows_AIO64&diff=101664
Template:Version windows AIO64
2024-02-23T17:56:55Z
<p>Nick H: 5.2.0 released</p>
<hr />
<div>5.2.0<noinclude><br />
[[Category:Developers/Packaging ]]<br />
[[Category:Versions]]<br />
[[Category:Templates]]<br />
</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:Version&diff=101663
Template:Version
2024-02-23T17:55:24Z
<p>Nick H: 5.2.0 released</p>
<hr />
<div>5.2.0<noinclude><br />
==Usage==<br />
<nowiki>{{version}}</nowiki><br />
<br />
==See also==<br />
{{Version Templates}}<br />
<br />
</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:Man_version&diff=101662
Template:Man version
2024-02-23T17:54:54Z
<p>Nick H: 5.2.0 released</p>
<hr />
<div>5.2<noinclude><br />
<br />
''two digit Gramps version number, including fullstop''<br />
==Usage==<br />
<code><nowiki>{{man version}}</nowiki></code> <br />
<br />Note: replaces the ''deprecated'' <code><nowiki>{{Version manual}}</nowiki></code><br />
<br />
'''Example:'''<br /><br />
<code><nowiki>[[Gramps_{{man version}}_Wiki_Manual_-_Navigation#Setting_the_Active_Person|navigating the Active Person]]</nowiki></code><br />
:is rendered as <code><nowiki>[[Gramps_</nowiki>{{man version}}<nowiki>_Wiki_Manual_-_Navigation#Setting_the_Active_Person|navigating the Active Person]]</nowiki></code><br />
==Purpose==<br />
To provide the current Gramps version release number for any page that has inter-wiki [[Help:Links|links]] {{man menu|and is not within the indexed chapters of the user manual. }} This simplifies [[Rollover for the manual|rollover of the wiki to a new version of Gramps]]. <br />
<br />
Reduces the need to update the pages (and multilingual pages) individually, assuming the rest of the user manual title remains the same.<br />
<br />
'''Works only when embedded in normal intra wiki links and not REDIRECTS'''<br />
<br />
===See also ===<br />
* [[Template:Man_button|Template:Man button]]<br />
* [[Template:Man_index|Template:Man index]]<br />
* [[Template:Man_key_press|Template:Man key press]]<br />
* [[Template:Man_key_press/doc|Template:Man key press/doc]]<br />
* [[Template:Man_label|Template:Man label]]<br />
* [[Template:Man_menu|Template:Man menu]]<br />
* [[Template:Man_note|Template:Man note]]<br />
* [[Template:Man_tip|Template:Man tip]]<br />
* [[Template:Man_tooltip|Template:Man tooltip]]<br />
* [[Template:Man_version|Template:Man version]]<br />
* [[Template:Man_warn|Template:Man warn]]<br />
[[Category:Versions]]<br />
[[Category:Templates]]<br />
</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:Stable_branch&diff=101661
Template:Stable branch
2024-02-23T17:54:13Z
<p>Nick H: 5.2.0 released</p>
<hr />
<div>52<noinclude><br />
<br />
''two digit Gramps version number, no fullstop''<br />
==Usage==<br />
<code><nowiki>{{Stable branch}}</nowiki></code><br />
<br />
To provide the current Gramps version release number for any page that has inter-wiki [[Help:Links|links]] and is not within the indexed chapters of the user manual. This simplifies rollover of the wiki to a new version of Gramps. <br />
<br />
Example: the Preference URL for checking for new or updated add-ons:<br />
<br />
<code><nowiki>https://raw.githubusercontent.com/gramps-project/addons/master/gramps{{Stable version}}</nowiki></code><br />
<br />
Reduces the need to update the pages individually, assuming the rest of the URL remains the same.<br />
<br />
'''Works only for normal inter wiki links and not REDIRECTS'''<br />
<br />
[[Category:Developers/Packaging ]]<br />
[[Category:Versions]]<br />
[[Category:Templates]]<br />
</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:Last_branch&diff=101660
Template:Last branch
2024-02-23T17:53:45Z
<p>Nick H: 5.2.0 released</p>
<hr />
<div>51<noinclude><!-- two digit number no fullstop --><br />
[[Category:Developers/Packaging ]]<br />
[[Category:Versions]]<br />
[[Category:Templates]]<br />
</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Previous_releases_of_Gramps&diff=101659
Previous releases of Gramps
2024-02-23T17:52:08Z
<p>Nick H: 5.2.0 released</p>
<hr />
<div><!-- http://sourceforge.net/project/admin/editreleases.php?package_id=109309&group_id=25770 --><br />
{{man note|Looking for the most current release of Gramps?|You may download the Gramps genealogy program 'installer' from the [[Download]] page.}}<br />
This is a list of Gramps and its previous releases.<br />
{| class="wikitable sortable"<br />
|-<br />
!<br />
! Meaning<br />
|-<br />
| style="background-color:#A0E75A;" | Green<br />
| Current version. '''Recommended for all new installs'''<br />
|-<br />
| style="background-color:#f0e68c;" | Yellow<br />
| Still supported (Update to the last release for that version / Strongly Recommended you upgrade to the '''Current version''')<br />
|-<br />
| style="background-color:#66ccff;" | Blue<br />
| Current Public testing version (Unstable/Alpha/Beta/Release Candidate)<br />
|-<br />
| style="background-color:#C0C0C0;" | Silver<br />
| [[Portal:Developers|Development version]] (Git Version - Here be dragons - Recommended only for testing the future of Gramps)<br />
|-<br />
| style="background-color:#fa8072;" | Red<br />
| Not supported (Update to the last release for that version / Strongly Recommended you upgrade to the '''Current version''')<br />
|}<br />
<!-- RELEASE HISTORY - In reverse date order with newest releases at the top with git master as the first entry and oldest at bottom. --><br />
{| class="wikitable sortable"<br />
|-<br />
!Version<br />
!Release Date<br />
!Name<br />
!Notes<br />
!User Manual<br />
|-<br />
| style="background-color:#C0C0C0;" |[https://github.com/gramps-project/gramps Git]||N/A||N/A||Development version (Python 3.8+ only / GTK 3.24+ / SQLite3 / BSDDB 3 (Read-only for upgrades)) / [[:Category:Developers/Roadmap|Developers/Roadmap]] || N/A<br />
|-<br />
| style="background-color:#A0E75A;" |[[Template:Releases/5.2.0|5.2.0]]||2024-02-23|| || Python 3.8+ only / GTK 3.24+ / SQLite3 / BSDDB 3 (Read-only for upgrades)<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-rc1 5.2.0-rc1 (unstable)]||2024-02-09|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-beta2 5.2.0-beta2 (unstable)]||2023-08-25|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-beta1 5.2.0-beta1 (unstable)]||2023-08-01|| ||<br />
|-<br />
| style="background-color:#f0e68c;" |[[Template:Releases/5.1.6|5.1.6]]||2023-06-29|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.5|5.1.5]]||2022-02-05|| || [https://www.reddit.com/r/gramps/comments/zwx62y/new_native_download_of_gramps_515_for_macos_for/ New Native Download of Gramps 5.1.5] for macOS for [https://support.apple.com/en-au/HT211814 Apple Silicon (Arm, aarch64)]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.4|5.1.4]]||2021-07-26|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-dev2 5.2.0-dev2 (unstable)]||2020-09-17|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.2.0-dev1 5.2.0-dev1 (unstable)]||2020-09-17|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.3|5.1.3]]||2020-08-13|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.2|5.1.2]]||2020-01-10|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.1.1|5.1.1]]||2019-09-14|| ||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/5.1.0|5.1.0]]||2019-08-21|| || Python 3.3+ only / GTK 3.12+ / SQLite3 (Default backend) / BSDDB 3 (Legacy backend) || [[Gramps_5.1_Wiki_Manual|5.1.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.0.2|5.0.2]]||2019-08-08|| || Final maintenance release in the Gramps 5.0.x series.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/5.0.1|5.0.1]]||2018-12-20|| ||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/5.0.0|5.0.0]]||2018-07-24|| || (Python 3.2+ only / GTK 3.10+ / BSDDB 3 (Default backend) / SQLite3 (Experimental backend) ) || [[Gramps_5.0_Wiki_Manual|5.0.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-rc1 5.0.0-rc1 (unstable)]||2018-05-20|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-beta1 5.0.0-beta1 (unstable)]||2018-02-18|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.8|4.2.8]]||2018-02-09|| || A one-bug-fix release. It corrects the Geography views for bad 'dbstate.is_open()' Final maintenance release in the Gramps 4.2.x series.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.7|4.2.7]]||2018-02-08|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-alpha3 5.0.0-alpha3 (unstable)]||2017-09-02|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.6|4.2.6]]||2017-08-01|| ||In Memory of [https://github.com/johanpetter Peter Landgren]. The final Apple Mac PPC one-click-install package binary<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-alpha2 5.0.0-alpha2 (unstable)]||2017-06-10|| || [https://sourceforge.net/p/gramps/mailman/message/35887819/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.5|4.2.5]]||2016-12-15|| ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.4|4.2.4]]||2016-09-04|| ||[https://sourceforge.net/p/gramps/mailman/message/35340899/]<br />
|-<br />
| style="background-color:#fa8072;" |[https://github.com/gramps-project/gramps/releases/tag/v5.0.0-alpha1 5.0.0-alpha1 (unstable)]||2016-06-04|| || [https://sourceforge.net/p/gramps/mailman/message/35136256/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.3|4.2.3]]||2016-04-10||||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.2|4.2.2]]||2016-01-06||||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.1|4.2.1]]||2015-10-12||||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/4.2.0|4.2.0]]||2015-08-02|||| (Python 3.2+ only / GTK 3.10+ / BSDDB 3) || [[Gramps_4.2_Wiki_Manual|4.2.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.0beta2|4.2.0beta2 (unstable)]] ||2015-07-08|| || [https://sourceforge.net/p/gramps/mailman/message/34280945/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.2.0beta1|4.2.0beta1 (unstable)]] ||2015-06-21|| || [http://sourceforge.net/p/gramps/mailman/message/34226994/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.1.3|4.1.3]] ||2015-05-01||Thou shalt not count to five||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.9|3.4.9]] ||2015-04-30||I am no longer infected || Final maintenance release in the Gramps 3.4.x series.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.1.2|4.1.2]] ||2015-02-28||That's no ordinary rabbit ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.1.1|4.1.1]] ||2014-10-24||MachineThatGoes...Ping!||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/4.1.0|4.1.0]] ||2014-06-16||Name go in book|| (Full Python 3 support added) || [[Gramps_4.1_Wiki_Manual|4.1.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.8|3.4.8]] ||2014-05-29||Forget about your sin, give the audience a grin||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.4|4.0.4]] ||2014-05-22||Not the comfy chair||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.3|4.0.3]] ||2014-01-27||It's tomorrow, ask me now||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.7|3.4.7]] ||2014-01-27||Ask me tomorrow, but not today||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.2|4.0.2]] ||2013-11-08||Welcome to our humble abode||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.6|3.4.6]] ||2013-10-28||The Answer to the Ultimate Question||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.1|4.0.1]] ||2013-06-24||What is washing when we are on the verge of a great scientific breakthrough?||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.5|3.4.5]] ||2013-05-22||We have also developed a tomato which can eject itself when an accident is imminent||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/4.0.0|4.0.0]] ||2013-05-21||The Miracle Of Birth || (Python 2.7+ or Python 3.2+ / GTK 3.0+ / BSDDB ) || [[Gramps_4.0_Wiki_Manual|4.0.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.4|3.4.4]] ||2013-05-15||The Ministry of Silly Names||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0beta|4.0.0-beta]] (unstable)|| 2013-04-06 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.3|3.4.3]] || 2013-03-19 || Whenever life gets you down, Mrs. Brown ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha5|4.0.0-alpha5]] (unstable)|| 2013-03-06 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha4|4.0.0-alpha4]] (unstable)|| 2013-01-26 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha3|4.0.0-alpha3]] (unstable)|| 2013-01-03 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha2|4.0.0-alpha2]] (unstable)|| 2012-12-31 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/4.0.0alpha1|4.0.0-alpha1]] (unstable)|| 2012-12-21 || ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.2|3.4.2]] || 2012-10-28 || We're all individuals! || first [[Building_Gramps_AIO_cx_freeze-based|All-In-One]] (AIO) installer for Windows released by Josip<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.1|3.4.1]] || 2012-08-23 || A tiger? In Africa?! ||[https://gramps-project.org/blog/2012/07/in-memory-of-rob-g-healey/ In Memory of Rob G. Healey].<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.4.0|3.4.0]] || 2012-05-21 || The "always look on the bright side of life" feature release. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.3.2|3.3.2]] || 2012-05-18 || The Knights who say 'Ni' ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.3.1|3.3.1]] || 2011-10-01 || The Tenth Anniversary Edition ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.3.0|3.3.0]] || 2011-06-12 || Prelude to the next version ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.6|3.2.6]] || 2011-04-30 || So far, so good. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.5|3.2.5]] || 2010-11-17 || I intend to live forever. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.4|3.2.4]] || 2010-10-11 || Tententen || (Re-released due to missing .css file.)<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.4|3.2.4]] || 2010-10-10 || Tententen ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.3|3.2.3]] || 2010-05-16 || I used to eat there. Really good noodles. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.2|3.2.2]] || 2010-04-25 || Mea navis aëricumbens anguillis abundat ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.1|3.2.1]] || 2010-04-21 || One of those men is my father ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.2.0|3.2.0]] || 2010-03-15 || I am your father || {{bug|3355}}: Name change from GRAMPS to Gramps<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.1.3|3.1.3]] || 2009-12-06 || What Name? ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.1.2|3.1.2]] || 2009-06-06 || Skip the impersonations || The [https://sourceforge.net/p/gramps/mailman/message/23259622/ first] Apple Mac OS X PPC one-click-install Mac package binary [*.DMG] was released by [https://sourceforge.net/p/gramps/mailman/message/22816867/ Emrys Williams]. Previous versions could be installed from source on Apple Mac's using the [https://gramps-project.org/wiki/index.php/Mac_OS_X:Build_from_source:MacPorts MacPorts package manager].<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.1.1|3.1.1]] || 2009-03-09 || Spam, bacon, sausage and spam ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.1.0|3.1.0]] || 2009-03-07 || I am the director of a publishing company. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.0.4|3.0.4]] || 2008-12-06 || All the children sing ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.0.3|3.0.3]] || 2008-10-19 || I have this terrible feeling of déjà vu. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.0.2|3.0.2]] || 2008-09-27 || You look like a milkman to me. ||<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/3.0.1|3.0.1]] || 2008-05-17 || Don't call me "Señor!" ||<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/3.0.0|3.0.0]] || 2008-03-24 || It was just getting interesting. || (Python 2.5+ / PyGTK2 2.10+ / BSDDB ) || [[Gramps_3.0_Wiki_Manual|3.0.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.90.0|2.90.0 (unstable)]] || 2008-01-16 || || [https://sourceforge.net/p/gramps/mailman/message/18352433/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.10|2.2.10]] || 2008-01-13 || Lemon Curry? || Final stable version 2.x.x family of releases [https://web.archive.org/web/20131109141852/http://osdir.com/ml/genealogy.gramps.user/2006-10/msg00107.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.9|2.2.9]] || 2007-10-18 || Here's your ninepence || [https://sourceforge.net/p/gramps/mailman/message/243739/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.8|2.2.8]] || 2007-05-27 || You sons of a silly person || [https://sourceforge.net/p/gramps/mailman/message/243736/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.7|2.2.7]] || 2007-04-22 || Well, I didn't vote for you. || [https://sourceforge.net/p/gramps/mailman/message/243731/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.6|2.2.6]] || 2007-01-29 || Summarize Proust Competition || [https://sourceforge.net/p/gramps/mailman/message/243724/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.5|2.2.5]] || 2007-01-28 || Now go away or I shall taunt you a second time || [https://sourceforge.net/p/gramps/mailman/message/243721/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.4|2.2.4]] || 2006-12-24 || When you're chewing on life's gristle, Don't grumble, give a whistle || [https://sourceforge.net/p/gramps/mailman/message/243717/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.3|2.2.3]] || 2006-11-26 || My philosophy, like color television, is all there in black and white || [https://web.archive.org/web/20131109144033/http://osdir.com/ml/genealogy.gramps.user/2006-11/msg00069.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.2|2.2.2]] || 2006-11-02 || We interrupt this program to annoy you and make things generally irritating || [https://web.archive.org/web/20151011123437/http://osdir.com/ml/genealogy.gramps.user/2006-11/msg00008.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.1|2.2.1]] || 2006-10-29 || One, two, five! || [https://web.archive.org/web/20131109141852/http://osdir.com/ml/genealogy.gramps.user/2006-10/msg00107.html][https://sourceforge.net/p/gramps/mailman/message/243703/] (This release added support for MS-Windows.)[https://web.archive.org/web/20060618000811/http://gramps-project.org/whats_new/][https://gramps-project.org/blog/2006/10/a-major-milestone/]<br />
|-<br />
! style="background-color:#fa8072;" |2.2.0 || || || Due to a slight mistake in the numbering scheme, this version was never released the first 2.2.x version was 2.2.1 || [[User_manual_translations#Gramps_2.2.x_Manual|2.2.x]]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.0rc2|2.2.0rc2 (unstable)]] || 2006-10-24 || What is your quest? || [https://sourceforge.net/p/gramps/mailman/message/11954133/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.2.0rc1|2.2.0rc1 (unstable)]] || 2006-10-12 || Help, Help! I'm being repressed!|| [https://sourceforge.net/p/gramps/mailman/message/10071193/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.1.95|2.1.95 (unstable)]] || 2006-08-27 || Listen! I can't give it to you now. It says, 'in the event of death'. Uh. Oh! Ah. Ah. Eh. || [https://sourceforge.net/p/gramps/mailman/message/10070989/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.1.91|2.1.91 (unstable)]] || 2006-08-13 || Strange women lying in ponds distributing swords is no basis for a system of government || [https://sourceforge.net/p/gramps/mailman/message/10070928/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.1.0|2.1.0 (unstable)]] || 2006-04-29 || What are you going to do, bleed on me? || [https://web.archive.org/web/20151011071118/http://osdir.com/ml/genealogy.gramps.user/2006-04/msg00080.html][https://sourceforge.net/p/gramps/mailman/message/243687/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.11|2.0.11]] || 2006-04-29 || I will not buy this record, it is scratched || [https://web.archive.org/web/20131109144031/http://osdir.com/ml/genealogy.gramps.user/2006-04/msg00078.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.10|2.0.10]] || 2006-02-27 || Holy Hand Grenade of Antioch || [https://web.archive.org/web/20091025213320/http://osdir.com/ml/genealogy.gramps.user/2006-02/msg00051.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.9|2.0.9]] || 2005-12-11 || Nobody expects the Spanish inquisition! || [https://web.archive.org/web/20131109141633/http://osdir.com/ml/genealogy.gramps.user/2005-12/msg00009.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.8|2.0.8]] || 2005-09-05 || Romani ite domum || [https://web.archive.org/web/20131109144029/http://osdir.com/ml/genealogy.gramps.user/2005-09/msg00010.html] (First port to Macintosh OSX [https://trac.macports.org/ticket/5094 posted to MacPorts]).<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.7|2.0.7]] || 2005-09-04 || Romanes eunt domus || [https://web.archive.org/web/20131109141557/http://osdir.com/ml/genealogy.gramps.user/2005-09/msg00003.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.6|2.0.6]] || 2005-08-15 || Just like my dear papa! || [https://web.archive.org/web/20131109141851/http://osdir.com/ml/genealogy.gramps.user/2005-08/msg00007.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.5|2.0.5]] || 2005-07-05 || It's certainly uncontaminated by cheese || [https://web.archive.org/web/20061005090805/http://gnomedesktop.org/node/2313] [https://web.archive.org/web/20131109141708/http://osdir.com/ml/genealogy.gramps.user/2005-07/msg00011.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.4|2.0.4]] || 2005-06-27 || That's enough music for now, lads. || [https://web.archive.org/web/20131109141815/http://osdir.com/ml/genealogy.gramps.user/2005-06/msg00039.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.3|2.0.3]] || 2005-06-04 || Mynd you, møøse bites Kan be pretty nasti... || [https://web.archive.org/web/20131109144107/http://osdir.com/ml/genealogy.gramps.user/2005-06/msg00010.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.2|2.0.2]] || 2005-06-04 || Little fermented curd will do the trick || [https://web.archive.org/web/20131109141743/http://osdir.com/ml/genealogy.gramps.user/2005-06/msg00007.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/2.0.1|2.0.1]] || 2005-05-23 || None shall pass || [https://web.archive.org/web/20131109141739/http://osdir.com/ml/genealogy.gramps.user/2005-05/msg00087.html]<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/2.0.0|2.0.0]] || 2005-05-10 || The bright side of life || [https://web.archive.org/web/20081120074751/http://gnomedesktop.org/node/2246] [https://web.archive.org/web/20131109141517/http://osdir.com/ml/genealogy.gramps.user/2005-05/msg00032.html] ( Python 2.3+ /Gnome 2.8+ /PyGTK2 2.4+ /Gnome-python 2.6 + / BSDDB ) || ??<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.99|1.1.99 (unstable)]] ||2005-04-24|| What… is your favourite colour? || [https://web.archive.org/web/20131109141519/http://osdir.com/ml/genealogy.gramps.devel/2005-04/msg00200.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.95|1.1.95 (unstable)]] ||2005-04-11|| When danger reared its ugly head, he bravely turned his tail and fled || [https://web.archive.org/web/20131109141710/http://osdir.com/ml/genealogy.gramps.user/2005-04/msg00026.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.11|1.0.11]] || 2005-03-19 || What have the Romans done for us? || Final stable version 1.x.x family of releases [https://web.archive.org/web/20131109141635/http://osdir.com/ml/genealogy.gramps.user/2005-03/msg00041.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.90|1.1.90 (unstable)]] ||2005-02-21|| Successful encyclopedia salesman || [https://web.archive.org/web/20131109141553/http://osdir.com/ml/genealogy.gramps.user/2005-02/msg00062.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.10|1.0.10]] || 2005-01-30 || Migrating coconuts || [https://web.archive.org/web/20131109141629/http://osdir.com/ml/genealogy.gramps.user/2005-01/msg00038.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.9|1.0.9]] || 2005-01-29 || Ekki-Ekki-Ekki-Ekki-PTANG. Zoom-Boing. Z'nourrwringmm || [https://web.archive.org/web/20131109141449/http://osdir.com/ml/genealogy.gramps.user/2005-01/msg00037.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.3|1.1.3 (unstable)]] ||2005-01-18 || Splunge: this is a great idea, but possibly lousy, and I’m not being indecisive || [https://web.archive.org/web/20131109144131/http://osdir.com/ml/genealogy.gramps.user/2005-01/msg00015.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.2|1.1.2 (unstable)]] ||2004-12-06|| Confuse-a-cat || [https://web.archive.org/web/20131109141447/http://osdir.com/ml/genealogy.gramps.user/2004-12/msg00024.html] Written completely in Python, so it is platform independent.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.8|1.0.8]] || 2004-10-31 || Sideways completely unexpected deposit || [https://web.archive.org/web/20131109144105/http://osdir.com/ml/genealogy.gramps.user/2004-10/msg00080.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.1|1.1.1 (unstable)]] || 2004-09-27 || Rat cake, rat sorbet, rat pudding, or strawberry tart || [https://web.archive.org/web/20131109144129/http://osdir.com/ml/genealogy.gramps.user/2004-09/msg00075.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.7|1.0.7]] || 2004-08-14 || Run away! Run away! || [https://web.archive.org/web/20131109141712/http://osdir.com/ml/genealogy.gramps.user/2004-08/msg00072.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.6|1.0.6]] || 2004-08-13 || Pink frilly edges || [https://web.archive.org/web/20151013174712/http://osdir.com/ml/genealogy.gramps.user/2004-08/msg00070.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.5|1.0.5]] || 2004-07-31 || Weighs the same as a duck || [https://web.archive.org/web/20131109141450/http://osdir.com/ml/genealogy.gramps.user/2004-07/msg00136.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.1.0|1.1.0 (unstable)]] || 2004-06-16 ||And now for something completely different || [https://web.archive.org/web/20131109141555/http://osdir.com/ml/genealogy.gramps.user/2004-06/msg00060.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.4|1.0.4]] || 2004-06-15 || Say no more! || [https://web.archive.org/web/20131109141706/http://osdir.com/ml/genealogy.gramps.user/2004-06/msg00049.html]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.3|1.0.3]] || 2004-04-22 || 'Tis but a scratch! || [https://sourceforge.net/p/gramps/mailman/message/9389641/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.2|1.0.2]] || 2004-04-02 || Pining for the fjords || [https://sourceforge.net/p/gramps/mailman/message/9389540/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/1.0.1|1.0.1]] || 2004-02-18 || Revenge of Ed Wood || [https://web.archive.org/web/20061005083907/http://gnomedesktop.org/node/1659]<br />
|-<br />
! style="background-color:#fa8072;" |[[Template:Releases/1.0.0|1.0.0]] || 2004-02-11 || Stable as a tombstone || [https://sourceforge.net/p/gramps/mailman/message/243625/] (Python 1.5.2+, Gnome 1.2+, PyGnome 1.0.53+ / XML ) || ??<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.99|0.99]] || 2004-01-27 || || [https://sourceforge.net/p/gramps/mailman/message/7576008/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.98.0|0.98.0]] || 2003-12-08 || Round me off || [https://web.archive.org/web/20070309063026/http://gnomedesktop.org:80/node/1509][https://web.archive.org/web/20041114035829/http://sourceforge.net:80/project/shownotes.php?release_id=202314 0.98.0]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.5|0.9.5]] || 2003-10-07 || Fix me up || [https://web.archive.org/web/20061005085326/http://www.gnomedesktop.org/node/1385] The current "Fix me up" release is a one-bug-fix release. It corrects the nasty interface problem that slipped into 0.9.4. The bug surfaced after merging/deleting people. No data could be damaged by this bug, but it was inconvenient enough to justify a new release.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.4|0.9.4]] || 2003-09-29 || This used to bug me || [https://web.archive.org/web/20061005085041/http://gnomedesktop.org/node/1369][https://web.archive.org/web/20040921005402/http://sourceforge.net:80/project/shownotes.php?group_id=25770&release_id=187598 0.9.4]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.3|0.9.3]] || 2003-07-15 || || [https://sourceforge.net/p/gramps/mailman/message/243618/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.2|0.9.2]] || 2003-06-01 || || [https://sourceforge.net/p/gramps/mailman/message/243617/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.1|0.9.1]] || 2003-04-20 || || [https://sourceforge.net/p/gramps/mailman/message/243615/]requires GNOME 2.0 or greater<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.9.0|0.9.0]] || 2003-02-16 || || [https://web.archive.org/web/20100916062938/http://www.gnomedesktop.org:80/node/940] the first version for GNOME 2<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.8.1|0.8.1]] || 2002-12-01 || || [https://sourceforge.net/p/gramps/mailman/message/243613/]If your system is running<br />
GNOME 1.4 or earlier, you should use 0.8.1<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.8.0|0.8.0]] || 2002-08-20 || || [https://sourceforge.net/p/gramps/mailman/message/243611/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.7.3|0.7.3]] || 2002-05-06 || || [https://sourceforge.net/p/gramps/mailman/message/243610/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.7.2|0.7.2]] || 2002-03-16 || || [https://sourceforge.net/p/gramps/mailman/message/243608/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.7.1|0.7.1]] || 2002-01-26 || || [https://sourceforge.net/p/gramps/mailman/message/243607/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.7.0|0.7.0]] || 2001-12-24 || || [https://sourceforge.net/p/gramps/mailman/message/243605/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.6.2|0.6.2]] || 2001-11-18 || || [https://sourceforge.net/p/gramps/mailman/message/243604/]<br />
|- <br />
| style="background-color:#fa8072;" |[[Template:Releases/0.6.1|0.6.1]] || 2001-11-10 || || [https://sourceforge.net/p/gramps/mailman/message/243603/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.6.0|0.6.0]] || 2001-11-09 || || [https://sourceforge.net/p/gramps/mailman/message/243602/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.5.1|0.5.1]] || 2001-09-30 || || [https://sourceforge.net/p/gramps/mailman/message/243601/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.5.0|0.5.0]] || 2001-09-19 || || [https://sourceforge.net/p/gramps/mailman/message/243599/]first release to include online documentation[https://sourceforge.net/p/gramps/mailman/message/5247647/]<br />
|- <br />
| style="background-color:#fa8072;" |[[Template:Releases/0.4.1|0.4.1]] || 2001-08-13 || || [https://sourceforge.net/p/gramps/mailman/message/243598/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.4.0|0.4.0]] || 2001-08-09 || || [https://sourceforge.net/p/gramps/mailman/message/243597/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.3.2|0.3.2]] || 2001-07-06 || || [https://sourceforge.net/p/gramps/mailman/message/243596/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.3.1|0.3.1]] || 2001-06-23 || || [https://sourceforge.net/p/gramps/mailman/message/243595/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.3.0|0.3.0]] || 2001-06-17 || || [https://sourceforge.net/p/gramps/mailman/message/243594/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.2.0|0.2.0]] || 2001-06-03 || || [https://sourceforge.net/p/gramps/mailman/message/243592/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.5|0.1.5]] || 2001-05-26 || || [https://sourceforge.net/p/gramps/mailman/message/5247516/]<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.4|0.1.4]] || 2001-05-19 || || [https://sourceforge.net/p/gramps/mailman/message/5661822/]First release to support internationalization<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.3|0.1.3]] || 2001-05-05 || || [https://sourceforge.net/p/gramps/mailman/message/243588/]Added support for the ISO-8859-1 character and ANSEL encoding in GEDCOM files.<br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.2|0.1.2]] || 2001-04-27 || || <br />
|-<br />
| style="background-color:#fa8072;" |[[Template:Releases/0.1.1|0.1.1]] || 2001-04-21 || || This is the first release of GRAMPS! By [https://gramps-project.org/blog/2006/04/looking-back-over-5-years/ Don Allingham] (Don originally called the program ''Relativity'' before his father suggested the name GRAMPS (Genealogical Research and Analysis Management Programming System)). Created to run on a RedHat 7.X Linux system.<br />
|-|}<br />
<br />
== See also ==<br />
* [[News|Changelog]]<br />
* [[History of Gramps]]<br />
* [https://sourceforge.net/projects/gramps/files/Stable/ Archival stable versions of the Gramps application] on SourceForge<br />
* [[User_manual_translations#superseded|Archival editions of the Gramps Wiki Manual]]<br />
* [[Features#Checklist]] - table<br />
* [[Gramps XML]] - archival format definition (used as the database for the original 1.x.x versions.)<br />
* [[What to do for a release]]<br />
* [[User:Sam888#Gramps_Downloads_.28since:_2001.2F04.2F21.29|Rough download statistics]]<br />
<br />
[[Category:Community/General]]<br />
[[Category:Documentation]]<br />
[[Category:Versions|*]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=News&diff=101658
News
2024-02-23T17:42:08Z
<p>Nick H: 5.2.0 released</p>
<hr />
<div>{{languages|News|}}<br />
<section begin=news_mainpage /><br />
{{Releases/5.2.0}}<br />
{{Releases/5.1.6}}<br />
<section end=news_mainpage /><br />
<section begin=Archive /><br />
{{Releases/5.1.5}}<br />
{{Releases/5.1.4}}<br />
{{Releases/5.1.3}}<br />
{{Releases/5.1.2}}<br />
{{Releases/5.1.1}}<br />
{{Releases/5.1.0}}<br />
{{Releases/5.0.2}}<br />
{{Releases/5.0.1}}<br />
{{Releases/5.0.0}}<br />
{{Releases/4.2.8}}<br />
{{Releases/4.2.7}}<br />
{{Releases/4.2.6}}<br />
{{Releases/4.2.5}}<br />
{{Releases/4.2.4}}<br />
{{Releases/4.2.3}}<br />
{{Releases/4.2.2}}<br />
{{Releases/4.2.1}}<br />
{{Releases/4.2.0}}<br />
{{Releases/4.1.3}}<br />
{{Releases/3.4.9}}<br />
{{Releases/4.1.2}}<br />
{{Releases/4.1.1}}<br />
{{Releases/4.1.0}}<br />
{{Releases/3.4.8}}<br />
{{Releases/4.0.4}}<br />
{{Releases/3.4.7}}<br />
{{Releases/4.0.3}}<br />
{{Releases/4.0.2}}<br />
{{Releases/3.4.6}}<br />
{{Releases/4.0.1}}<br />
{{Releases/3.4.5}}<br />
{{Releases/4.0.0}}<br />
{{Releases/3.4.4}}<br />
{{Releases/4.0.0beta}}<br />
{{Releases/3.4.3}}<br />
{{Releases/4.0.0alpha5}}<br />
{{Releases/4.0.0alpha4}}<br />
{{Releases/4.0.0alpha3}}<br />
{{Releases/4.0.0alpha2}}<br />
{{Releases/4.0.0alpha1}}<br />
{{Releases/3.4.2}}}<br />
{{Releases/3.4.1}}<br />
{{Releases/3.4.0}}<br />
{{Releases/3.3.2}}<br />
{{Announcements/20101204_LGCD}}<br />
{{Releases/3.3.1}}<br />
{{Releases/3.3.0}}<br />
{{Releases/3.2.6}}<br />
{{Releases/3.2.5}}<br />
{{Releases/3.2.4}}<br />
{{Releases/3.2.3}}<br />
{{Releases/3.2.2}}<br />
{{Releases/3.2.1}}<br />
{{Releases/3.2.0}}<br />
{{Releases/3.1.3}}<br />
{{Releases/3.1.2}}<br />
{{Releases/3.1.1}}<br />
{{Releases/3.1.0}}<br />
{{Releases/3.0.4}}<br />
{{Releases/3.0.3}}<br />
{{Releases/3.0.2}}<br />
{{Announcements/20080630 LGCD}}<br />
{{Releases/3.0.1}}<br />
{{Releases/3.0.0}}<br />
{{Releases/2.2.10}}<br />
{{Announcements/2007304 LGCD}}<br />
<section end=Archive /><br />
<br />
<noinclude>[[Category:Documentation]]</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:Releases/5.2.0&diff=101657
Template:Releases/5.2.0
2024-02-23T17:41:06Z
<p>Nick H: Created</p>
<hr />
<div>{{Release|5.2.0| '''2024.02.23'''<br />
<br />
Gramps team releases version '''5.2.0''', A '''new major release'''. <br />
<br />
* Updated translations: ca, cs, da, de, de_AT, en_GB, es, fr, hr, hu, id, it, nb, nl, pl, sk, sl, sv, tr, uk, zh_CN.<br />
* Update development status to production.<br />
* Remove the Trove classifier "Natural Language :: German(Austrian)".<br />
* {{bug|13021}}: Emit a "plugins-reloaded" signal when a new addon is installed. This ensures that the user interface will be updated to include the new addon.<br />
* Fix Windows AIO build.<br />
* Update GitHub actions to latest versions. Some actions are deprecated.<br />
* Package Gramps 5.2.0-rc1 on macOS.<br />
<br />
}}<br />
<br />
See the [https://gramps-project.org/bugs/changelog_page.php?version_id=100 Changelog].<br />
<noinclude>{{languages|Template:Releases/5.2.0}}</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_macOS_computers&diff=101641
Installing Gramps for macOS computers
2024-02-20T18:04:25Z
<p>Nick H: /* Homebrew */</p>
<hr />
<div>{{languages|Download}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
<br />
{{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>]].}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== Application package ==<br />
</span><br />
The [[Mac_OS_X:Application_package|application package]] is the recommended way of installing Gramps on macOS.<br />
<br />
First read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
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 />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== MacPorts ==<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
== Homebrew ==<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is '''not''' a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_macOS_computers&diff=101640
Installing Gramps for macOS computers
2024-02-20T18:03:12Z
<p>Nick H: /* Application package */</p>
<hr />
<div>{{languages|Download}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
<br />
{{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>]].}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== Application package ==<br />
</span><br />
The [[Mac_OS_X:Application_package|application package]] is the recommended way of installing Gramps on macOS.<br />
<br />
First read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
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 />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== MacPorts ==<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
== Homebrew ==<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_macOS_computers&diff=101639
Installing Gramps for macOS computers
2024-02-20T18:00:22Z
<p>Nick H: Remove download sections</p>
<hr />
<div>{{languages|Download}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
<br />
{{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>]].}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== Application package ==<br />
</span><br />
<br />
Before downloading the ready-to-run stand-alone bundle: 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>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
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 />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== MacPorts ==<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
== Homebrew ==<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_macOS_computers&diff=101638
Installing Gramps for macOS computers
2024-02-20T17:57:31Z
<p>Nick H: Flatten MacPorts and Homebrew sections</p>
<hr />
<div>{{languages|Download}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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>]].}}<br />
<br />
<br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]]<br />
Before downloading read the [[Mac OS X:Application package|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
{{-}}<br />
<hr /><br />
<br />
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 />
{{-}}<br />
<br /><br />
<br />
<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== Application package ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before downloading the ready-to-run stand-alone bundle: 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>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
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 />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== MacPorts ==<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
== Homebrew ==<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_macOS_computers&diff=101637
Installing Gramps for macOS computers
2024-02-20T17:54:55Z
<p>Nick H: Rename macOS section</p>
<hr />
<div>{{languages|Download}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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>]].}}<br />
<br />
<br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]]<br />
Before downloading read the [[Mac OS X:Application package|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
{{-}}<br />
<hr /><br />
<br />
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 />
{{-}}<br />
<br /><br />
<br />
<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== Application package ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before downloading the ready-to-run stand-alone bundle: 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>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
<br />
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 />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be built and installed on macOS using MacPorts.<br />
<br />
{{-}}<br />
==== MacPorts ====<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
==== Homebrew ====<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_Windows_computers&diff=101636
Installing Gramps for Windows computers
2024-02-20T17:39:14Z
<p>Nick H: Remove download sections</p>
<hr />
<div>{{languages|Download}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}''</small>|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
<br />
{{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>]].}}<br />
<br />
== All-In-One installer ==<br />
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>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''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'')<br />
<br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{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.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>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 [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
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 />
<br />
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.]]<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
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.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
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.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
== PortableApps.com ==<br />
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]<br />
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.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* 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.<br />
<br />
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.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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]'''<br />
{{-}}<br />
<br />
== Chocolatey NuGet Package ==<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
== Gramps for Windows with MSYS2 ==<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_Windows_computers&diff=101635
Installing Gramps for Windows computers
2024-02-20T17:34:35Z
<p>Nick H: Flatten PortableApps, Chocolatey and MSYS2 sections</p>
<hr />
<div>{{languages|Download}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}''</small>|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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>]].}}<br />
<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
{{-}}<br />
<hr /><br />
<br />
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 />
{{-}}<br />
<br /><br />
<br />
<br />
== All-In-One installer ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
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>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''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'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{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.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>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 [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
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 />
<br />
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.]]<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
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.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
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.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
== PortableApps.com ==<br />
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]<br />
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.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* 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.<br />
<br />
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.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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]'''<br />
{{-}}<br />
<br />
== Chocolatey NuGet Package ==<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
== Gramps for Windows with MSYS2 ==<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_Windows_computers&diff=101634
Installing Gramps for Windows computers
2024-02-20T17:26:57Z
<p>Nick H: Rename MS Windows section</p>
<hr />
<div>{{languages|Download}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}''</small>|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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>]].}}<br />
<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
{{-}}<br />
<hr /><br />
<br />
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 />
{{-}}<br />
<br /><br />
<br />
<br />
== All-In-One installer ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
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>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''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'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{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.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>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 [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
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 />
<br />
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.]]<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
==== PortableApps.com ====<br />
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]<br />
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.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* 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.<br />
<br />
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.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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]'''<br />
<br />
==== Chocolatey NuGet Package ====<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
==== Gramps for Windows with MSYS2 ====<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
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.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
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.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101633
Download
2024-02-20T17:14:13Z
<p>Nick H: Fix broken links</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]<br />
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]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
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.<br />
<br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]<br />
This executable installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
<br />
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.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]<br />
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
<br />
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. <br />
{{-}}<br />
<hr /><br />
<br />
[[File:Bsd daemon.png|128px|left|link=BSD platforms]]<br />
<br />
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]].<br />
<br />
Advanced users can [[Linux:Build from source|build from source]] using the link in the Linux section.<br />
<br />
Further information can be found on the [[BSD platforms]] page in the wiki.<br />
{{-}}<br />
<hr /><br />
<br />
{{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.}}<br />
{{-}}<br />
<br /><br />
{{-}}<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
* Installer [[Team#Package_Maintainers|package maintainers]]<br />
<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descendants of the discontinued [https://wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Software Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps <br />
* [https://www.grampsweb.org/Deployment/ Docker] <br />
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]<br />
<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_Linux_computers&diff=101632
Installing Gramps for Linux computers
2024-02-20T16:54:28Z
<p>Nick H: Flatten out Debian, Flathub and Other Distributions</p>
<hr />
<div>{{languages|Installing Gramps for Linux computers}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
<br />
{{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>]].}}<br />
<br />
== <span id="Linux distributions"></span>Linux distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6<br />
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6<br />
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps Gramps 5.1.6])<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 5.1.5)<br />
* Fedora 38 (Gramps 5.1.6)<br />
* Fedora 39 (Gramps 5.1.6)<br />
* Fedora 40 (Gramps 5.1.6)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.6<br />
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 --><br />
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 --><br />
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 --><br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
|<!-- Notes -->[https://archlinux.org/packages/extra/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
* Gramps 5.1.6 (testing)<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Debian package ==<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
=== Useful command lines ===<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package currently installed on your system and gives you info about it.<br />
<br />
The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on<br />
you can compare the required Dependencies with the new version you downloaded with the following command:<br />
<br />
dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb<br />
<br />
for example, you can get just the two Depends lines to compare using:<br />
<br />
dpkg-query -s gramps | grep Depends:<br />
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
== Flathub ==<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub].<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
== Build from source ==<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}<br />
<br />
You can also try an online demonstration of version 5.1.4 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': <br />
<br />
* https://www.rollapp.com/app/gramps<br />
<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_Linux_computers&diff=101631
Installing Gramps for Linux computers
2024-02-20T16:52:01Z
<p>Nick H: Remove download sections</p>
<hr />
<div>{{languages|Installing Gramps for Linux computers}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
<br />
{{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>]].}}<br />
<br />
== <span id="Linux distributions"></span>Linux distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6<br />
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6<br />
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps Gramps 5.1.6])<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 5.1.5)<br />
* Fedora 38 (Gramps 5.1.6)<br />
* Fedora 39 (Gramps 5.1.6)<br />
* Fedora 40 (Gramps 5.1.6)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.6<br />
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 --><br />
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 --><br />
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 --><br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
|<!-- Notes -->[https://archlinux.org/packages/extra/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
* Gramps 5.1.6 (testing)<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.<br />
<br />
{{man warn|1=Warning before attempting to install the latest Gramps version, use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.<br />
<br />
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.<br />
<br />
If you already have Gramps installed, and you are only making a 'point' upgrade (i.e., from Gramps x.y.z to x.y.z+1, e.g., from 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package currently installed on your system and gives you info about it.<br />
<br />
The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on<br />
you can compare the required Dependencies with the new version you downloaded with the following command:<br />
<br />
dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb<br />
<br />
for example, you can get just the two Depends lines to compare using:<br />
<br />
dpkg-query -s gramps | grep Depends:<br />
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub].<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}<br />
<br />
You can also try an online demonstration of version 5.1.4 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': <br />
<br />
* https://www.rollapp.com/app/gramps<br />
<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_Linux_computers&diff=101630
Installing Gramps for Linux computers
2024-02-20T16:39:20Z
<p>Nick H: Remove BSD section</p>
<hr />
<div>{{languages|Installing Gramps for Linux computers}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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>]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
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_and_BSD_distributions|distribution]] or by installing a FlatPak available from [[Download#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] are available in the wiki.<br />
{{-}}<br />
<hr /><br />
<br />
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 />
{{-}}<br />
<br /><br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
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>]]. <br />
<br />
<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6<br />
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6<br />
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps Gramps 5.1.6])<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 5.1.5)<br />
* Fedora 38 (Gramps 5.1.6)<br />
* Fedora 39 (Gramps 5.1.6)<br />
* Fedora 40 (Gramps 5.1.6)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.6<br />
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 --><br />
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 --><br />
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 --><br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
|<!-- Notes -->[https://archlinux.org/packages/extra/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
* Gramps 5.1.6 (testing)<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.<br />
<br />
{{man warn|1=Warning before attempting to install the latest Gramps version, use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.<br />
<br />
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.<br />
<br />
If you already have Gramps installed, and you are only making a 'point' upgrade (i.e., from Gramps x.y.z to x.y.z+1, e.g., from 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package currently installed on your system and gives you info about it.<br />
<br />
The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on<br />
you can compare the required Dependencies with the new version you downloaded with the following command:<br />
<br />
dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb<br />
<br />
for example, you can get just the two Depends lines to compare using:<br />
<br />
dpkg-query -s gramps | grep Depends:<br />
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub].<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}<br />
<br />
You can also try an online demonstration of version 5.1.4 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': <br />
<br />
* https://www.rollapp.com/app/gramps<br />
<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Installing_Gramps_for_Linux_computers&diff=101629
Installing Gramps for Linux computers
2024-02-20T16:31:42Z
<p>Nick H: Remove BSD distributions</p>
<hr />
<div>{{languages|Installing Gramps for Linux computers}}<br />
{{man warn|1=&#x1F6A7; Work In Progress {{new|5.2.0}}|2=This wikipage is a cloned outline from the Download page. It is being converted to a "Installing" style instead of a "Download". <br />
{{#vardefine:chapter|HowDoI}} <!-- Used in labeling 'Figures' --><br />
Since you are reading '''''this paragraph''''', then the WikiContributor has not progressed to the point of trimming out the excess template material. That means the wikipage is probably not ready for collaborative editing yet. Multiple people editing ''now'' might unintentionally overwrite their work. Please post your (very welcome) suggestion on the '''Discussion''' page instead of directly editing the content. Conversion completion expected by 18 Feb 2024.}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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>]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
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_and_BSD_distributions|distribution]] or by installing a FlatPak available from [[Download#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] are available in the wiki.<br />
{{-}}<br />
<hr /><br />
<br />
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 />
{{-}}<br />
<br /><br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
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>]]. <br />
<br />
<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6<br />
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6<br />
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps Gramps 5.1.6])<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 5.1.5)<br />
* Fedora 38 (Gramps 5.1.6)<br />
* Fedora 39 (Gramps 5.1.6)<br />
* Fedora 40 (Gramps 5.1.6)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.6<br />
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 --><br />
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 --><br />
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 --><br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
|<!-- Notes -->[https://archlinux.org/packages/extra/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
* Gramps 5.1.6 (testing)<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.<br />
<br />
{{man warn|1=Warning before attempting to install the latest Gramps version, use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.<br />
<br />
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.<br />
<br />
If you already have Gramps installed, and you are only making a 'point' upgrade (i.e., from Gramps x.y.z to x.y.z+1, e.g., from 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package currently installed on your system and gives you info about it.<br />
<br />
The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on<br />
you can compare the required Dependencies with the new version you downloaded with the following command:<br />
<br />
dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb<br />
<br />
for example, you can get just the two Depends lines to compare using:<br />
<br />
dpkg-query -s gramps | grep Depends:<br />
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub].<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}<br />
<br />
You can also try an online demonstration of version 5.1.4 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': <br />
<br />
* https://www.rollapp.com/app/gramps<br />
<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descended from the discontinued [https://en.wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Standard Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
* Docker<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=BSD_platforms&diff=101628
BSD platforms
2024-02-20T16:30:24Z
<p>Nick H: Add distributions section</p>
<hr />
<div>==BSD distributions==<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager -->[https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/index.html pkgsrc] ([https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/index.html databases])<br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.6nb1]<br />
|<!-- Notes --> [https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/gramps5/index.html available 5.x.x versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --> [https://ports.freebsd.org/cgi/ports.cgi ports.freebsd.org]<br />
|<!-- Current versions --><br />
* FreeBSD: Gramps [https://cgit.freebsd.org/ports/tree/science/gramps 5.1.6]<br />
* FreshPorts: Gramps [https://www.freshports.org/science/gramps/ 5.1.6]<br />
|<!-- Notes --> [https://ports.freebsd.org/cgi/ports.cgi?query=gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager -->[https://openbsd.app/ OpenBSD.app] <br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.6<br />
|<!-- Notes -->[https://openbsd.app/?search=gramps available versions]<br /> openports.se [https://openports.se/ closed on 30 Jan 2023]<br />
|}<br />
<br />
==Automatic installation==<br />
* Install from [http://openports.se/misc/gramps openports.se/misc/gramps] from the OpenBSD package collection ('''Recommended''')<br />
<br />
Or<br />
<br />
* Install from [http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/gramps3/README.html netbsd.org] from the NetBSD package collection<br />
<br />
Or<br />
<br />
* Install from [http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps freebsd ports]<br />
<br />
Or<br />
<br />
* [http://www.freshports.org/science/gramps/ FreshPorts]<br />
To install the port: cd /usr/ports/science/gramps/ && make install clean<br />
To add the package: pkg_add -r gramps<br />
<br />
==Manual installation==<br />
{{stub}}<br />
Installing Gramps on FreeBSD, openBSD, etc. First make sure the following packages are installed:<br />
* py24-gnome<br />
* py24-gnome-extras<br />
* automake19<br />
* gnomecommon<br />
* autoconf259<br />
* gnu-automake<br />
* gnu-libtool<br />
* gmake <br />
<br />
Then do the following:<br />
* Download and extract the source code:<br />
<pre><br />
$ gunzip gramps-3.2.6.tar.gz<br />
$ tar xvf gramps-3.2.6.tar<br />
</pre><br />
* Configure the source code to use <pre>/usr/X11R6</pre> for its path, since that is where FreeBSD likes to put gtk/gnome stuff:<br />
<pre><br />
$ cd gramps-3.2.6<br />
$ export PATH=/usr/local/gnu-autotools/bin:$PATH<br />
$ export ACLOCAL_FLAGS="-I /usr/local/gnu-autotools/share/aclocal<br />
-I. -I /usr/local/share/aclocal -I /usr/X11R6/share/aclocal"<br />
$ ./autogen.sh<br />
$ gmake<br />
$ gmake install<br />
</pre><br />
<br />
This will compile and install Gramps correctly.<br />
<br />
[[Category:Documentation]]<br />
[[Category:Developers/Packaging]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101627
Download
2024-02-20T16:22:12Z
<p>Nick H: Add BSD section</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]<br />
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_and_BSD_distributions|distribution]] or by installing a [https://wikipedia.org/wiki/Flatpak FlatPak] available from [[Installing_Gramps_for_Linux_computers#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] or [[Installing_Gramps_for_Linux_computers#Debian-based|install a Debian package]] are available in the wiki.<br />
<br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]<br />
This executable installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
<br />
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.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]<br />
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
<br />
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. <br />
{{-}}<br />
<hr /><br />
<br />
[[File:Bsd daemon.png|128px|left|link=BSD platforms]]<br />
<br />
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 [[Installing_Gramps_for_Linux_computers#Linux_and_BSD_distributions|distribution]].<br />
<br />
Advanced users can [[Linux:Build from source|build from source]] using the link in the Linux section.<br />
<br />
Further information can be found on the [[BSD platforms]] page in the wiki.<br />
{{-}}<br />
<hr /><br />
<br />
{{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.}}<br />
{{-}}<br />
<br /><br />
{{-}}<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
* Installer [[Team#Package_Maintainers|package maintainers]]<br />
<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descendants of the discontinued [https://wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Software Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps <br />
* [https://www.grampsweb.org/Deployment/ Docker] <br />
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]<br />
<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101626
Download
2024-02-20T15:26:25Z
<p>Nick H: Update Windows alternatives</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]<br />
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_and_BSD_distributions|distribution]] or by installing a [https://wikipedia.org/wiki/Flatpak FlatPak] available from [[Installing_Gramps_for_Linux_computers#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] or [[Installing_Gramps_for_Linux_computers#Debian-based|install a Debian package]] are available in the wiki.<br />
<br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]<br />
This executable installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
<br />
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.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]<br />
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
<br />
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. <br />
{{-}}<br />
<hr /><br />
<br />
{{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.}}<br />
{{-}}<br />
<br /><br />
{{-}}<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
* Installer [[Team#Package_Maintainers|package maintainers]]<br />
<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descendants of the discontinued [https://wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Software Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps <br />
* [https://www.grampsweb.org/Deployment/ Docker] <br />
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]<br />
<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101625
Download
2024-02-20T15:16:30Z
<p>Nick H: Update Mac alternatives</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]<br />
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_and_BSD_distributions|distribution]] or by installing a [https://wikipedia.org/wiki/Flatpak FlatPak] available from [[Installing_Gramps_for_Linux_computers#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] or [[Installing_Gramps_for_Linux_computers#Debian-based|install a Debian package]] are available in the wiki.<br />
<br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]<br />
This executable installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
<br />
There are [[Installing Gramps for Windows computers|installation alternatives to these All-In-One executable installers for Windows]], including the PortableApps and Chocolatey NuGet Package. <br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]<br />
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
<br />
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. <br />
{{-}}<br />
<hr /><br />
<br />
{{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.}}<br />
{{-}}<br />
<br /><br />
{{-}}<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
* Installer [[Team#Package_Maintainers|package maintainers]]<br />
<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descendants of the discontinued [https://wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Software Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps <br />
* [https://www.grampsweb.org/Deployment/ Docker] <br />
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]<br />
<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101624
Download
2024-02-20T15:01:54Z
<p>Nick H: Update alternative installation instructions for Linux</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]<br />
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_and_BSD_distributions|distribution]] or by installing a [https://wikipedia.org/wiki/Flatpak FlatPak] available from [[Installing_Gramps_for_Linux_computers#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] or [[Installing_Gramps_for_Linux_computers#Debian-based|install a Debian package]] are available in the wiki.<br />
<br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]<br />
This executable installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
<br />
There are [[Installing Gramps for Windows computers|installation alternatives to these All-In-One executable installers for Windows]], including the PortableApps and Chocolatey NuGet Package. <br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]<br />
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
<br />
There are [[Installing Gramps for macOS computers|installation alternatives to these Apple Disk Image files for macOS]], including the MacPorts and Homebrew package managers. <br />
{{-}}<br />
<hr /><br />
<br />
{{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.}}<br />
{{-}}<br />
<br /><br />
{{-}}<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
* Installer [[Team#Package_Maintainers|package maintainers]]<br />
<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descendants of the discontinued [https://wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Software Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps <br />
* [https://www.grampsweb.org/Deployment/ Docker] <br />
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]<br />
<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101623
Download
2024-02-20T14:57:56Z
<p>Nick H: Fix image links</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Installing_Gramps_for_Linux_computers]]<br />
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_and_BSD_distributions|distribution]] or by installing a [https://wikipedia.org/wiki/Flatpak FlatPak] available from [[Installing_Gramps_for_Linux_computers#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] are available in the wiki.<br />
<br />
There are [[Installing Gramps for Linux computers|command line installation alternatives and package manager versions specific to the various Linux distributions]]. <br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Installing Gramps for Windows computers]]<br />
This executable installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
<br />
There are [[Installing Gramps for Windows computers|installation alternatives to these All-In-One executable installers for Windows]], including the PortableApps and Chocolatey NuGet Package. <br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Installing Gramps for macOS computers]]<br />
Before downloading read the [[Mac_OS_X:Application_package#Before_installation|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
<br />
There are [[Installing Gramps for macOS computers|installation alternatives to these Apple Disk Image files for macOS]], including the MacPorts and Homebrew package managers. <br />
{{-}}<br />
<hr /><br />
<br />
{{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.}}<br />
{{-}}<br />
<br /><br />
{{-}}<br />
== Notes ==<br />
<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> <br />
<br />
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. <br />
<br />
See: [[How to make a backup]]<br />
<br />
== See also ==<br />
* Installer [[Team#Package_Maintainers|package maintainers]]<br />
<br />
===Installing Gramps for Desktops===<br />
* on [[Installing Gramps for Linux computers|Linux distributions]]<br />
* on [[Installing Gramps for macOS computers|macOS]]<br />
* on [[Installing Gramps for Windows computers|Windows]]<br />
* on [[Installing_Gramps_for_Linux_computers#BSD|BSD]] (descendants of the discontinued [https://wikipedia.org/wiki/Berkeley_Software_Distribution Berkeley Software Distribution])<br />
<br />
===GitHub Gramps for Desktops Releases===<!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
===Installing Gramps Web for online collaboration===<br />
[https://gramps-project.org/blog/web/ Gramps Web] is a frontend for a hosted instance of Gramps <br />
* [https://www.grampsweb.org/Deployment/ Docker] <br />
* [https://www.grampsweb.org/LetsEncrypt/ Let's Encrypt and Docker Compose]<br />
<br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:New&diff=101564
Template:New
2024-02-16T17:50:55Z
<p>Nick H: </p>
<hr />
<div><includeonly>&mdash;&nbsp;⚡<small>''new for version {{{1}}}''</small></includeonly><noinclude>This '''New''' template generates formatted text to indicate new functionality in a given version.<br><br>It takes only one parameter, which is the version that implements the new functionality. The template then creates formatted text. eg:<br><br><nowiki>{{</nowiki>new|''5.2''}}<br><br>will be shown as: <br><br>&mdash;&nbsp;⚡<small>''new for version 5.2''</small>[[Category:Templates]]</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Addons_development&diff=101563
Addons development
2024-02-16T17:48:40Z
<p>Nick H: /* What can addons extend? */</p>
<hr />
<div>{{man tip|Information on developing Gramps addons|If you are looking for addons to install, visit: [[Third-party Addons]]}}<br />
{{man warn|Note that this article anticipates that most addons will be developed under Linux.|([[Getting started with Gramps development|Linux is the principal development platform.]]) While it is possible to do so under Windows or MacOS, some of the steps will differ and the documented processes have not been as thoroughly reviewed. So developer beware.<br>See [[Portal:Developers]]}}<br />
If you are developing a [[Third-party Addons|Third-party Addon]]; this page documents the API, methods, and best practices for Gramps 4.2 and later. <br />
<br />
==What can addons extend?==<br />
Addons for Gramps can extend the program in many different ways. You can add any of the following [https://github.com/gramps-project/gramps/blob/master/gramps/gen/plug/_pluginreg.py types] of addons:<br />
<br />
<!-- sync with https://gramps-project.org/wiki/index.php?title=Addon_list_legend&action=edit&section=2 --> <br />
* '''Importer''' (IMPORT) - adds additional file format import options to Gramps<br />
* '''Exporter''' (EXPORT) - adds additional file format export options to Gramps<br />
* '''[[Gramps_Glossary#gramplet|Gramplet]]''' (GRAMPLET) - adds a new interactive interface section to a Gramps view mode, which can be activated by right-clicking on the dashboard View or from the menu of the Sidebar/Bottombar in the other view categories. <br />
* '''Gramps [[Gramps_Glossary#viewmode|View ''(mode)'']]''' (VIEW) - adds a new view mode to the list of views available within a [[Gramps_Glossary#view|View Category]]<br />
* '''[[Map_Services|Map Service]]''' (MAPSERVICE) - adds new mapping options to Gramps<br />
* '''Plugin lib''' (GENERAL) - libraries that are present giving extra functionality. Can add, replace and or modifies built-in Gramps options.<br />
* '''[[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quickreport'''/'''Quickview]]''' (QUICKREPORT) - a view that you can run by right-clicking on object, or if a person quickview, then through the Quick View Gramplet<br />
* '''[[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_1|Report]]''' (REPORT) - adds a new output report / includes '''Website''' - output a static genealogy website based on your Gramps Family Tree data.<br />
* '''[[Gramps_{{man version}}_Wiki_Manual_-_Filters#Add_Rule_dialog|Rule]]''' (RULE) - adds new [[Gramps_Glossary#filter|filter]] rules. {{new|5.1}}<br />
* '''[[Gramps_{{man version}}_Wiki_Manual_-_Tools|Tool]]''' (TOOL) - adds a utility that helps process data from your family tree.<br />
* '''Doc creator''' (DOCGEN)<br />
* '''Relationships''' (RECALC)<br />
* '''Sidebar''' (SIDEBAR)<br />
* '''[[Database_Backends|Database]]''' (DATABASE) - add support for another database backend. {{new|5.0}}<br />
* '''Thumbnailer''' (THUMBNAILER) {{new|5.2}}<br />
* '''Citation formatter''' (CITE) {{new|5.2}}<br />
<br />
==Writing an addon==<br />
Writing an addon is fairly straightforward if you have just a little bit of Python experience. And sharing your addon is the right thing to do. The general steps to writing an addon and sharing your own addons are:<br />
<br />
# [[#Develop_your_addon|Develop your addon]]<br />
# [[#Create_a_Gramps_Plugin_Registration_file|Create a Gramps Plugin Registration file (.gpr.py)]]<br />
# [[#internationalization|Invite translation of your addon]] into multiple natural languages<br />
# [[#Package_your_addon|Package your addon]]<br />
# [[#List_and_document_your_addon_on_the_wiki|Document your addon]] and publish it to the addon list<br />
# [[#List_your_addon_in_the_Gramps_Plugin_Manager|Register your addon with the Plugin Manager]]<br />
# [[#Announce_the_addon|Announce it on the Gramps Forum]] - Let users know it exist and how to use it.<br />
# [[#Support_it_through_issue_tracker|Support it through the issue tracker]]<br />
# [[#Maintain_the_code_as_Gramps_continues_to_evolve|Maintain the code]] as Gramps continues to evolve<br />
<br />
We'll now expand upon each of these steps individually.<br />
<br />
== Develop your addon ==<br />
<br />
The [http://github.com/gramps-project/addons-source addons-source] repository holds the source code for the addons with branches holding the version for different gramps. If you are working on an addon for gramps for the current Gramps {{man version}} public release, be sure to use the maintenance/gramps51 git branch, as the default is master branch for the developmental pre-release. (Currently gramps 5.2, which is not the typical target for addons.) <br />
<br />
Example commands are shown below referring to the public release rather than the master branch.<br />
<br />
The developers are currently merging changes to the most recent maintenance branch into master as necessary, so you don't have to do anything for that unless you are in a hurry. <br />
<br />
The [http://github.com/gramps-project/addons-source addons-source] git repository has the following structure, with the code for each addon in its own folder:<br />
<br />
* /addons-source<br />
** /''IndividualNameOfAddon1''<br />
** /''IndividualNameOfAddon2''<br />
** ...<br />
<br />
The [http://github.com/gramps-project/addons addons] git repository holds built versions of the addons for each release of Gramps, and has the following structure:<br />
<br />
* /addons<br />
** [https://github.com/gramps-project/addons/tree/master/gramps42 /gramps42]<br />
*** /download<br />
*** /listings<br />
** [https://github.com/gramps-project/addons/tree/master/gramps50 /gramps50]<br />
*** /download<br />
*** /listings<br />
** [https://github.com/gramps-project/addons/tree/master/gramps51 /gramps51]<br />
*** /download<br />
*** /listings<br />
** [https://github.com/gramps-project/addons/tree/master/gramps52 /gramps52]<br />
*** /download<br />
*** /listings<br />
<br />
=== Get a local copy of Gramps and its addons ===<br />
<br />
These steps show how to download the addon sources.<br />
<br />
# Get an https://github.com/join account if you don't already have one.<br />
# Request GIT write access for the https://github.com/gramps-project/addons-source project by emailing the [[Contact#Mailing_lists|gramps-devel mailing list]]<br />
See also [[Brief_introduction_to_Git|git introduction]] for instructions on installing git and getting basic settings configured. Also [https://help.github.com/articles/generating-an-ssh-key/ Connecting to GitHub with SSH] will help with setting up credentials for GitHub.<br />
To fully build and advertise a new addon will require local copies of the three repositories, the 'addons-source', 'addons' and the main Gramps source 'gramps'.<br />
<br />
This wiki assumes that all three git repositories local locations are put into the same base directory and named with the repository names in order for the make.py script commands to work as shown. From the base directory, run the following commands to create a copy of each repository. If you want to use SSH;<br />
<br />
git clone git@github.com:gramps-project/addons-source.git addons-source<br />
git clone git@github.com:gramps-project/addons.git addons<br />
git clone git@github.com:gramps-project/gramps.git gramps<br />
<br />
or if you want to use a web url:<br />
<br />
git clone https://github.com/gramps-project/addons-source.git addons-source<br />
git clone https://github.com/gramps-project/addons.git addons<br />
git clone https://github.com/gramps-project/gramps.git gramps<br />
<br />
To switch to a local copy of the gramps51 maintenance branch:<br />
<br />
cd addons-source<br />
git checkout -b gramps51 origin/maintenance/gramps51<br />
<br />
or to work in the master branch:<br />
<br />
cd addons-source<br />
git checkout -b gramps52 origin/master<br />
<br />
=== Other prerequisites ===<br />
{{man warn|These instructions, the make.py script etc.|are designed to operate in a Linux environment. {{man menu|They won't work on Windows without modifications.}}}}<br />
* Gramps uses Python version 3.2 or higher. You must have at least that version installed. If you have installed Gramps 4.2 or higher on your Linux system already, then a sufficient version of Python will be present. If you have more than one version of Python installed, then you must use the correct version for these scripts. On some systems, both Python 2.x and 3.x are installed. It is possible that the normal invocation of <code>python</code> starts up Python 2.x, and that to start up Python 3.x requires invoking with <code>python3</code> or <code>python3.4</code> etc. You can test the version by <code>python –version</code> or <code>python3 –version</code>. If this is so, replace any usage of 'python' in the examples below with the appropriate invocation.<br />
* The make.py used in construction of the addons requires that the LANGUAGE environment variable be set to 'en_US.UTF-8'. <br />
* The make.py used in construction of the addons requires that the GRAMPSPATH environment variable be set to your path to the Gramps source tree.<br />
* intltool must be installed;<br />
: <code>sudo apt-get install intltool</code><br />
<br />
For example if your home directory is '/home/name' and you use the suggested path names, use<br />
: <code>GRAMPSPATH=/home/name/gramps LANGUAGE='en_US.UTF-8' python3 make.py ...</code><br />
to replace the <code>./make.py</code> in the examples below.<br />
<br />
=== Create your addon subdirectory ===<br />
* Make a new project directory in addons-source:<br />
: <code>mkdir NewProjectName</code><br />
<br />
===Follow the development API for your tool===<br />
Create your NewProjectName.py and NewProjectName.gpr.py files.<br />
<br />
Follow the development API for your tool, [[Report-writing_tutorial|report]], view, or [[Gramplets]]. Place all of your associated .py, .glade, etc. files in this directory. For general information on Gramps development see [[Portal:Developers]] and [[Writing a plugin|Writing a Plugin]] specifically.<br />
<br />
=== Test your addon as you develop ===<br />
<br />
{{man warn|{{bug|10436}} Symlinks to folders in gramps plugin dir are not scanned}}<br />
<br />
To test your addon as you develop it is suggested that you copy your NewProjectName plugin into your Gramps user plugin directory from your addon development directory, prior to testing. Or just edit in the Gramps user plugin directory until it is ready to publish, then copy back to your addon development directory.<br />
<br />
Your installed Gramps will search this folder (and subdirectories) for .gpr.py files, and add them to the plugin list.<br />
<br />
If you have code that you want to share between addons, you don't need to do anything special. Gramps adds each directory in which a .gpr.py is found onto the PYTHONPATH which is searched when you perform an import. Thus "import NewProjectName" will work from another addon. You should always make sure you name your addons with a name appropriate for Python imports.<br />
<br />
=== Commit your changes ===<br />
To commit your changes so that others can see your addon source.<br />
<br />
* Remove the files using the ''clean'' command that should not be added to GitHub (eg files(template.pot/ locale etc)):<br />
: <code>./make.py gramps51 clean NewProjectName</code><br />
* Add the project to the repository:<br />
: <code>git add NewProjectName</code><br />
* Commit it with an appropriate message<br />
: <code>git commit -m "A message describing what this addon is"</code><br />
<br />
Before committing additional edits to your addon, you should:<br />
<br />
* to make sure that outside changes do not affect your commit<br />
: <code>git pull --rebase</code><br />
* only the files you changed should be in this list<br />
: <code>git status</code><br />
* Commit it with an appropriate message<br />
: <code>git commit -m "A message describing the changes"</code><br />
<br />
If you have been given 'push' rights to GitHub 'gramps-project/addons-source', and when you are sure you are done and want to publish to the repository:<br />
<br />
* to make sure that outside changes do not affect your commit<br />
: <code>git pull --rebase</code><br />
: <code>git push origin gramps51</code><br />
<br />
Also you may want to [[Addons_development#Package_your_addon |Package your addon]] so it can be downloaded via the plugin manager.<br />
<br />
=== Config ===<br />
<br />
Some addons may want to have persistent data (data settings that remain between sessions). You can handle this yourself, or you can use Gramps' built-in configure system. <br />
<br />
At the top of the source file of your addon, you would do this:<br />
<br />
from config import config as configman<br />
config = configman.register_manager("grampletname")<br />
# register the values to save:<br />
config.register("section.option-name1", value1)<br />
config.register("section.option-name2", value2)<br />
...<br />
# load an existing file, if one:<br />
config.load()<br />
# save it, it case it didn't exist:<br />
config.save()<br />
<br />
This will create the file "grampletname.ini" and put in the same directory as the addon. If the config file already exists, it remains intact.<br />
<br />
In the addon, you can then:<br />
<br />
x = config.get("section.option-name1")<br />
config.set("section.option-name1", 3)<br />
<br />
and when this code is exiting, you might want to save the config. In a Gramplet that would be:<br />
<br />
def on_save(self):<br />
config.save()<br />
<br />
If your code is a system-level file, then you might want to save the config in the Gramps system folder:<br />
<br />
config = configman.register_manager("system", use_config_path=True)<br />
<br />
This, however, would be rare; most .ini files would go into the plugins directory.<br />
<br />
In other code that might use this config file, you would do this:<br />
<br />
from config import config as configman<br />
config = configman.get_manager("grampletname")<br />
x = config.get("section.option-name1")<br />
<br />
=== Localization ===<br />
<br />
For general help on translations in Gramps, see [[Coding for translation]]. However, that will only use translations that come with Gramps, or allows you to contribute translations to the Gramps core. To have your own managed translations that will be packaged with your addon, read the rest of this page.<br />
Note that these instructions will only work for Python strings, if you have a glade file, it will not get translated.<br />
<br />
For any addon which you have translations into other languages, you will need to add a way to retrieve the translation. You need to add this to the top of your NewProjectName.py file:<br />
<br />
from gramps.gen.const import GRAMPS_LOCALE as glocale<br />
_ = glocale.get_addon_translator(__file__).gettext<br />
<br />
<br />
Then you can use the standard "_()" function to translate phrases in your addon. <br />
<br />
You can use one of a few different types of translation functions:<br />
<br />
# gettext<br />
# lgettext<br />
# ngettext<br />
# lngettext<br />
# sgettext<br />
<br />
These have become obsolete in Gramps 4; gettext, ngettext, and sgettext always return translated strings in unicode for consistent portability between Python 2 and Python3.<br />
<br />
See the [http://docs.python.org/3/library/gettext.html#the-gnutranslations-class python documentation] for documentation of gettext and ngettext. The "l" versions return the string encoded according to the [http://docs.python.org/3/library/locale.html#locale.setlocale currently set locale]; the "u" versions return unicode strings in Python2 and are not available in Python 3.<br />
<br />
'''sgettext''' is a Gramps extension that filters out clarifying comments for translators, such as<br />
_("Remaining names | rest")<br />
Where "rest" is the English string that we want to present and "Remaining names" is a hint for translators.<br />
<br />
==== Commands to compile translations ====<br />
<br />
To build and compile translations for all projects to their download/Addon.addon.tgz files:<br />
<br />
: <code>python3 make.py gramps51 build all</code><br />
<br />
To compile translations for all projects :<br />
<br />
: <code>python3 make.py gramps51 compile all</code><br />
<br />
== Create a Gramps Plugin Registration file ==<br />
<br />
First, create the NewProjectName.gpr.py file. The registration takes this general form:<br />
<br />
<pre><br />
register(PTYPE,<br />
gramps_target_version = "5.1",<br />
version = "1.0.0",<br />
ATTR = value,<br />
)<br />
</pre><br />
<br />
[https://github.com/gramps-project/gramps/blob/master/gramps/gen/plug/_pluginreg.py#L76 PTYPE] is TOOL, GRAMPLET, REPORT, QUICKVIEW, IMPORT, EXPORT, DOCGEN, GENERAL, MAPSERVICE, VIEW, or RELCALC.<br />
<br />
<br />
ATTR depends on the PTYPE. But you must have '''gramps_target_version''' and '''version'''. '''gramps_target_version''' should be a string of the form "X.Y" version number matching Gramps X major, Y minor integer. '''version''' is a string of the form "X.Y.Z" representing the version of your addon. X, Y, and Z should all be integers.<br />
<br />
Here is a sample Tool GPR file:<br />
<br />
<pre><br />
register(TOOL, <br />
id = 'AttachSource',<br />
name = _("Attach Source"),<br />
description = _("Attaches a shared source to multiple objects."),<br />
version = '1.0.0',<br />
gramps_target_version = '5.1',<br />
status = STABLE,<br />
fname = 'AttachSourceTool.py',<br />
authors = ["Douglas S. Blank"],<br />
authors_email = ["doug.blank@gmail.com"],<br />
category = TOOL_DBPROC,<br />
toolclass = 'AttachSourceWindow',<br />
optionclass = 'AttachSourceOptions',<br />
tool_modes = [TOOL_MODE_GUI]<br />
)<br />
</pre><br />
<br />
You can see examples of the kinds of addons [https://github.com/gramps-project/gramps/plugins here] (for example, see [https://github.com/gramps-project/gramps/plugins/drawreport/drawplugins.gpr.py gramps/plugins/drawreport/drawplugins.gpr.py]) and see the full documentation in the [https://github.com/gramps-project/gramps/blob/3f0db9303f29811b43325c30149c8844c7ce24b6/gramps/gen/plug/_pluginreg.py#L23 master/gramps/gen/plug/_pluginreg.py] comments and docstrings.<br />
<br />
Note that this .gpr.py will automatically use translations if you have them (see below). That is, the function "_" is predefined to use your locale translations; you only need to mark the text with _("TEXT") and include a translation of "TEXT" in your translation file. For example, in the above example, _("Attach Source") is marked for translation. If you have developed and packaged your addon with translation support, then that phrase will be converted into the user's language.<br />
<br />
=== Report plugins ===<br />
The possible report categories are ([https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L141-L149 gen/plug/_pluginreg.py]):<br />
<pre><br />
#possible report categories<br />
CATEGORY_TEXT = 0<br />
CATEGORY_DRAW = 1<br />
CATEGORY_CODE = 2<br />
CATEGORY_WEB = 3<br />
CATEGORY_BOOK = 4<br />
CATEGORY_GRAPHVIZ = 5<br />
CATEGORY_TREE = 6<br />
REPORT_CAT = [ CATEGORY_TEXT, CATEGORY_DRAW, CATEGORY_CODE,<br />
CATEGORY_WEB, CATEGORY_BOOK, CATEGORY_GRAPHVIZ, CATEGORY_TREE]<br />
</pre><br />
<br />
Each report category has a set of standards and interface. The categories CATEGORY_TEXT and CATEGORY_DRAW use the Document interface of Gramps. See also [[Report API]] for a draft view on this.<br />
<br />
The application programming interface or API for reports is treated at [[Report-writing_tutorial]]. For general information on Gramps development see [[Portal:Developers]] and [[Writing a plugin|Writing a Plugin]] specifically.<br />
<br />
=== General plugins ===<br />
<br />
The plugin framework also allows you to create generic plugins for use. This includes the ability to create libraries of functions, and plugins of your own design.<br />
<br />
==== Example: A library of functions ====<br />
<br />
In this example, a file name library.py will be imported at time of registration (when Gramps starts):<br />
<br />
<pre><br />
# file: library.gpr.py<br />
<br />
register(GENERAL, <br />
id = 'My Library',<br />
name = _("My Library"),<br />
description = _("Provides a library for doing something."),<br />
version = '1.0',<br />
gramps_target_version = '5.1',<br />
status = STABLE,<br />
fname = 'library.py',<br />
load_on_reg = True,<br />
)<br />
</pre><br />
<br />
The code in the file library.py will be imported when Gramps begins. You can access the loaded module in other code by issuing an "import library" as Python keeps track of files already imported. However, the amount of useful code that you can run when the program is imported is limited. You might like to have the code do something that requires a dbstate or uistate object, and neither of these is available when just importing a file.<br />
<br />
If "load_on_reg" was not True, then this code would be unavailable until manually loaded. There is no automatic mechanism in Gramps to load GENERAL plugins automatically.<br />
<br />
In addition to importing a file at startup, one can also run a single function inside a GENERAL plugin, and it will be passed the dbstate, the uistate, and the plugin data. The function must be called "load_on_reg", and take those three parameters, like this:<br />
<br />
<pre><br />
# file: library.py<br />
<br />
def load_on_reg(dbstate, uistate, plugin):<br />
"""<br />
Runs when plugin is registered.<br />
"""<br />
print("Hello World!")<br />
</pre><br />
<br />
Here, you could connect signals to the dbstate, open windows, etc.<br />
<br />
Another example of what one can do with the plugin interface is to create a general purpose plugin framework for use by other plugins. Here is the basis for a plugin system that:<br />
<br />
* allows plugins to list data files<br />
* allows the plugin to process all of the data files<br />
<br />
First, the gpr.py file:<br />
<br />
<pre><br />
<br />
register(GENERAL, <br />
id = "ID",<br />
category = "CATEGORY",<br />
load_on_reg = True,<br />
process = "FUNCTION_NAME",<br />
)<br />
</pre><br />
<br />
This example uses three new features:<br />
<br />
# GENERAL plugins can have a category<br />
# GENERAL plugins can have a load_on_reg function that returns data<br />
# GENERAL plugins can have a function (called "process") which will process the data<br />
<br />
If you (or someone else) create additional general plugins of this category, and they follow your load_on_reg data format API, then they could be used just like your original data. For example, here is an additional general plugin in the 'WEBSTUFF' category:<br />
<br />
<pre><br />
# anew.gpr.py<br />
<br />
register(GENERAL, <br />
id = 'a new plugin',<br />
category = "WEBSTUFF",<br />
version = '1.0',<br />
gramps_target_version = '5.1',<br />
data = ["a", "b", "c"],<br />
)<br />
</pre><br />
<br />
This doesn't have load_on_reg = True, nor does it have a fname or process, but it does set the data directly in the .gpr.py file. Then we have the following results:<br />
<br />
<pre><br />
>>> from gui.pluginmanager import GuiPluginManager<br />
>>> PLUGMAN = GuiPluginManager.get_instance()<br />
>>> PLUGMAN.get_plugin_data('WEBSTUFF')<br />
["a", "b", "c", "Stylesheet.css", "Another.css"]<br />
>>> PLUGMAN.process_plugin_data('WEBSTUFF')<br />
["A", "B", "C", "STYLESHEET.CSS", "ANOTHER.CSS"]<br />
</pre><br />
<br />
=== Registered GENERAL Categories ===<br />
<br />
The following are the published secondary plugins API's (type GENERAL, with the following categories):<br />
<br />
==== WEBSTUFF ====<br />
<br />
A sample gpr.py file:<br />
<br />
<pre><br />
# stylesheet.gpr.py<br />
<br />
register(GENERAL, <br />
id = 'system stylesheets',<br />
category = "WEBSTUFF",<br />
name = _("CSS Stylesheets"),<br />
description = _("Provides a collection of stylesheets for the web"),<br />
version = '1.0',<br />
gramps_target_version = '5.1',<br />
fname = "stylesheet.py",<br />
load_on_reg = True,<br />
process = "process_list",<br />
)<br />
</pre><br />
<br />
Here is the associated program:<br />
<br />
<pre><br />
# file: stylesheet.py<br />
<br />
def load_on_reg(dbstate, uistate, plugin):<br />
"""<br />
Runs when plugin is registered.<br />
"""<br />
return ["Stylesheet.css", "Another.css"]<br />
<br />
def process_list(files):<br />
return [file.upper() for file in files]<br />
</pre><br />
<br />
==== Filters ====<br />
<br />
For example:<br />
<br />
<pre><br />
register(GENERAL,<br />
category="Filters",<br />
...<br />
load_on_reg = True<br />
)<br />
</pre><br />
<br />
<pre><br />
def load_on_reg(dbstate, uistate, plugin):<br />
# returns a function that takes a namespace, 'Person', 'Family', etc.<br />
<br />
def filters(namespace):<br />
print("Ok...", plugin.category, namespace, uistate)<br />
# return a Filter object here<br />
return filters<br />
</pre><br />
<br />
<span id=internationalization><br />
<br />
== List the Prerequistes your addon depends on ==<br />
<br />
''In your gpr file, you can have a line like:<br />
<br />
<code>depends_on = ["libwebconnect"]</code><br />
<br />
which is a list of id's from other gpr files. This example will ensure that [[Addon:Web_Connect_Pack#Prerequisites|libwebconnect]] is loaded before your addon. If it can't be found, or you have a cycle, then your addons won't be loaded.<br />
<br />
example code used in the Addon:Web_Connect_Pack that references libwebconnect Prerequistes [https://github.com/gramps-project/addons-source/blob/1304b65a7d758bfe17339c26260473ac3e9c4061/RUWebConnectPack/RUWebPack.gpr.py#L17 RUWebPack.gpr.py#L17 ]<br />
<br />
This means that common Prerequistes can be shared between addons and that code sits in its own gpr/addon file.<br />
<br />
<!--<br />
<br />
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons<br />
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=<br />
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=<br />
<br />
which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)<br />
<br />
depends_on = ["libwebconnect"]<br />
<br />
mentioned in the following<br />
https://sourceforge.net/p/gramps/mailman/message/27070037/<br />
''In your gpr file, you can have a line like:<br />
<br />
depends_on = ["libwebconnect"]<br />
<br />
which is a list of id's from other gpr files. This example will ensure<br />
that libwebconnect is loaded before your plugin. If it can't be found,<br />
or you have a cycle, then your plugin won't be loaded.<br />
<br />
If it is a common function, perhaps libhtml is the right place to put<br />
it, and you can put a depends_on on that.<br />
<br />
-Doug''<br />
<br />
<br />
example output is on terminal only:<br />
<br />
Cannot resolve the following plugin dependencies:<br />
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']<br />
<br />
[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.<br />
<br />
[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.<br />
<br />
[]update the Addon:Prerequisites Checker Gramplet to test for your Prerequisites.<br />
<br />
--><br />
<br />
== Get translators to translate your addon into multiple languages ==<br />
</span><br />
If you [[#Localization|designed for localization]], the addon will begin supporting a single language. Make your addon inviting for volunteers to translate it into their native language.<br />
* Initialize and update the <code>template.pot</code> for your addon:<br />
: <code>cd ~/addons-source</code><br />
: <code>./make.py gramps51 init NewProjectName</code><br />
* You should edit the header of <code>template.pot</code> with your information, so it gets copied to individual language files.<br />
* Initialize a language for your addon (say French, fr):<br />
: <code>./make.py gramps51 init NewProjectName fr</code><br />
* Update it from gramps and other addons:<br />
: <code>./make.py gramps51 update NewProjectName fr</code><br />
* Edit the translations file manually:<br />
: <code>/NewProjectName/po/fr-local.po</code><br />
* Compile the language:<br />
: <code>./make.py gramps51 compile NewProjectName</code><br />
* Add or update your local language file, and commit changes:<br />
: <code>git add NewProjectName/po/fr-local.po</code><br />
: <code>git commit NewProjectName/po/fr-local.po -m "Added fr po file"</code><br />
* If you have been given 'push' rights to GitHub 'gramps-project/addons-source', then;<br />
: <code>git push origin gramps51</code><br />
<br />
== Package your addon ==<br />
<br />
To create a downloadable package:<br />
<br />
: <code>./make.py gramps51 build NewProjectName</code> or<br />
: <code>./make.py gramps52 build NewProjectName</code> for the master branch.<br />
<br />
This will automatically include the following files in your build:<br />
<br />
* *.py<br />
* *.glade<br />
* *.xml<br />
* *.txt<br />
* locale/*/LC_MESSAGES/*.mo<br />
<br />
Starting with Gramp 5.0, if you have additional files beyond those listed above, you should create a MANIFEST file in the root of your addon folder listing the files (or pattern) one per line, like this sample MANIFEST file: <br />
<br />
<pre><br />
README.md<br />
extra_dir/*<br />
help_files/docs/help.html<br />
</pre><br />
<br />
{{man note|Note:|Running the command <code>make.py xxx build</code> will increment the third number in your dotted version number of all addons in the <code>*.gpr.py</code> file. Consider this number to be a "build number".}}<br />
<br />
This will leave your 'addons-source' with untracked changes according to git. You should delete the 'NewProjectName/locale' directory. The updated 'NewProjectName/NewProjectName.gpr.py ' is ready to add and commit the next time you make other changes.<br />
: <code>rm –rf –v 'NewProjectName/locale'</code><br />
<br />
Then add the package to GitHub:<br />
<br />
<pre> cd '~/addons'<br />
git add gramps51/download/NewProjectName.addon.tgz<br />
git commit -m "Added new plugin: NewProjectName"</pre><br />
or (for the master branch);<br />
<pre> cd '~/addons'<br />
git add gramps52/download/NewProjectName.addon.tgz<br />
git commit -m " Added new plugin: NewProjectName"</pre><br />
<br />
== List your addon in the Gramps Plugin Manager==<br />
<br />
{{man warn|Gramps needs to have been built|Make sure you have already built gramps51 or master. Change to the appropriate git branch in your gramps directory, and run <code>python3 setup.py build</code> See [[Linux:Build_from_source]]}}<br />
<br />
To create a listing:<br />
<br />
: <code>cd '~/gramps-addons'</code> or wherever you have built your addon<br />
: <code>GRAMPSPATH=path/to/your/gramps/install ./make.py gramps51 listing NewProjectName</code><br />
or (for the master branch);<br />
: <code>cd '~/gramps-addons'</code> or wherever you have built your addon<br />
: <code>GRAMPSPATH=path/to/your/gramps/install ./make.py gramps52 listing NewProjectName</code><br />
<br />
That will create a series of files in the <tt>../listings/</tt> directory.<br />
<br />
Then add the updated listing to GitHub:<br />
<br />
<pre> cd '~/addons'<br />
git add gramps51/listings/*<br />
git commit -m "Added new plugin to listings: NewProjectName"</pre><br />
or (for the master branch);<br />
<pre> cd '~/addons'<br />
git add gramps52/listings/*<br />
git commit -m " Added new plugin to listings: NewProjectName"</pre><br />
<br />
== List and document your addon on the wiki==<br />
<br />
===List your addon===<br />
Add a short description of your addon to the Addons list by editing the current release listing eg: [[5.1_Addons]] or if the addon is meant for a future release [[5.2_Addons]] when available.<br />
<br />
==== Example addon template ====<br />
Examine the listing for other addons and refer to the [[Addon list legend]] for details of on the meaning of each columns.<br />
<pre><br />
|- <!-- Copy this section and list your Addon --><br />
|<!-- Plugin / Documentation --><br />
|<!-- Type --><br />
|<!-- Image --><br />
|<!-- Description --><br />
|<!-- Use --><br />
|<!-- Rating (out of 4) --><br />
|<!-- Contact --><br />
|<!-- Download --><br />
|-<br />
</pre><br />
<br />
===Document your addon===<br />
Document the addon in the wiki using the page name format of {{man menu|Addon:NewProjectName}} examine the other addon support pages for the general format to use.<br />
{{man tip|Hint on creating a new wiki page.|To create a new wiki page use the search box to search for the name of your page that doesn't exist then on the search results page you will be provided with a link to create the new page, by selecting and you can add your content}}<br />
<br />
====Example addon article====<br />
Consider including the following information:<br />
<br />
<pre><br />
<!-- Copy this section to your Addon support page--><br />
{{Third-party plugin}}<!-- This is a mediawiki template that expands out to display the standard addon message you see at the top of each addon page--><br />
<br />
<!--sections only add if needed--><br />
== Usage ==<br />
<br />
=== Configure Options ===<br />
<br />
==Features==<br />
<br />
== Prerequisites ==<br />
<br />
== Issues ==<br />
<br />
<!--default categories--><br />
[[Category:Addons]]<br />
[[Category:Plugins]]<br />
[[Category:Developers/General]]<br />
</pre><br />
<br />
== Announce the addon ==<br />
Join the [[Contact#Forum|Gramps Forum]] and announce it to the users with general information on why you created and how to use it.<br />
<br />
== Support it through issue tracker ==<br />
<br />
Become a user on the [https://gramps-project.org/bugs/view_all_bug_page.php Gramps MantisBT (Mantis BugTracker)]. <br />
and please check it regularly. There is no automated notification of issues (and possible feature requests) related to your addon when reported by users. <br />
<br />
Users tend to not understand coding and they make assumptions. So be kind and guiding if a report is ambiguous or inaccurate. A negative remark from an addon developer or anyone can be very discouraging.<br />
<br />
== Maintain the code as Gramps continues to evolve ==<br />
<br />
{{man tip|When submitting an update the patch part of the version number MAJOR.MINOR.PATCH is updated during the addon build process e.g. 1.1.3 to 1.1.4|You can find this step in [https://github.com/gramps-project/addons-source/blob/master/make.py#L125 addons-source/make.py].[https://gramps.discourse.group/t/should-addons-pr-include-version-number-update/2591]}}<br />
<br />
Remember that Gramps addons exist for many reasons and there are many Gramps developers that do support addons in various ways (translations, triage, keeping in sync with master, download infrastructure, etc).<br />
<br />
Some reasons why the addons exist; they provide:<br />
* A quick way for anyone to share their work; the Gramps-project has never denied adding a addon.<br />
* A method to continuously update and develop a stand-alone component, often before being officially accepted.<br />
* A place for controversial plugins that will never be accepted into core, but are loved by many users (eg, Data Entry Gramplet).<br />
* A place for experimental components to live.<br />
<br />
== Example code adding common enhancements ==<br />
* Copy all the Gramplet's output to a system clipboard via context pop-up menu : Enhancement request {{bug|11573}}, [https://github.com/gramps-project/gramps/pull/1014/commits/72012e13b4ca15caca4b7f36fdb9702c1fd470fd example pull]<br />
* add a custom [[Gramps_Glossary#viewmode|View Mode]] toolbar icon via the <code>.gpr.py</code> : [https://github.com/gramps-project/gramps/pull/1017 Pull 1017 Discussion], [https://github.com/gramps-project/gramps/pull/1017/commits/76e41d546d6ec519dd78fbe07f663135b5c79351 example Pull]<br />
<br />
= Resources =<br />
* [[Brief_introduction_to_Git|Git introduction]]<br />
* [[Getting started with Gramps development]]<br />
* [[Portal:Developers]]<br />
* [https://gramps-project.org/docs/gen/gen_plug.html?highlight=include_in_listing#module-gramps.gen.plug._pluginreg Registration Module] <br />
<br />
;Gramps Addons site for Gramps 4.2 and newer<br />
* https://github.com/gramps-project/addons-source - Source code (Git)<br />
* https://github.com/gramps-project/addons - downloadable .tgz files<br />
;Gramps Addons site for Gramps 4.1 and older<br />
* For 4.1.x and earlier, see [[Addons development old]]. <br />
= Addon Development Tutorials and Samples =<br />
* [[Report-writing_tutorial|Report-writing Tutorial]]<br />
* [[Quick_Views|Quick Views]]<br />
* [[Gramplets|Gramplets]]<br />
* [[Develop_an_Add-on_Rule|Develop an Add-on Rule]]<br />
* [[Develop_an_Add-on_Tool|Develop an Add-on Tool]]<br />
* [[Adapt_a_built-in_Report|Adapt a built-in Report]]<br />
<br />
[[Category:Developers/General]]<br />
[[Category:Developers/Tutorials]]<br />
[[Category:Plugins]]<br />
[[Category:Reports]]<br />
[[Category:Gramplets]]<br />
[[Category:Addons]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:New&diff=101562
Template:New
2024-02-16T17:47:10Z
<p>Nick H: Prefix with &mdash;&nbsp;</p>
<hr />
<div><includeonly>&mdash;&nbsp;⚡<small>''new for version {{{1}}}''</small></includeonly><noinclude>This '''New''' template generates formatted text to indicate new functionality in a given version.<br><br>It takes only one parameter, which is the version that implements the new functionality. The template then creates formatted text. eg:<br><br><nowiki>{{</nowiki>new|''5.2.0''}}<br><br>will be shown as: <br><br>&mdash;&nbsp;⚡<small>''new for version 5.2.0''</small>[[Category:Templates]]</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Addons_development&diff=101561
Addons development
2024-02-16T17:28:27Z
<p>Nick H: Use "new" template</p>
<hr />
<div>{{man tip|Information on developing Gramps addons|If you are looking for addons to install, visit: [[Third-party Addons]]}}<br />
{{man warn|Note that this article anticipates that most addons will be developed under Linux.|([[Getting started with Gramps development|Linux is the principal development platform.]]) While it is possible to do so under Windows or MacOS, some of the steps will differ and the documented processes have not been as thoroughly reviewed. So developer beware.<br>See [[Portal:Developers]]}}<br />
If you are developing a [[Third-party Addons|Third-party Addon]]; this page documents the API, methods, and best practices for Gramps 4.2 and later. <br />
<br />
==What can addons extend?==<br />
Addons for Gramps can extend the program in many different ways. You can add any of the following [https://github.com/gramps-project/gramps/blob/master/gramps/gen/plug/_pluginreg.py types] of addons:<br />
<br />
<!-- sync with https://gramps-project.org/wiki/index.php?title=Addon_list_legend&action=edit&section=2 --> <br />
* '''Importer''' (IMPORT) - adds additional file format import options to Gramps<br />
* '''Exporter''' (EXPORT) - adds additional file format export options to Gramps<br />
* '''[[Gramps_Glossary#gramplet|Gramplet]]''' (GRAMPLET) - adds a new interactive interface section to a Gramps view mode, which can be activated by right-clicking on the dashboard View or from the menu of the Sidebar/Bottombar in the other view categories. <br />
* '''Gramps [[Gramps_Glossary#viewmode|View ''(mode)'']]''' (VIEW) - adds a new view mode to the list of views available within a [[Gramps_Glossary#view|View Category]]<br />
* '''[[Map_Services|Map Service]]''' (MAPSERVICE) - adds new mapping options to Gramps<br />
* '''Plugin lib''' (GENERAL) - libraries that are present giving extra functionality. Can add, replace and or modifies built-in Gramps options.<br />
* '''[[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quickreport'''/'''Quickview]]''' (QUICKREPORT) - a view that you can run by right-clicking on object, or if a person quickview, then through the Quick View Gramplet<br />
* '''[[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_1|Report]]''' (REPORT) - adds a new output report / includes '''Website''' - output a static genealogy website based on your Gramps Family Tree data.<br />
* '''[[Gramps_{{man version}}_Wiki_Manual_-_Filters#Add_Rule_dialog|Rule]]''' (RULE) - adds new [[Gramps_Glossary#filter|filter]] rules. <small>new for version 5.1</small><br />
* '''[[Gramps_{{man version}}_Wiki_Manual_-_Tools|Tool]]''' (TOOL) - adds a utility that helps process data from your family tree.<br />
* '''Doc creator''' (DOCGEN)<br />
* '''Relationships''' (RECALC)<br />
* '''Sidebar''' (SIDEBAR)<br />
* '''[[Database_Backends|Database]]''' (DATABASE) - add support for another database backend. <small>new for version 5.0</small><br />
* '''Thumbnailer''' (THUMBNAILER) - {{new|5.2.0}}<br />
* '''Citation formatter''' (CITE) - {{new|5.2.0}}<br />
<br />
==Writing an addon==<br />
Writing an addon is fairly straightforward if you have just a little bit of Python experience. And sharing your addon is the right thing to do. The general steps to writing an addon and sharing your own addons are:<br />
<br />
# [[#Develop_your_addon|Develop your addon]]<br />
# [[#Create_a_Gramps_Plugin_Registration_file|Create a Gramps Plugin Registration file (.gpr.py)]]<br />
# [[#internationalization|Invite translation of your addon]] into multiple natural languages<br />
# [[#Package_your_addon|Package your addon]]<br />
# [[#List_and_document_your_addon_on_the_wiki|Document your addon]] and publish it to the addon list<br />
# [[#List_your_addon_in_the_Gramps_Plugin_Manager|Register your addon with the Plugin Manager]]<br />
# [[#Announce_the_addon|Announce it on the Gramps Forum]] - Let users know it exist and how to use it.<br />
# [[#Support_it_through_issue_tracker|Support it through the issue tracker]]<br />
# [[#Maintain_the_code_as_Gramps_continues_to_evolve|Maintain the code]] as Gramps continues to evolve<br />
<br />
We'll now expand upon each of these steps individually.<br />
<br />
== Develop your addon ==<br />
<br />
The [http://github.com/gramps-project/addons-source addons-source] repository holds the source code for the addons with branches holding the version for different gramps. If you are working on an addon for gramps for the current Gramps {{man version}} public release, be sure to use the maintenance/gramps51 git branch, as the default is master branch for the developmental pre-release. (Currently gramps 5.2, which is not the typical target for addons.) <br />
<br />
Example commands are shown below referring to the public release rather than the master branch.<br />
<br />
The developers are currently merging changes to the most recent maintenance branch into master as necessary, so you don't have to do anything for that unless you are in a hurry. <br />
<br />
The [http://github.com/gramps-project/addons-source addons-source] git repository has the following structure, with the code for each addon in its own folder:<br />
<br />
* /addons-source<br />
** /''IndividualNameOfAddon1''<br />
** /''IndividualNameOfAddon2''<br />
** ...<br />
<br />
The [http://github.com/gramps-project/addons addons] git repository holds built versions of the addons for each release of Gramps, and has the following structure:<br />
<br />
* /addons<br />
** [https://github.com/gramps-project/addons/tree/master/gramps42 /gramps42]<br />
*** /download<br />
*** /listings<br />
** [https://github.com/gramps-project/addons/tree/master/gramps50 /gramps50]<br />
*** /download<br />
*** /listings<br />
** [https://github.com/gramps-project/addons/tree/master/gramps51 /gramps51]<br />
*** /download<br />
*** /listings<br />
** [https://github.com/gramps-project/addons/tree/master/gramps52 /gramps52]<br />
*** /download<br />
*** /listings<br />
<br />
=== Get a local copy of Gramps and its addons ===<br />
<br />
These steps show how to download the addon sources.<br />
<br />
# Get an https://github.com/join account if you don't already have one.<br />
# Request GIT write access for the https://github.com/gramps-project/addons-source project by emailing the [[Contact#Mailing_lists|gramps-devel mailing list]]<br />
See also [[Brief_introduction_to_Git|git introduction]] for instructions on installing git and getting basic settings configured. Also [https://help.github.com/articles/generating-an-ssh-key/ Connecting to GitHub with SSH] will help with setting up credentials for GitHub.<br />
To fully build and advertise a new addon will require local copies of the three repositories, the 'addons-source', 'addons' and the main Gramps source 'gramps'.<br />
<br />
This wiki assumes that all three git repositories local locations are put into the same base directory and named with the repository names in order for the make.py script commands to work as shown. From the base directory, run the following commands to create a copy of each repository. If you want to use SSH;<br />
<br />
git clone git@github.com:gramps-project/addons-source.git addons-source<br />
git clone git@github.com:gramps-project/addons.git addons<br />
git clone git@github.com:gramps-project/gramps.git gramps<br />
<br />
or if you want to use a web url:<br />
<br />
git clone https://github.com/gramps-project/addons-source.git addons-source<br />
git clone https://github.com/gramps-project/addons.git addons<br />
git clone https://github.com/gramps-project/gramps.git gramps<br />
<br />
To switch to a local copy of the gramps51 maintenance branch:<br />
<br />
cd addons-source<br />
git checkout -b gramps51 origin/maintenance/gramps51<br />
<br />
or to work in the master branch:<br />
<br />
cd addons-source<br />
git checkout -b gramps52 origin/master<br />
<br />
=== Other prerequisites ===<br />
{{man warn|These instructions, the make.py script etc.|are designed to operate in a Linux environment. {{man menu|They won't work on Windows without modifications.}}}}<br />
* Gramps uses Python version 3.2 or higher. You must have at least that version installed. If you have installed Gramps 4.2 or higher on your Linux system already, then a sufficient version of Python will be present. If you have more than one version of Python installed, then you must use the correct version for these scripts. On some systems, both Python 2.x and 3.x are installed. It is possible that the normal invocation of <code>python</code> starts up Python 2.x, and that to start up Python 3.x requires invoking with <code>python3</code> or <code>python3.4</code> etc. You can test the version by <code>python –version</code> or <code>python3 –version</code>. If this is so, replace any usage of 'python' in the examples below with the appropriate invocation.<br />
* The make.py used in construction of the addons requires that the LANGUAGE environment variable be set to 'en_US.UTF-8'. <br />
* The make.py used in construction of the addons requires that the GRAMPSPATH environment variable be set to your path to the Gramps source tree.<br />
* intltool must be installed;<br />
: <code>sudo apt-get install intltool</code><br />
<br />
For example if your home directory is '/home/name' and you use the suggested path names, use<br />
: <code>GRAMPSPATH=/home/name/gramps LANGUAGE='en_US.UTF-8' python3 make.py ...</code><br />
to replace the <code>./make.py</code> in the examples below.<br />
<br />
=== Create your addon subdirectory ===<br />
* Make a new project directory in addons-source:<br />
: <code>mkdir NewProjectName</code><br />
<br />
===Follow the development API for your tool===<br />
Create your NewProjectName.py and NewProjectName.gpr.py files.<br />
<br />
Follow the development API for your tool, [[Report-writing_tutorial|report]], view, or [[Gramplets]]. Place all of your associated .py, .glade, etc. files in this directory. For general information on Gramps development see [[Portal:Developers]] and [[Writing a plugin|Writing a Plugin]] specifically.<br />
<br />
=== Test your addon as you develop ===<br />
<br />
{{man warn|{{bug|10436}} Symlinks to folders in gramps plugin dir are not scanned}}<br />
<br />
To test your addon as you develop it is suggested that you copy your NewProjectName plugin into your Gramps user plugin directory from your addon development directory, prior to testing. Or just edit in the Gramps user plugin directory until it is ready to publish, then copy back to your addon development directory.<br />
<br />
Your installed Gramps will search this folder (and subdirectories) for .gpr.py files, and add them to the plugin list.<br />
<br />
If you have code that you want to share between addons, you don't need to do anything special. Gramps adds each directory in which a .gpr.py is found onto the PYTHONPATH which is searched when you perform an import. Thus "import NewProjectName" will work from another addon. You should always make sure you name your addons with a name appropriate for Python imports.<br />
<br />
=== Commit your changes ===<br />
To commit your changes so that others can see your addon source.<br />
<br />
* Remove the files using the ''clean'' command that should not be added to GitHub (eg files(template.pot/ locale etc)):<br />
: <code>./make.py gramps51 clean NewProjectName</code><br />
* Add the project to the repository:<br />
: <code>git add NewProjectName</code><br />
* Commit it with an appropriate message<br />
: <code>git commit -m "A message describing what this addon is"</code><br />
<br />
Before committing additional edits to your addon, you should:<br />
<br />
* to make sure that outside changes do not affect your commit<br />
: <code>git pull --rebase</code><br />
* only the files you changed should be in this list<br />
: <code>git status</code><br />
* Commit it with an appropriate message<br />
: <code>git commit -m "A message describing the changes"</code><br />
<br />
If you have been given 'push' rights to GitHub 'gramps-project/addons-source', and when you are sure you are done and want to publish to the repository:<br />
<br />
* to make sure that outside changes do not affect your commit<br />
: <code>git pull --rebase</code><br />
: <code>git push origin gramps51</code><br />
<br />
Also you may want to [[Addons_development#Package_your_addon |Package your addon]] so it can be downloaded via the plugin manager.<br />
<br />
=== Config ===<br />
<br />
Some addons may want to have persistent data (data settings that remain between sessions). You can handle this yourself, or you can use Gramps' built-in configure system. <br />
<br />
At the top of the source file of your addon, you would do this:<br />
<br />
from config import config as configman<br />
config = configman.register_manager("grampletname")<br />
# register the values to save:<br />
config.register("section.option-name1", value1)<br />
config.register("section.option-name2", value2)<br />
...<br />
# load an existing file, if one:<br />
config.load()<br />
# save it, it case it didn't exist:<br />
config.save()<br />
<br />
This will create the file "grampletname.ini" and put in the same directory as the addon. If the config file already exists, it remains intact.<br />
<br />
In the addon, you can then:<br />
<br />
x = config.get("section.option-name1")<br />
config.set("section.option-name1", 3)<br />
<br />
and when this code is exiting, you might want to save the config. In a Gramplet that would be:<br />
<br />
def on_save(self):<br />
config.save()<br />
<br />
If your code is a system-level file, then you might want to save the config in the Gramps system folder:<br />
<br />
config = configman.register_manager("system", use_config_path=True)<br />
<br />
This, however, would be rare; most .ini files would go into the plugins directory.<br />
<br />
In other code that might use this config file, you would do this:<br />
<br />
from config import config as configman<br />
config = configman.get_manager("grampletname")<br />
x = config.get("section.option-name1")<br />
<br />
=== Localization ===<br />
<br />
For general help on translations in Gramps, see [[Coding for translation]]. However, that will only use translations that come with Gramps, or allows you to contribute translations to the Gramps core. To have your own managed translations that will be packaged with your addon, read the rest of this page.<br />
Note that these instructions will only work for Python strings, if you have a glade file, it will not get translated.<br />
<br />
For any addon which you have translations into other languages, you will need to add a way to retrieve the translation. You need to add this to the top of your NewProjectName.py file:<br />
<br />
from gramps.gen.const import GRAMPS_LOCALE as glocale<br />
_ = glocale.get_addon_translator(__file__).gettext<br />
<br />
<br />
Then you can use the standard "_()" function to translate phrases in your addon. <br />
<br />
You can use one of a few different types of translation functions:<br />
<br />
# gettext<br />
# lgettext<br />
# ngettext<br />
# lngettext<br />
# sgettext<br />
<br />
These have become obsolete in Gramps 4; gettext, ngettext, and sgettext always return translated strings in unicode for consistent portability between Python 2 and Python3.<br />
<br />
See the [http://docs.python.org/3/library/gettext.html#the-gnutranslations-class python documentation] for documentation of gettext and ngettext. The "l" versions return the string encoded according to the [http://docs.python.org/3/library/locale.html#locale.setlocale currently set locale]; the "u" versions return unicode strings in Python2 and are not available in Python 3.<br />
<br />
'''sgettext''' is a Gramps extension that filters out clarifying comments for translators, such as<br />
_("Remaining names | rest")<br />
Where "rest" is the English string that we want to present and "Remaining names" is a hint for translators.<br />
<br />
==== Commands to compile translations ====<br />
<br />
To build and compile translations for all projects to their download/Addon.addon.tgz files:<br />
<br />
: <code>python3 make.py gramps51 build all</code><br />
<br />
To compile translations for all projects :<br />
<br />
: <code>python3 make.py gramps51 compile all</code><br />
<br />
== Create a Gramps Plugin Registration file ==<br />
<br />
First, create the NewProjectName.gpr.py file. The registration takes this general form:<br />
<br />
<pre><br />
register(PTYPE,<br />
gramps_target_version = "5.1",<br />
version = "1.0.0",<br />
ATTR = value,<br />
)<br />
</pre><br />
<br />
[https://github.com/gramps-project/gramps/blob/master/gramps/gen/plug/_pluginreg.py#L76 PTYPE] is TOOL, GRAMPLET, REPORT, QUICKVIEW, IMPORT, EXPORT, DOCGEN, GENERAL, MAPSERVICE, VIEW, or RELCALC.<br />
<br />
<br />
ATTR depends on the PTYPE. But you must have '''gramps_target_version''' and '''version'''. '''gramps_target_version''' should be a string of the form "X.Y" version number matching Gramps X major, Y minor integer. '''version''' is a string of the form "X.Y.Z" representing the version of your addon. X, Y, and Z should all be integers.<br />
<br />
Here is a sample Tool GPR file:<br />
<br />
<pre><br />
register(TOOL, <br />
id = 'AttachSource',<br />
name = _("Attach Source"),<br />
description = _("Attaches a shared source to multiple objects."),<br />
version = '1.0.0',<br />
gramps_target_version = '5.1',<br />
status = STABLE,<br />
fname = 'AttachSourceTool.py',<br />
authors = ["Douglas S. Blank"],<br />
authors_email = ["doug.blank@gmail.com"],<br />
category = TOOL_DBPROC,<br />
toolclass = 'AttachSourceWindow',<br />
optionclass = 'AttachSourceOptions',<br />
tool_modes = [TOOL_MODE_GUI]<br />
)<br />
</pre><br />
<br />
You can see examples of the kinds of addons [https://github.com/gramps-project/gramps/plugins here] (for example, see [https://github.com/gramps-project/gramps/plugins/drawreport/drawplugins.gpr.py gramps/plugins/drawreport/drawplugins.gpr.py]) and see the full documentation in the [https://github.com/gramps-project/gramps/blob/3f0db9303f29811b43325c30149c8844c7ce24b6/gramps/gen/plug/_pluginreg.py#L23 master/gramps/gen/plug/_pluginreg.py] comments and docstrings.<br />
<br />
Note that this .gpr.py will automatically use translations if you have them (see below). That is, the function "_" is predefined to use your locale translations; you only need to mark the text with _("TEXT") and include a translation of "TEXT" in your translation file. For example, in the above example, _("Attach Source") is marked for translation. If you have developed and packaged your addon with translation support, then that phrase will be converted into the user's language.<br />
<br />
=== Report plugins ===<br />
The possible report categories are ([https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L141-L149 gen/plug/_pluginreg.py]):<br />
<pre><br />
#possible report categories<br />
CATEGORY_TEXT = 0<br />
CATEGORY_DRAW = 1<br />
CATEGORY_CODE = 2<br />
CATEGORY_WEB = 3<br />
CATEGORY_BOOK = 4<br />
CATEGORY_GRAPHVIZ = 5<br />
CATEGORY_TREE = 6<br />
REPORT_CAT = [ CATEGORY_TEXT, CATEGORY_DRAW, CATEGORY_CODE,<br />
CATEGORY_WEB, CATEGORY_BOOK, CATEGORY_GRAPHVIZ, CATEGORY_TREE]<br />
</pre><br />
<br />
Each report category has a set of standards and interface. The categories CATEGORY_TEXT and CATEGORY_DRAW use the Document interface of Gramps. See also [[Report API]] for a draft view on this.<br />
<br />
The application programming interface or API for reports is treated at [[Report-writing_tutorial]]. For general information on Gramps development see [[Portal:Developers]] and [[Writing a plugin|Writing a Plugin]] specifically.<br />
<br />
=== General plugins ===<br />
<br />
The plugin framework also allows you to create generic plugins for use. This includes the ability to create libraries of functions, and plugins of your own design.<br />
<br />
==== Example: A library of functions ====<br />
<br />
In this example, a file name library.py will be imported at time of registration (when Gramps starts):<br />
<br />
<pre><br />
# file: library.gpr.py<br />
<br />
register(GENERAL, <br />
id = 'My Library',<br />
name = _("My Library"),<br />
description = _("Provides a library for doing something."),<br />
version = '1.0',<br />
gramps_target_version = '5.1',<br />
status = STABLE,<br />
fname = 'library.py',<br />
load_on_reg = True,<br />
)<br />
</pre><br />
<br />
The code in the file library.py will be imported when Gramps begins. You can access the loaded module in other code by issuing an "import library" as Python keeps track of files already imported. However, the amount of useful code that you can run when the program is imported is limited. You might like to have the code do something that requires a dbstate or uistate object, and neither of these is available when just importing a file.<br />
<br />
If "load_on_reg" was not True, then this code would be unavailable until manually loaded. There is no automatic mechanism in Gramps to load GENERAL plugins automatically.<br />
<br />
In addition to importing a file at startup, one can also run a single function inside a GENERAL plugin, and it will be passed the dbstate, the uistate, and the plugin data. The function must be called "load_on_reg", and take those three parameters, like this:<br />
<br />
<pre><br />
# file: library.py<br />
<br />
def load_on_reg(dbstate, uistate, plugin):<br />
"""<br />
Runs when plugin is registered.<br />
"""<br />
print("Hello World!")<br />
</pre><br />
<br />
Here, you could connect signals to the dbstate, open windows, etc.<br />
<br />
Another example of what one can do with the plugin interface is to create a general purpose plugin framework for use by other plugins. Here is the basis for a plugin system that:<br />
<br />
* allows plugins to list data files<br />
* allows the plugin to process all of the data files<br />
<br />
First, the gpr.py file:<br />
<br />
<pre><br />
<br />
register(GENERAL, <br />
id = "ID",<br />
category = "CATEGORY",<br />
load_on_reg = True,<br />
process = "FUNCTION_NAME",<br />
)<br />
</pre><br />
<br />
This example uses three new features:<br />
<br />
# GENERAL plugins can have a category<br />
# GENERAL plugins can have a load_on_reg function that returns data<br />
# GENERAL plugins can have a function (called "process") which will process the data<br />
<br />
If you (or someone else) create additional general plugins of this category, and they follow your load_on_reg data format API, then they could be used just like your original data. For example, here is an additional general plugin in the 'WEBSTUFF' category:<br />
<br />
<pre><br />
# anew.gpr.py<br />
<br />
register(GENERAL, <br />
id = 'a new plugin',<br />
category = "WEBSTUFF",<br />
version = '1.0',<br />
gramps_target_version = '5.1',<br />
data = ["a", "b", "c"],<br />
)<br />
</pre><br />
<br />
This doesn't have load_on_reg = True, nor does it have a fname or process, but it does set the data directly in the .gpr.py file. Then we have the following results:<br />
<br />
<pre><br />
>>> from gui.pluginmanager import GuiPluginManager<br />
>>> PLUGMAN = GuiPluginManager.get_instance()<br />
>>> PLUGMAN.get_plugin_data('WEBSTUFF')<br />
["a", "b", "c", "Stylesheet.css", "Another.css"]<br />
>>> PLUGMAN.process_plugin_data('WEBSTUFF')<br />
["A", "B", "C", "STYLESHEET.CSS", "ANOTHER.CSS"]<br />
</pre><br />
<br />
=== Registered GENERAL Categories ===<br />
<br />
The following are the published secondary plugins API's (type GENERAL, with the following categories):<br />
<br />
==== WEBSTUFF ====<br />
<br />
A sample gpr.py file:<br />
<br />
<pre><br />
# stylesheet.gpr.py<br />
<br />
register(GENERAL, <br />
id = 'system stylesheets',<br />
category = "WEBSTUFF",<br />
name = _("CSS Stylesheets"),<br />
description = _("Provides a collection of stylesheets for the web"),<br />
version = '1.0',<br />
gramps_target_version = '5.1',<br />
fname = "stylesheet.py",<br />
load_on_reg = True,<br />
process = "process_list",<br />
)<br />
</pre><br />
<br />
Here is the associated program:<br />
<br />
<pre><br />
# file: stylesheet.py<br />
<br />
def load_on_reg(dbstate, uistate, plugin):<br />
"""<br />
Runs when plugin is registered.<br />
"""<br />
return ["Stylesheet.css", "Another.css"]<br />
<br />
def process_list(files):<br />
return [file.upper() for file in files]<br />
</pre><br />
<br />
==== Filters ====<br />
<br />
For example:<br />
<br />
<pre><br />
register(GENERAL,<br />
category="Filters",<br />
...<br />
load_on_reg = True<br />
)<br />
</pre><br />
<br />
<pre><br />
def load_on_reg(dbstate, uistate, plugin):<br />
# returns a function that takes a namespace, 'Person', 'Family', etc.<br />
<br />
def filters(namespace):<br />
print("Ok...", plugin.category, namespace, uistate)<br />
# return a Filter object here<br />
return filters<br />
</pre><br />
<br />
<span id=internationalization><br />
<br />
== List the Prerequistes your addon depends on ==<br />
<br />
''In your gpr file, you can have a line like:<br />
<br />
<code>depends_on = ["libwebconnect"]</code><br />
<br />
which is a list of id's from other gpr files. This example will ensure that [[Addon:Web_Connect_Pack#Prerequisites|libwebconnect]] is loaded before your addon. If it can't be found, or you have a cycle, then your addons won't be loaded.<br />
<br />
example code used in the Addon:Web_Connect_Pack that references libwebconnect Prerequistes [https://github.com/gramps-project/addons-source/blob/1304b65a7d758bfe17339c26260473ac3e9c4061/RUWebConnectPack/RUWebPack.gpr.py#L17 RUWebPack.gpr.py#L17 ]<br />
<br />
This means that common Prerequistes can be shared between addons and that code sits in its own gpr/addon file.<br />
<br />
<!--<br />
<br />
[] for addon prerequistes have a look at converting them to use "depends_on = " like in the following addons<br />
https://github.com/gramps-project/addons-source/search?utf8=%E2%9C%93&q=depends_on&type=<br />
https://github.com/gramps-project/gramps/search?utf8=%E2%9C%93&q=depends_on&type=<br />
<br />
which can be a comma separated list for multiple dependencies/prerequisites (so that addons that share prerequisites import the same library?) (maybe move spell check into an addon etc? tip of the day... possibilities...)<br />
<br />
depends_on = ["libwebconnect"]<br />
<br />
mentioned in the following<br />
https://sourceforge.net/p/gramps/mailman/message/27070037/<br />
''In your gpr file, you can have a line like:<br />
<br />
depends_on = ["libwebconnect"]<br />
<br />
which is a list of id's from other gpr files. This example will ensure<br />
that libwebconnect is loaded before your plugin. If it can't be found,<br />
or you have a cycle, then your plugin won't be loaded.<br />
<br />
If it is a common function, perhaps libhtml is the right place to put<br />
it, and you can put a depends_on on that.<br />
<br />
-Doug''<br />
<br />
<br />
example output is on terminal only:<br />
<br />
Cannot resolve the following plugin dependencies:<br />
Plugin 'UK Web Connect Pack' requires: ['libwebconnect']<br />
<br />
[](feature) For plugins/addons if prerequisites not available display a page stating why/what is missing that includes the addon description and a url to the support page.<br />
<br />
[] Gramps CLI info "gramps -v" needs a section that list third-party addons with version numbers and if prerequisites have been met.<br />
<br />
[]update the Addon:Prerequisites Checker Gramplet to test for your Prerequisites.<br />
<br />
--><br />
<br />
== Get translators to translate your addon into multiple languages ==<br />
</span><br />
If you [[#Localization|designed for localization]], the addon will begin supporting a single language. Make your addon inviting for volunteers to translate it into their native language.<br />
* Initialize and update the <code>template.pot</code> for your addon:<br />
: <code>cd ~/addons-source</code><br />
: <code>./make.py gramps51 init NewProjectName</code><br />
* You should edit the header of <code>template.pot</code> with your information, so it gets copied to individual language files.<br />
* Initialize a language for your addon (say French, fr):<br />
: <code>./make.py gramps51 init NewProjectName fr</code><br />
* Update it from gramps and other addons:<br />
: <code>./make.py gramps51 update NewProjectName fr</code><br />
* Edit the translations file manually:<br />
: <code>/NewProjectName/po/fr-local.po</code><br />
* Compile the language:<br />
: <code>./make.py gramps51 compile NewProjectName</code><br />
* Add or update your local language file, and commit changes:<br />
: <code>git add NewProjectName/po/fr-local.po</code><br />
: <code>git commit NewProjectName/po/fr-local.po -m "Added fr po file"</code><br />
* If you have been given 'push' rights to GitHub 'gramps-project/addons-source', then;<br />
: <code>git push origin gramps51</code><br />
<br />
== Package your addon ==<br />
<br />
To create a downloadable package:<br />
<br />
: <code>./make.py gramps51 build NewProjectName</code> or<br />
: <code>./make.py gramps52 build NewProjectName</code> for the master branch.<br />
<br />
This will automatically include the following files in your build:<br />
<br />
* *.py<br />
* *.glade<br />
* *.xml<br />
* *.txt<br />
* locale/*/LC_MESSAGES/*.mo<br />
<br />
Starting with Gramp 5.0, if you have additional files beyond those listed above, you should create a MANIFEST file in the root of your addon folder listing the files (or pattern) one per line, like this sample MANIFEST file: <br />
<br />
<pre><br />
README.md<br />
extra_dir/*<br />
help_files/docs/help.html<br />
</pre><br />
<br />
{{man note|Note:|Running the command <code>make.py xxx build</code> will increment the third number in your dotted version number of all addons in the <code>*.gpr.py</code> file. Consider this number to be a "build number".}}<br />
<br />
This will leave your 'addons-source' with untracked changes according to git. You should delete the 'NewProjectName/locale' directory. The updated 'NewProjectName/NewProjectName.gpr.py ' is ready to add and commit the next time you make other changes.<br />
: <code>rm –rf –v 'NewProjectName/locale'</code><br />
<br />
Then add the package to GitHub:<br />
<br />
<pre> cd '~/addons'<br />
git add gramps51/download/NewProjectName.addon.tgz<br />
git commit -m "Added new plugin: NewProjectName"</pre><br />
or (for the master branch);<br />
<pre> cd '~/addons'<br />
git add gramps52/download/NewProjectName.addon.tgz<br />
git commit -m " Added new plugin: NewProjectName"</pre><br />
<br />
== List your addon in the Gramps Plugin Manager==<br />
<br />
{{man warn|Gramps needs to have been built|Make sure you have already built gramps51 or master. Change to the appropriate git branch in your gramps directory, and run <code>python3 setup.py build</code> See [[Linux:Build_from_source]]}}<br />
<br />
To create a listing:<br />
<br />
: <code>cd '~/gramps-addons'</code> or wherever you have built your addon<br />
: <code>GRAMPSPATH=path/to/your/gramps/install ./make.py gramps51 listing NewProjectName</code><br />
or (for the master branch);<br />
: <code>cd '~/gramps-addons'</code> or wherever you have built your addon<br />
: <code>GRAMPSPATH=path/to/your/gramps/install ./make.py gramps52 listing NewProjectName</code><br />
<br />
That will create a series of files in the <tt>../listings/</tt> directory.<br />
<br />
Then add the updated listing to GitHub:<br />
<br />
<pre> cd '~/addons'<br />
git add gramps51/listings/*<br />
git commit -m "Added new plugin to listings: NewProjectName"</pre><br />
or (for the master branch);<br />
<pre> cd '~/addons'<br />
git add gramps52/listings/*<br />
git commit -m " Added new plugin to listings: NewProjectName"</pre><br />
<br />
== List and document your addon on the wiki==<br />
<br />
===List your addon===<br />
Add a short description of your addon to the Addons list by editing the current release listing eg: [[5.1_Addons]] or if the addon is meant for a future release [[5.2_Addons]] when available.<br />
<br />
==== Example addon template ====<br />
Examine the listing for other addons and refer to the [[Addon list legend]] for details of on the meaning of each columns.<br />
<pre><br />
|- <!-- Copy this section and list your Addon --><br />
|<!-- Plugin / Documentation --><br />
|<!-- Type --><br />
|<!-- Image --><br />
|<!-- Description --><br />
|<!-- Use --><br />
|<!-- Rating (out of 4) --><br />
|<!-- Contact --><br />
|<!-- Download --><br />
|-<br />
</pre><br />
<br />
===Document your addon===<br />
Document the addon in the wiki using the page name format of {{man menu|Addon:NewProjectName}} examine the other addon support pages for the general format to use.<br />
{{man tip|Hint on creating a new wiki page.|To create a new wiki page use the search box to search for the name of your page that doesn't exist then on the search results page you will be provided with a link to create the new page, by selecting and you can add your content}}<br />
<br />
====Example addon article====<br />
Consider including the following information:<br />
<br />
<pre><br />
<!-- Copy this section to your Addon support page--><br />
{{Third-party plugin}}<!-- This is a mediawiki template that expands out to display the standard addon message you see at the top of each addon page--><br />
<br />
<!--sections only add if needed--><br />
== Usage ==<br />
<br />
=== Configure Options ===<br />
<br />
==Features==<br />
<br />
== Prerequisites ==<br />
<br />
== Issues ==<br />
<br />
<!--default categories--><br />
[[Category:Addons]]<br />
[[Category:Plugins]]<br />
[[Category:Developers/General]]<br />
</pre><br />
<br />
== Announce the addon ==<br />
Join the [[Contact#Forum|Gramps Forum]] and announce it to the users with general information on why you created and how to use it.<br />
<br />
== Support it through issue tracker ==<br />
<br />
Become a user on the [https://gramps-project.org/bugs/view_all_bug_page.php Gramps MantisBT (Mantis BugTracker)]. <br />
and please check it regularly. There is no automated notification of issues (and possible feature requests) related to your addon when reported by users. <br />
<br />
Users tend to not understand coding and they make assumptions. So be kind and guiding if a report is ambiguous or inaccurate. A negative remark from an addon developer or anyone can be very discouraging.<br />
<br />
== Maintain the code as Gramps continues to evolve ==<br />
<br />
{{man tip|When submitting an update the patch part of the version number MAJOR.MINOR.PATCH is updated during the addon build process e.g. 1.1.3 to 1.1.4|You can find this step in [https://github.com/gramps-project/addons-source/blob/master/make.py#L125 addons-source/make.py].[https://gramps.discourse.group/t/should-addons-pr-include-version-number-update/2591]}}<br />
<br />
Remember that Gramps addons exist for many reasons and there are many Gramps developers that do support addons in various ways (translations, triage, keeping in sync with master, download infrastructure, etc).<br />
<br />
Some reasons why the addons exist; they provide:<br />
* A quick way for anyone to share their work; the Gramps-project has never denied adding a addon.<br />
* A method to continuously update and develop a stand-alone component, often before being officially accepted.<br />
* A place for controversial plugins that will never be accepted into core, but are loved by many users (eg, Data Entry Gramplet).<br />
* A place for experimental components to live.<br />
<br />
== Example code adding common enhancements ==<br />
* Copy all the Gramplet's output to a system clipboard via context pop-up menu : Enhancement request {{bug|11573}}, [https://github.com/gramps-project/gramps/pull/1014/commits/72012e13b4ca15caca4b7f36fdb9702c1fd470fd example pull]<br />
* add a custom [[Gramps_Glossary#viewmode|View Mode]] toolbar icon via the <code>.gpr.py</code> : [https://github.com/gramps-project/gramps/pull/1017 Pull 1017 Discussion], [https://github.com/gramps-project/gramps/pull/1017/commits/76e41d546d6ec519dd78fbe07f663135b5c79351 example Pull]<br />
<br />
= Resources =<br />
* [[Brief_introduction_to_Git|Git introduction]]<br />
* [[Getting started with Gramps development]]<br />
* [[Portal:Developers]]<br />
* [https://gramps-project.org/docs/gen/gen_plug.html?highlight=include_in_listing#module-gramps.gen.plug._pluginreg Registration Module] <br />
<br />
;Gramps Addons site for Gramps 4.2 and newer<br />
* https://github.com/gramps-project/addons-source - Source code (Git)<br />
* https://github.com/gramps-project/addons - downloadable .tgz files<br />
;Gramps Addons site for Gramps 4.1 and older<br />
* For 4.1.x and earlier, see [[Addons development old]]. <br />
= Addon Development Tutorials and Samples =<br />
* [[Report-writing_tutorial|Report-writing Tutorial]]<br />
* [[Quick_Views|Quick Views]]<br />
* [[Gramplets|Gramplets]]<br />
* [[Develop_an_Add-on_Rule|Develop an Add-on Rule]]<br />
* [[Develop_an_Add-on_Tool|Develop an Add-on Tool]]<br />
* [[Adapt_a_built-in_Report|Adapt a built-in Report]]<br />
<br />
[[Category:Developers/General]]<br />
[[Category:Developers/Tutorials]]<br />
[[Category:Plugins]]<br />
[[Category:Reports]]<br />
[[Category:Gramplets]]<br />
[[Category:Addons]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:New&diff=101560
Template:New
2024-02-16T17:23:11Z
<p>Nick H: Remove a couple of blank lines</p>
<hr />
<div><includeonly>⚡<small>''new for version {{{1}}}''</small></includeonly><noinclude>This '''New''' template generates formatted text to indicate new functionality in a given version.<br><br>It takes only one parameter, which is the version that implements the new functionality. The template then creates formatted text. eg:<br><br><nowiki>{{</nowiki>new|''5.2.0''}}<br><br>will be shown as: <br><br>⚡<small>''new for version 5.2.0''</small>[[Category:Templates]]</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Template:New&diff=101559
Template:New
2024-02-16T17:22:10Z
<p>Nick H: Created</p>
<hr />
<div><includeonly>⚡<small>''new for version {{{1}}}''</small></includeonly><noinclude>This '''New''' template generates formatted text to indicate new functionality in a given version.<br><br>It takes only one parameter, which is the version that implements the new functionality. The template then creates formatted text. eg:<br><br><nowiki>{{</nowiki>new|''5.2.0''}}<br><br>will be shown as: <br><br><br><br>⚡<small>''new for version 5.2.0''</small>[[Category:Templates]]</noinclude></div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101516
Download
2024-02-15T21:57:43Z
<p>Nick H: Fix problem with duplicated sections</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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>]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
We recommend installing and upgrading Gramps using the '''[https://wikipedia.org/wiki/List_of_software_package_management_systems package manager]''' provided by your [[Download#Linux distributions|distribution]] or by installing a FlatPak available from [[Download#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] are available in the wiki.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]]<br />
Before downloading read the [[Mac OS X:Application package|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
{{-}}<br />
<hr /><br />
<br />
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 />
{{-}}<br />
<br /><br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
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>]]. <br />
<br />
<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
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>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''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'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{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.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>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 [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
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 />
<br />
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.]]<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
==== PortableApps.com ====<br />
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]<br />
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.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* 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.<br />
<br />
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.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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]'''<br />
<br />
==== Chocolatey NuGet Package ====<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
==== Gramps for Windows with MSYS2 ====<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
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.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
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.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== macOS ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before downloading the ready-to-run stand-alone bundle: 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>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
<br />
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 />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be built and installed on macOS using MacPorts.<br />
<br />
{{-}}<br />
==== MacPorts ====<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
==== Homebrew ====<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux and BSD distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6<br />
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6<br />
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps Gramps 5.1.6])<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 5.1.5)<br />
* Fedora 38 (Gramps 5.1.6)<br />
* Fedora 39 (Gramps 5.1.6)<br />
* Fedora 40 (Gramps 5.1.6)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.6<br />
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 --><br />
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 --><br />
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 --><br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
|<!-- Notes -->[https://archlinux.org/packages/extra/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
* Gramps 5.1.6 (testing)<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager -->[https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/index.html pkgsrc] ([https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/index.html databases])<br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.6nb1]<br />
|<!-- Notes --> [https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/gramps5/index.html available 5.x.x versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --> [https://ports.freebsd.org/cgi/ports.cgi ports.freebsd.org]<br />
|<!-- Current versions --><br />
* FreeBSD: Gramps [https://cgit.freebsd.org/ports/tree/science/gramps 5.1.6]<br />
* FreshPorts: Gramps [https://www.freshports.org/science/gramps/ 5.1.6]<br />
|<!-- Notes --> [https://ports.freebsd.org/cgi/ports.cgi?query=gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager -->[https://openbsd.app/ OpenBSD.app] <br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.6<br />
|<!-- Notes -->[https://openbsd.app/?search=gramps available versions]<br /> openports.se [https://openports.se/ closed on 30 Jan 2023]<br />
|-<br />
|<!-- Distribution --><br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
|<!-- Notes --><br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.<br />
<br />
{{man warn|1=Warning before attempting to install the latest Gramps version, use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.<br />
<br />
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.<br />
<br />
If you already have Gramps installed, and you are only making a 'point' upgrade (i.e., from Gramps x.y.z to x.y.z+1, e.g., from 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package currently installed on your system and gives you info about it.<br />
<br />
The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on<br />
you can compare the required Dependencies with the new version you downloaded with the following command:<br />
<br />
dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb<br />
<br />
for example, you can get just the two Depends lines to compare using:<br />
<br />
dpkg-query -s gramps | grep Depends:<br />
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub].<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}<br />
<br />
You can also try an online demonstration of version 5.1.4 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': <br />
<br />
* https://www.rollapp.com/app/gramps<br />
<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data. See : [[How to make a backup]]<br />
<br />
== See also ==<br />
GitHub Releases <!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101515
Download
2024-02-15T21:51:16Z
<p>Nick H: Reverted edits by Bamaustin (talk) to last revision by Nick H</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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>]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
We recommend installing and upgrading Gramps using the package manager provided by your [[Download#Linux distributions|distribution]] or by installing a FlatPak available from [[Download#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] are available in the wiki.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]]<br />
Before downloading read the [[Mac OS X:Application package|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
{{-}}<br />
<hr /><br />
<br />
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 />
{{-}}<br />
<br /><br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
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>]]. <br />
<br />
<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
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>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''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'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{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.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>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 [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
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 />
<br />
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.]]<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
==== PortableApps.com ====<br />
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]<br />
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.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* 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.<br />
<br />
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.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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]'''<br />
<br />
==== Chocolatey NuGet Package ====<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
==== Gramps for Windows with MSYS2 ====<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
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.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
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.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== macOS ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before downloading the ready-to-run stand-alone bundle: 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>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
<br />
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 />
<br />
=== Alternative indeinstructions for [[Linux:Build from source]]pendent installation ===<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be built and installed on macOS using MacPorts.<br />
<br />
{{-}}<br />
==== MacPorts ====<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
==== Homebrew ====<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux and BSD distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6<br />
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6<br />
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps Gramps 5.1.6])<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions -->{{-}}{{-}}{{-}}{{-}}<br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps {{languages|Download}}<br />
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
Gramps is a free software project and community. We strive to produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists. It is a community project, created, developed and governed by genealogists.<br />
<br />
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2023-06-29'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as [https://www.python.org/doc/sunset-python-2/ Python 2 support dropped]. Uses GTK+ 3 GUI. Default database is now SQLite. Lot of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]{{-}}<br />
[[File:Linux_220x261.png|128px|link=Download#Linux]] [[File:windows_180x160.png|128px|link=Download#MS_Windows]] [[File:macos_200x200.png|128px|link=Download#macOS]] [[File:Bsd daemon.png|128px|link=Download#BSD]]}} <br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
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>]]. <br />
<br />
<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
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>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''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'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{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.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>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 [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
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 />
<br />
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.]]<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
==== PortableApps.com ====<br />
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]<br />
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.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* 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.<br />
<br />
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.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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]'''<br />
<br />
==== Chocolatey NuGet Package ====<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
==== Gramps for Windows with MSYS2 ====<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
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.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
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.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== macOS ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before downloading the ready-to-run stand-alone bundle: 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>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
<br />
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 />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be built and installed on macOS using MacPorts.<br />
<br />
{{-}}<br />
==== MacPorts ====<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
==== Homebrew ====<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux and BSD distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6<br />
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6<br />
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps Gramps 5.1.6])<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 5.1.5)<br />
* Fedora 38 (Gramps 5.1.6)<br />
* Fedora 39 (Gramps 5.1.6)<br />
* Fedora 40 (Gramps 5.1.6)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.6<br />
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 --><br />
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 --><br />
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 --><br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
|<!-- Notes -->[https://archlinux.org/packages/extra/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
* Gramps 5.1.6 (testing)<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager -->[https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/index.html pkgsrc] ([https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/index.html databases])<br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.6nb1]<br />
|<!-- Notes --> [https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/gramps5/index.html available 5.x.x versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --> [https://ports.freebsd.org/cgi/ports.cgi ports.freebsd.org]<br />
|<!-- Current versions --><br />
* FreeBSD: Gramps [https://cgit.freebsd.org/ports/tree/science/gramps 5.1.6]<br />
* FreshPorts: Gramps [https://www.freshports.org/science/gramps/ 5.1.6]<br />
|<!-- Notes --> [https://ports.freebsd.org/cgi/ports.cgi?query=gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager -->[https://openbsd.app/ OpenBSD.app] <br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.6<br />
|<!-- Notes -->[https://openbsd.app/?search=gramps available versions]<br /> openports.se [https://openports.se/ closed on 30 Jan 2023]<br />
|-<br />
|<!-- Distribution --><br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
|<!-- Notes --><br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.<br />
<br />
{{man warn|1=Warning before attempting to install the latest Gramps version, use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.<br />
<br />
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.<br />
<br />
If you already have Gramps installed, and you are only making a 'point' upgrade (i.e., from Gramps x.y.z to x.y.z+1, e.g., from 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package currently installed on your system and gives you info about it.<br />
<br />
The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on<br />
you can compare the required Dependencies with the new version you downloaded with the following command:<br />
<br />
dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb<br />
<br />
for example, you can get just the two Depends lines to compare using:<br />
<br />
dpkg-query -s gramps | grep Depends:<br />
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub].<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}<br />
<br />
You can also try an online demonstration of version 5.1.4 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': <br />
<br />
* https://www.rollapp.com/app/gramps<br />
<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data. See : [[How to make a backup]]<br />
<br />
== See also ==<br />
GitHub Releases <!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
[[Category:Documentation]]<br />
5.1.5)<br />
* Fedora 38 (Gramps 5.1.6)<br />
* Fedora 39 (Gramps 5.1.6)<br />
* Fedora 40 (Gramps 5.1.6)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.6<br />
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 --><br />
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 --><br />
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 --><br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
|<!-- Notes -->[https://archlinux.org/packages/extra/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
* Gramps 5.1.6 (testing){{-}}{{-}}{{-}}{{-}}<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager -->[https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/index.html pkgsrc] ([https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/index.html databases])<br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.6nb1]<br />
|<!-- Notes --> [https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/gramps5/index.html available 5.x.x versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --> [https://ports.freebsd.org/cgi/ports.cgi ports.freebsd.org]<br />
|<!-- Current versions --><br />
* FreeBSD: Gramps [https://cgit.freebsd.org/ports/tree/science/gramps 5.1.6]<br />
* FreshPorts: Gramps [https://www.freshports.org/science/gramps/ 5.1.6]<br />
|<!-- Notes --> [https://ports.freebsd.org/cgi/ports.cgi?query=gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager -->[https://openbsd.app/ OpenBSD.app] <br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.6<br />
|<!-- Notes -->[https://openbsd.app/?search=gramps available versions]<br /> openports.se [https://openports.se/ closed on 30 Jan 2023]<br />
|-<br />
|<!-- Distribution --><br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
|<!-- Notes --><br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.<br />
<br />
{{man warn|1=Warning before attempting to install the latest Gramps version, use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.<br />
<br />
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.<br />
<br />
If you already have Gramps installed, and you are only making a 'point' upgrade (i.e., from Gramps x.y.z to x.y.z+1, e.g., from 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package currently installed on your system and gives you info about it.<br />
{{-}}{{-}}{{-}}{{-}}<br />
The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on<br />
you can compare the required Dependencies with the new version you downloaded with the following command:<br />
<br />
dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb<br />
<br />
for example, you can get just the two Depends lines to compare using:<br />
<br />
dpkg-query -s gramps | grep Depends:<br />
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub].<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}<br />
<br />
You can also try an online demonstration of version 5.1.4 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': <br />
<br />
* https://www.rollapp.com/app/gramps<br />
<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data. See : [[How to make a backup]]<br />
<br />
== See also ==<br />
GitHub Releases <!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=Download&diff=101513
Download
2024-02-15T18:53:29Z
<p>Nick H: Create a new section with frequently used links</p>
<hr />
<div>{{languages|Download}}<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
{{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?]]}} <br />
<br />
{{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>]].}}<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
We recommend installing and upgrading Gramps using the package manager provided by your [[Download#Linux distributions|distribution]] or by installing a FlatPak available from [[Download#Flathub|Flathub]].<br />
<br />
For advanced users, a source package and Debian package are available:<br />
<big><br />
* <u>[{{github_url}}/archive/refs/tags/v{{version}}/v{{version}}.tar.gz Source Package {{version}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Debian Package {{Version Linux Debian}}]</u></big><br />
Instructions for how to [[Linux:Build from source|build from source]] are available in the wiki.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
After download: '''double-click to install Gramps'''.<br />
{{-}}<br />
<hr /><br />
<br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]]<br />
Before downloading read the [[Mac OS X:Application package|before installation]] instructions.<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
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.<br />
{{-}}<br />
<hr /><br />
<br />
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 />
{{-}}<br />
<br /><br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
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>]]. <br />
<br />
<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
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>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''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'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{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.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>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 [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
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 />
<br />
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.]]<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
==== PortableApps.com ====<br />
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]<br />
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.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* 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.<br />
<br />
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.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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]'''<br />
<br />
==== Chocolatey NuGet Package ====<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
==== Gramps for Windows with MSYS2 ====<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
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.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
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.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== macOS ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before downloading the ready-to-run stand-alone bundle: 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>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
<br />
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 />
<br />
=== Alternative indeinstructions for [[Linux:Build from source]]pendent installation ===<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be built and installed on macOS using MacPorts.<br />
<br />
{{-}}<br />
==== MacPorts ====<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
==== Homebrew ====<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux and BSD distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6<br />
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6<br />
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps Gramps 5.1.6])<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions -->{{-}}{{-}}{{-}}{{-}}<br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps {{languages|Download}}<br />
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]<br />
'''Research, organize and share your family tree with Gramps.''' <br />
<br />
Gramps is a free software project and community. We strive to produce a genealogy program that is both intuitive for hobbyists and feature-complete for professional genealogists. It is a community project, created, developed and governed by genealogists.<br />
<br />
{{man note|{{Man menu|Gramps '''Current version: '''{{version}}''' Released: '''2023-06-29'''}}|''Different data format to the GRAMPS 3.4 series. Full Python 3 support only as [https://www.python.org/doc/sunset-python-2/ Python 2 support dropped]. Uses GTK+ 3 GUI. Default database is now SQLite. Lot of updates see: ''[[Gramps 5.1 Wiki Manual - What's new?|What's new?]]{{-}}<br />
[[File:Linux_220x261.png|128px|link=Download#Linux]] [[File:windows_180x160.png|128px|link=Download#MS_Windows]] [[File:macos_200x200.png|128px|link=Download#macOS]] [[File:Bsd daemon.png|128px|link=Download#BSD]]}} <br />
<br />
== Linux ==<br />
<br />
[[File:Linux_220x261.png|128px|left|link=Download#Linux]]<br />
<br />
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>]]. <br />
<br />
<br />
<br />
<big><br />
<u>[[Download#Linux distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Flathub|via Flathub]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version ({{version}}) (advanced users only)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
[[File:windows_180x160.png|128px|left|link=Download#MS_Windows]]<br />
<br />
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>]]. <br />
<br />
This installer supports Microsoft Windows in all versions [http://windows.microsoft.com/en-au/windows/lifecycle Vista/7] and later. The 64-bit versions of Windows allow more efficient access to more resources. <br />
<br />
(''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'')<br />
<br />
<big><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u><br />
*<u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u></big><br />
<!-- preserve in case an installer rebuild is needed in the future<br />
{{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.''}}<br />
--><br />
<br />
After download: '''double-click to install Gramps'''. <br>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 [[#Missing_other_languages|mix of British and US English]].<br />
<br />
{{man tip|Shortcuts|During installation, one shortcut is placed on the desktop and two shortcuts are added the Start menu. <br>''Please only use the 'console' secondary shortcut when performing diagnostics requested by a developer.''<br>1) ''GrampsAIO'''XX''' ''{{version}}'' {{man menu| &larr; for normal use of Gramps}}<br>2) ''GrampsAIO'''XX''' ''{{version}}''-console}}<br />
<br />
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 />
<br />
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.]]<br />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
If needed, there are alternatives to the All-In-One installer.<br />
<br />
==== PortableApps.com ====<br />
[[File:PortableApps_Gramps_Splash.png|right|thumb|450px|When launching the PortableApps fork of Gramps, this splash screen appears.]]<br />
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.<br />
<br />
You can download the '''{{Version_windows_portable}} Gramps Portable version''' from:<br />
* 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.<br />
<br />
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.<br />
* [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_3.4.9.paf.exe] (29.0 MB) <br />
<br />
[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]'''<br />
<br />
==== Chocolatey NuGet Package ====<br />
You may also install using the alternative independent Gramps Chocolatey NuGet Package<br />
<br />
Chocolatey NuGet is a Machine Package Manager, somewhat like apt-get, but built with Windows in mind.<br />
<br />
* [https://chocolatey.org/packages/gramps/ Gramps Chocolatey Package]<br />
<br />
==== Gramps for Windows with MSYS2 ====<br />
<br />
How to use [https://www.msys2.org/ MSYS2] to run latest Gramps development version from source in 64bit Windows.<br />
<br />
* [[Gramps for Windows with MSYS2]]<br />
<br />
{{-}}<br />
<br />
=== Missing other languages ===<br />
[[File:Microsoft Window Gramps AIO Installer Choose Components-Selection-51.png|right|thumb|450px|Microsoft Window Gramps AIO Installer Choose Components-Selection window.]]<br />
The default Gramps AIO installer will embed the US dialect of English for the interface with the British spellcheck dictionary. <br />
<br />
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.<br />
<br />
To install a language other than English, select from both the '''Translations''' ''and'' '''Dictionaries''' during the Choose Components phase of the installation.<br />
<br />
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.<br />
<br />
There is no simple facility for adding interface or dictionary languages after installation.<br />
{{-}}<br />
<br />
<span id="Mac OS X><!-- backward compatibility hyperlinking anchor--><br />
<br />
== macOS ==<br />
</span><br />
[[File:macos_200x200.png|128px|left|link=Download#Mac_OS_X]] <br />
<br />
Before downloading the ready-to-run stand-alone bundle: 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>]]. Read the [[Mac OS X:Application package|before installation]] instructions.<br />
<br />
Tested for compatibility with Apple macOS/Mac OS X versions 10.13 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_10.13:_%22High_Sierra%22 High Sierra]) through 14 ([https://en.wikipedia.org/wiki/MacOS_version_history#Version_14:_%Sonoma%22 Sonoma]). ''Help determining your Operating System version can be found in the [https://support.apple.com/en-us/HT201260 HT201260 Apple Support article.]''<br />
<br />
<big><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_intel}}.dmg Intel {{version_Mac}}]</u><br />
* <u>[{{github_url}}/releases/download/v{{version_Mac}}/{{Filename_mac_arm}}.dmg Apple Silicon {{version_Mac}}]</u><br />
</big><br />
<br />
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. (For Apple Mac OS X, alternatively, you can click and hold on the disk icon at the top of the window of the mounted disk, and then option-drag to the Applications folder. This will create a new folder containing all the files, including the README and NEWS.)<br />
<br />
<br />
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 />
<br />
=== Alternative independent installation ===<br />
[[File:Gramps-release.png|left]]<br />
Alternatively, Gramps can also be built and installed on macOS using MacPorts.<br />
<br />
{{-}}<br />
==== MacPorts ====<br />
<br />
MacPorts is a package manager for Apple Mac.<br />
<br />
* [[Mac_OS_X:Build_from_source:MacPorts|MacPorts]]<br />
<br />
Why use the version from MacPorts? Certain plugins or add-ons require additional supporting software in order to operate. With MacPorts, you can install such software easily (most of the time; there could be exceptions). With the official .dmg installer, installing such additional software is more difficult or impossible.<br />
<br />
The [[Addon:Prerequisites_Checker_Gramplet|Prequisites Checker]] can identify if any add-ons have been installed that require such additional software.<br />
<br />
{{-}}<br />
<br />
==== Homebrew ====<br />
<br />
The macOS application bundle can also be installed via the Homebrew package manager as a cask. Note that this is *not* a Homebrew build, it is a repackaging of the same Gramps.app provided in the above dmg. It does not depend on or use any of the Homebrew-built libraries.<br />
<br />
<br />
[https://wikipedia.org/wiki/Homebrew_(package_manager) Homebrew] is an open-source package manager for macOS (and Linux). <br />
<br />
See https://github.com/homebrew/<br />
<br />
<br />
{{-}}<br />
<br />
=== Adding additional Spell Checking languages on macOS ===<br />
{{man tip|[[Mac_OS_X:Application_package#Dictionaries|Spell Checking:]]|Gramps uses a different spell checker than the one provided by Mac OS X, with different spelling dictionary requirements. We can't easily provide dictionaries for all of the supported languages in the bundle, but they're easily downloaded from [https://extensions.openoffice.org/ OpenOffice.org's website]. Download the language you want and save it, then navigate to the download in Finder. Most browsers have a downloads window that offers "Show in Finder" in its context menu. Change the file extension from <tt>oxt</tt> to <tt>zip</tt>, then from the context menu select '''Open with... Archive Utility''' to decompress it. In the decompressed folder or perhaps in a subfolder you'll find the dictionary files in pairs, <tt>foo.aff</tt> and <tt>foo.dic</tt>. Some languages have more than one pair with a README file to explain why. Select a pair and copy it to /Library/Dictionaries (you'll have to authenticate with an administrator id and password), and if 'foo' isn't already a language or locale code, make it one. For example, the French package includes several pairs with names like <tt>fr-moderne.aff</tt> and <tt>fr-moderne.dic</tt>. The spell checker doesn't recognize those names, so when you copy them to /Library/Dictionaries you must rename them to <tt>fr.aff</tt> and <tt>fr.dic</tt> or <tt>fr_FR.aff</tt> and <tt>fr_FR.dic</tt>. You can have more than one dictionary pair installed if you use several languages, but one '''must''' match the language you use for Gramps or spell checking won't be enabled at all.}}<br />
<br />
{{-}}<br />
<br />
== <span id="Linux distributions"></span>Linux and BSD distributions ==<br />
{{man note|These packages are built and supported by the [https://en.wikipedia.org/wiki/Linux_distribution distros].|If your distribution is not listed you may possibly find it listed on [https://repology.org/metapackage/gramps/versions ''Repology'']<br>Please report any problems with them to the package maintainer.}}<br />
Most Linux distributions come bundled with a version of Gramps, though it's not always the most recent version and it may not have been installed by default. Still it is recommended to use the Gramps version that comes with your distribution.<br />
<br />
Below are ways to install Gramps on some of the more popular distributions:<br />
<br />
{| {{prettytable}}<br />
!style="width: 85pt;" | Distribution<br />
!GUI Package manager<br />
!Current versions<br />
!Notes<br />
|-<br />
|<!-- Distribution -->[[File:Debianopenlogo-32.png|link=https://packages.debian.org/search?keywords=gramps]]''' [[Debian]] '''<br />
|<!-- GUI Package manager -->Add/Remove Software<br />
|<!-- Current versions --><br />
* Debian 10 ("buster") (old stable): Gramps 5.0.1 <!-- https://wiki.debian.org/LTS Debian LTS support for Debian 9 "buster from August 1st, 2022 to June 30th, 2024 --><br />
* Debian 10 ("buster")([https://packages.debian.org/buster-backports/gramps backports]) (stable): Gramps 5.1.2<br />
* Debian 11 ("bullseye")(stable): Gramps 5.1.3<br />
* Debian 11 ("bullseye")([https://packages.debian.org/bullseye-backports/gramps backports]): Gramps 5.1.6<br />
* Debian 12 ("bookworm")([https://packages.debian.org/source/bookworm-backports/gramps backports]): Gramps 5.1.6<br />
* trixie (testing): ([https://packages.debian.org/source/trixie/gramps Gramps 5.1.6])<br />
* [http://packages.debian.org/sid/gramps sid (unstable)]: Gramps 5.1.6<br />
|<!-- Notes -->[http://packages.debian.org/search?keywords=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Ubuntu_32x32.png]] '''[https://ubuntu.com/ Ubuntu]'''<br />
|<!-- GUI Package manager -->Software Centre<br />
|<!-- Current versions --><br />
* Bionic Beaver (18.04 LTS): Gramps: 5.1.2<br />
* Focal (20.04 LTS): Gramps: 5.1.3<br />
* Hirsute (21.04): Gramps: 5.1.3<br />
* Impish (21.10): Gramps: 5.1.4<br />
* Jammy (Development: 22.04): Gramps: 5.1.5<br />
|<!-- Notes -->[http://packages.ubuntu.com/search?keywords=gramps&searchon=names available versions]/ (Also see: [https://launchpad.net/~rosco2/+archive/ubuntu/backports Backports])<br />
|-<br />
|<!-- Distribution -->[[File:Farm-Fresh linux mint.png]]''' [https://www.linuxmint.com/ Linux Mint]'''<br />
|<!-- GUI Package manager -->Software Manager<br />
|<!-- Current versions --><br />
* 19.x(Gramps 4.2.8) <!-- EOL April 2023 --><br />
* 20.x(Gramps 5.1.2) <!-- EOL April 2025 --><br />
|<!-- Notes --><br />
* Use the "Software Manager" to install a recent version.<br />
* Manually install the most current version of Gramps using the following [https://forums.linuxmint.com/viewtopic.php?t=220159 instructions] from the ''Linux Mint Forums''<br />
* [http://community.linuxmint.com/software/view/gramps Old versions available from Linuxmint]<br />
|-<br />
|<!-- Distribution -->[[File:Fedora_32x32.png]] '''[https://getfedora.org/ Fedora]'''<br />
|<!-- GUI Package manager -->Add/Remove Software (Gnome)<br>or<br>Software Management (KDE)<br />
|<!-- Current versions --><br />
* <abbr title="Rawhide - Fedora development version">[https://docs.fedoraproject.org/en-US/releases/rawhide/ Rawhide]</abbr> (Gramps 5.1.5)<br />
* Fedora 38 (Gramps 5.1.6)<br />
* Fedora 39 (Gramps 5.1.6)<br />
* Fedora 40 (Gramps 5.1.6)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.6<br />
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 --><br />
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 --><br />
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 --><br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
|<!-- Notes -->[https://archlinux.org/packages/extra/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
* Gramps 5.1.6 (testing)<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager -->[https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/index.html pkgsrc] ([https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/index.html databases])<br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.6nb1]<br />
|<!-- Notes --> [https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/gramps5/index.html available 5.x.x versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --> [https://ports.freebsd.org/cgi/ports.cgi ports.freebsd.org]<br />
|<!-- Current versions --><br />
* FreeBSD: Gramps [https://cgit.freebsd.org/ports/tree/science/gramps 5.1.6]<br />
* FreshPorts: Gramps [https://www.freshports.org/science/gramps/ 5.1.6]<br />
|<!-- Notes --> [https://ports.freebsd.org/cgi/ports.cgi?query=gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager -->[https://openbsd.app/ OpenBSD.app] <br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.6<br />
|<!-- Notes -->[https://openbsd.app/?search=gramps available versions]<br /> openports.se [https://openports.se/ closed on 30 Jan 2023]<br />
|-<br />
|<!-- Distribution --><br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
|<!-- Notes --><br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.<br />
<br />
{{man warn|1=Warning before attempting to install the latest Gramps version, use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.<br />
<br />
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.<br />
<br />
If you already have Gramps installed, and you are only making a 'point' upgrade (i.e., from Gramps x.y.z to x.y.z+1, e.g., from 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package currently installed on your system and gives you info about it.<br />
<br />
The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on<br />
you can compare the required Dependencies with the new version you downloaded with the following command:<br />
<br />
dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb<br />
<br />
for example, you can get just the two Depends lines to compare using:<br />
<br />
dpkg-query -s gramps | grep Depends:<br />
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub].<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}<br />
<br />
You can also try an online demonstration of version 5.1.4 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': <br />
<br />
* https://www.rollapp.com/app/gramps<br />
<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data. See : [[How to make a backup]]<br />
<br />
== See also ==<br />
GitHub Releases <!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
[[Category:Documentation]]<br />
5.1.5)<br />
* Fedora 38 (Gramps 5.1.6)<br />
* Fedora 39 (Gramps 5.1.6)<br />
* Fedora 40 (Gramps 5.1.6)<br />
|<!-- Notes -->[https://koji.fedoraproject.org/koji/packageinfo?packageID=1969 available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.mageia.org/en/ Mageia]'''<br />
|<!-- GUI Package manager -->|[https://wiki.mageia.org/en/Installing_and_removing_software drakrpm (or rpmdrake)]<br />
|<!-- Current versions --><br />
* Mageia [https://madb.mageia.org/package/show/name/gramps/release/cauldron/ Caulron]: Gramps 5.1.5<br />
* Mageia 8.0: Gramps 5.1.3<br />
|<!-- Notes -->[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|<!-- Distribution -->[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|<!-- GUI Package manager -->[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|<!-- Current versions --><!-- https://www.mageia.org/en/support/ --><br />
* openSUSE Tumbleweed: Gramps 5.1.6<br />
* openSUSE Leap 15.4: Gramps 4.2.8 <!-- is expected to be maintained until 2023-12-31 https://en.opensuse.org/Lifetime#openSUSE_Leap --><br />
|<!-- Notes -->[https://software.opensuse.org/package/gramps available versions]<br>The most recent version can usually be installed from the 'openSUSE BuildService - GNOME:Apps' repository<br />
|-<br />
|<!-- Distribution -->[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* 15.0: Gramps 5.1.2 - [https://slackbuilds.org/repository/15.0/misc/gramps/?search=gramps slackbuilds.org]<br />
* 14.2: Gramps 5.1.2 - [https://slackbuilds.org/repository/14.2/misc/gramps/?search=gramps slackbuilds.org]<!-- EOL 2024-01-01 --><br />
* 14.2: Gramps 4.2.6<!-- EOL 2024-01-01 --><br />
* 14.1: Gramps 4.0.3<!-- EOL 2024-01-01 --><br />
|<!-- Notes -->[https://pkgs.org/search/?q=gramps available versions]<br />
|-<br />
|<!-- Distribution -->[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<!-- GUI Package manager --> [https://wiki.archlinux.org/index.php/pacman pacman]<br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
|<!-- Notes -->[https://archlinux.org/packages/extra/any/gramps/ available versions]<br />
|-<br />
|<!-- Distribution -->[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
* Gramps 5.1.6<br />
* Gramps 5.1.6 (testing){{-}}{{-}}{{-}}{{-}}<br />
|<!-- Notes -->[https://packages.gentoo.org/packages/app-misc/gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.netbsd.org/ NetBSD]'''<br />
|<!-- GUI Package manager -->[https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/index.html pkgsrc] ([https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/index.html databases])<br />
|<!-- Current versions --><br />
* NetBSD: [http://pkgsrc.se/databases/gramps5 Gramps 5.1.6nb1]<br />
|<!-- Notes --> [https://cdn.netbsd.org/pub/pkgsrc/current/pkgsrc/databases/gramps5/index.html available 5.x.x versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<!-- GUI Package manager --> [https://ports.freebsd.org/cgi/ports.cgi ports.freebsd.org]<br />
|<!-- Current versions --><br />
* FreeBSD: Gramps [https://cgit.freebsd.org/ports/tree/science/gramps 5.1.6]<br />
* FreshPorts: Gramps [https://www.freshports.org/science/gramps/ 5.1.6]<br />
|<!-- Notes --> [https://ports.freebsd.org/cgi/ports.cgi?query=gramps available versions]<br />
|-<br />
|<!-- Distribution -->'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<!-- GUI Package manager -->[https://openbsd.app/ OpenBSD.app] <br />
|<!-- Current versions --><br />
* OpenBSD: Gramps 5.1.6<br />
|<!-- Notes -->[https://openbsd.app/?search=gramps available versions]<br /> openports.se [https://openports.se/ closed on 30 Jan 2023]<br />
|-<br />
|<!-- Distribution --><br />
|<!-- GUI Package manager --><br />
|<!-- Current versions --><br />
|<!-- Notes --><br />
|}<br />
<br />
<br />
{{-}}<br />
<br />
== Linux: Install latest version ==<br />
<br />
If your distribution doesn't ship with Gramps or you wish to install a different version than it ships with, you could try to install the latest version of Gramps manually.<br />
<br />
{{man warn|1=Warning before attempting to install the latest Gramps version, use your existing installation to [[How to make a backup|make a Gramps XML backup]]|2=Software updates should only be attempted by experienced users, and after having backed up your data... specifically, your Family Trees.<br />
<br />
The version of Gramps that has been included in your distribution will have been tested to work with the components in that distribution. When trying to install a different version of Gramps, there is a possibility that the components needed for the new version of Gramps will not be available for your distribution Or, that the components are available but don't work properly. Such problems might not discovered until after you have already done some work with the new version of Gramps.<br />
<br />
If you already have Gramps installed, and you are only making a 'point' upgrade (i.e., from Gramps x.y.z to x.y.z+1, e.g., from 5.1.3 to 5.1.5), then it is probable that Gramps will continue to work. However, if the change is much greater, especially if it is a major version change (e.g., from 4.y.z to 5.y.z), then the chance that of incompatibilities is much greater.}}<br />
<br />
=== Debian-based ===<br />
For [[File:Debianopenlogo-32.png|link=Download#Debian-based]]'''[[Debian|Debian-based linux distributions]]''' (Which includes [[File:Ubuntu_32x32.png|link=Download#Debian-based]]''' Ubuntu ''') <!--[{{github_url}}/releases/v5.1.5 Download the .deb file].-->[{{github_url}}/releases/download/v{{Version Linux Debian}}/gramps_{{Version Linux Debian}}-1_all.deb Download the .deb file]. Double-click on the downloaded .deb file or (for some distributions, e.g. Mint Debian) run the following command from the directory where the file was saved ({{man menu|change the filename to match the one you downloaded}}).<br />
<br />
sudo dpkg -i gramps_{{Version Linux Debian}}-1_all.deb<br />
<br />
If you have an error about having unmet dependencies run:<br />
<br />
sudo apt-get -f install<br />
<br />
to install the dependencies.<br />
<br />
If you see an error about an incomplete GTK installation and missing language translations when starting Gramps, run<br />
<br />
sudo apt install language-pack-gnome-en<br />
<br />
to install the proper language pack. You may need to replace 'en' with your own language code, like 'nl' for Dutch.<br />
<br />
==== Useful command lines ====<br />
Before upgrading you can[https://sourceforge.net/p/gramps/mailman/message/35460486/]:<br />
<br />
* Find out what version you are running, by using this:<br />
<br />
dpkg-query -s gramps<br />
<br />
that queries the package currently installed on your system and gives you info about it.<br />
{{-}}{{-}}{{-}}{{-}}<br />
The line that begin with 'Depends:' contains a list of packages and their version numbers that your current installation depends on<br />
you can compare the required Dependencies with the new version you downloaded with the following command:<br />
<br />
dpkg-deb -I gramps_Version.Number.Of.NewDownload_all.deb<br />
<br />
for example, you can get just the two Depends lines to compare using:<br />
<br />
dpkg-query -s gramps | grep Depends:<br />
dpkg-deb -I gramps_5.Version-Number_all.deb | grep Depends:<br />
<br />
* If you are committed to an upgrade then make sure you have backed up you Family Trees to Gramps XML then run :<br />
<br />
sudo dpkg -r gramps<br />
<br />
this will remove the current gramps package (assuming its a python3 version older versions could be python-gramps )<br />
<br />
* To stop Ubuntu updating gramps (to possibly an older version from Ubuntu!) you may need to run:<br />
<br />
sudo apt-mark hold gramps<br />
<br />
'''Upgrade is then complete.'''<br />
<br />
=== Flathub ===<br />
<br />
Gramps {{Version Linux Flatpak}} is available as a Flatpak at [https://flathub.org/apps/search?q=gramps Flathub].<br />
<br />
{{man note|Please use your existing installation to backup your database before proceeding.|Also, it is a good idea to [[Gramps_5.1_Wiki_Manual_-_Manage_Family_Trees#Converting_a_BSDDB_Family_Tree_to_SQLite|convert your database to SQLite]] even though there is currently BSDDB3 support in the {{Version Linux Flatpak}} Flatpak.}}<br />
<br />
First set up Flatpak and the Flathub repository on your system, there are instructions for various distributions at https://flatpak.org/setup/<br />
<br />
Second, you can use the blue install button at https://flathub.org/apps/details/org.gramps_project.Gramps if you set your software manager up to work with Flathub, or use the command below in a terminal for a system wide installation if you have sudo privileges:<br />
<br />
flatpak install flathub org.gramps_project.Gramps<br />
<br />
<br />
{{-}}<br />
<br />
=== For other distributions ===<br />
For other distributions, [[File:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] the source and follow the instructions for [[Linux:Build from source]]<br />
<br />
== BSD ==<br />
<br />
[[File:Bsd daemon.png|128px|left|link=Download#BSD]]<br />
<br />
Before upgrading your distribution: Use your '''old version of Gramps''' to [[How_to_make_a_backup#Gramps_version_3.3_and_later|backup]] your Family Trees [[#1|[1]]].<br />
<br />
<big><br />
<u>[[Download#Linux and BSD distributions|via Distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[Download#Linux:_Install_latest_version|Latest version (advanced users only)]]</u></big><br />
<br />
<br />
See also:<br />
* [[BSD platforms]]<br />
{{-}}<br />
<br />
== Linux Live CD ==<br />
<br />
{{man warn|Outdated version warning|Note this '''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} (an older version released 2010-11-17) and it is not recommended for general use}} <br />
<br />
[[File:Download_link.png|150px|left|link=https://sourceforge.net/projects/gramps/files/gramps-cdrom/lgenealogy-6.1-desktop-i386.iso/download]]<br />
'''Linux live CD Demonstration''' includes Gramps {{Version Linux Live CD}} pre-installed to trial, without touching anything on the hard drive. To start this boot the Computer with this Live Linux Desktop on a CD in the CD/DVD-ROM Drive. (Requires that you write this image to a CD-ROM using CD-Burner software eg:Nero, Imgburn, [https://rufus.ie/en/ Rufus]..). [[Linux_Genealogy_CD#Download_the_CD|Download the CD]] (727 MB). The [[Linux Genealogy CD|Linux Genealogy CD is based on Ubuntu 10.10 (Maverick Meerkat)]]. If you are interested in Gramps, but are afraid to actually install it or unable to install it (not your PC, windows, no internet at home, work laptop, ...), then try out our [[Linux Genealogy CD]]. It runs without installing on the hard disk and contains a collection of open source, free, genealogy programs. You can then install latest [http://www.ubuntulinux.org/ Ubuntu] and Gramps from the CD anytime you like.<br />
{{-}}<br />
<br />
== Online Demonstration ==<br />
{{man warn|Buyer Beware|The following is a limited trial of a commercial cloud VM service (rollApp) that operates by subscription. The listing here is '''''not''''' an endorsement by the Gramps-project.<br /><br />Beware of giving third parties access to your genealogical data.}}<br />
<br />
You can also try an online demonstration of version 5.1.4 of Gramps on rollApp (''"Cloud platform for native applications"'') categorized under '''[https://www.rollapp.com/apps/utilities Utilities]''' - ''[https://www.rollapp.com/apps/diagrams #diagrams]'': <br />
<br />
* https://www.rollapp.com/app/gramps<br />
<br />
Select '''Launch Online''' then '''Test Drive(Opening/saving files will not be available)'''<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
Backup to Gramps XML. You will find backup in the Family Tree menu of recent Gramps versions, otherwise use export in the same menu but '''uncheck privacy options''' in the Exporter Assistant in order to export all data. See : [[How to make a backup]]<br />
<br />
== See also ==<br />
GitHub Releases <!--github_url template = https://github.com/gramps-project/gramps --><br />
:* [{{github_url}}/releases/v{{version}} {{version}} version]<br />
:* [{{github_url}}/releases/ Archive of Gramps releases] <br />
Wiki pages<br />
* [[Previous releases of Gramps]]<br />
* [[:Category:Versions|Versions on various platforms]] <br />
<br />
[[Category:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=T%C3%A9l%C3%A9charger&diff=101509
Télécharger
2024-02-14T14:37:12Z
<p>Nick H: Add OS icons</p>
<hr />
<div>{{languages|Download}}<br />
[[File:Gramp-Small-background-wiki-2020.jpg|120px|left]]<br />
'''Rechercher, organiser et partager votre arbre généalogique avec Gramps.'''<br />
<br />
Gramps est un projet de logiciel libre et communautaire, créé, développé et régi par des généalogistes. Nous nous efforçons de produire un programme de généalogie à la fois intuitif pour les amateurs et disposant de fonctionnalités complètes pour les professionnels.<br />
<br />
{{man note|{{Man menu|'''Version actuelle: {{version}} datée du: 2023-06-30'''}}|''Format de données différent de la série Gramps 3.4.x. Support complet de python 3. Conversion vers GTK+ 3 ... (voir: [[Fr:Manuel_wiki_pour_Gramps_5.0_-_Quoi_de_neuf_%3F|Quoi de neuf ?]])''{{-}}<br />
[[File:Linux_220x261.png|128px|link=Télécharger#Linux]] [[File:windows_180x160.png|128px|link=Télécharger#MS_Windows]] [[File:macos_200x200.png|128px|link=Télécharger#Mac_OS_X]] [[File:Bsd_daemon.png|128px|link=Télécharger#BSD]]}}<br />
<br />
<br />
== Linux ==<br />
<br />
[[Image:Linux_220x261.png|128px|left]]<br />
<br />
Avant de mettre à niveau votre distribution, utilisez votre '''ancienne version de Gramps''' pour [[How_to_make_a_backup/fr|faire une sauvegarde]] de vos arbres familiaux [[#1|[1]]].<br />
<br />
<big><br />
<u>[[#Distributions linux|via les distributions]]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[[#Dernière version|la dernière version (pour les utilisateur(rice)s avancé(e)s)]]</u></big><br />
{{-}}<br />
<br />
== MS Windows ==<br />
<br />
[[Image:windows_180x160.png|128px|left]]<br />
<br />
Avant de télécharger, utilisez votre '''ancienne version de Gramps''' pour [[How_to_make_a_backup/fr|faire une sauvegarde]] de vos arbres familiaux [[#1|[1]]].<br />
<br />
<big><u>[{{github_url}}/releases/download/v{{version_windows_AIO32}}/{{filename_windows_AIO32}}.exe Windows Installer (32-bit) {{version_windows_AIO32}}]</u><br />
&nbsp;&nbsp;&nbsp;&nbsp;<br />
<u>[{{github_url}}/releases/download/v{{version_windows_AIO64}}/{{filename_windows_AIO64}}.exe Windows Installer (64-bit) {{version_windows_AIO64}}]</u></big><br />
<br />
Après le téléchargement, cliquez deux fois du suite sur le fichier pour installer Gramps.<br />
<br />
Normalement, quand vous chargez un arbre familial on vous permet de le mettre à niveau si nécessaire, puis il sera ouvert. Néanmoins si cela devait échouer pour une raison quelconque, '''Créez''' un nouvel arbre familial et '''Importez''' votre sauvegarde dans ce nouvel arbre.<br />
<br />
Une version alternative et indépendante existe également[[#3|[3]]].<br />
<br />
== Mac OS X ==<br />
<br />
[[Image:macos_200x200.png|128px|left]]<br />
<br />
Avant de télécharger, utilisez votre '''ancienne version de Gramps''' pour [[How_to_make_a_backup/fr|faire une sauvegarde]] de vos arbres familiaux [[#1|[1]]].<br />
<br />
Lire les instructions [[Mac OS X:Application package|avant l'installation]].<br />
<br />
MacOS X 10.10 au moins pour Gramps 5.1 (MacOS 10.9 pour Gramps 5.0) &nbsp;&nbsp;&nbsp;&nbsp;<big><u>[{{github_url}}/releases/download/v{{version_Mac}}/{{filename_mac_intel}}.dmg Intel {{version_Mac}}]</u></big> [https://github.com/gramps-project/gramps/releases Toutes les versions]<br />
&nbsp;&nbsp;&nbsp;&nbsp; <br />
<br />
Après le téléchargement, cliquez deux fois de suite sur le fichier .dmg pour monter le disque (notez que en général votre navigateur le fait automatiquement). Puis glissez l'application Gramps vers votre répertoire d'applications et cliquez deux fois de suite pour lancer Gramps[[#2|[2]]].<br />
<br />
Normalement, quand vous chargez un arbre familial on vous permet de le mettre à niveau si nécessaire, puis il sera ouvert. Néanmoins si cela devait échouer pour une raison quelconque, '''Créez''' un nouvel arbre familial et '''Importez''' votre sauvegarde dans ce nouvel arbre.<br />
<br />
Une version alternative et indépendante existe également[[#3|[3]]].<br />
<br />
== Distributions Linux et BSD ==<br />
<br />
La plupart des distributions linux fournissent une version de Gramps prête à l'emploi, en revanche il ne s'agit pas toujours de la version la plus récente et elle n'est pas toujours installée par défaut.<br />
<br />
Ci-dessous les méthodes pour installer Gramps avec les distributions les plus populaires :<br />
<br />
{| {{prettytable}}<br />
!Distribution<br />
!Gestionnaire de paquets (avec interface)<br />
!Versions actuelles<br />
!Notes<br />
|-<br />
|[[Image:Debianopenlogo-32.png]]''' [[Debian]] '''<br />
|Add/Remove Software<br />
|Stretch (old stable): Gramps 4.2.5<br>Bullseye (stable): Gramps 5.1.3<br>[http://packages.debian.org/sid/gramps Sid (unstable)]: Gramps 5.1.5<br />
|[http://packages.debian.org/search?keywords=gramps versions disponibles]<br />
|-<br />
|[[Image:Ubuntu_32x32.png]]''' Ubuntu '''<br />
|Ubuntu Software<br />
|Xenial (16.04 LTS): Gramps: 4.2.2<br>Bionic (18.04 LTS): Gramps: 4.2.8<br>Focal (20.04 LTS): Gramps: 5.1.2 <br>Jammy (22.04 LTS): Gramps: 5.1.5 <br>Mantic (23.10): Gramps: 5.1.5<br />
|[http://packages.ubuntu.com/search?keywords=gramps&searchon=names versions disponibles]<br />
|-<br />
|[[Image:Farm-Fresh linux mint.png]]<br>'''Linux Mint'''<br />
|Software Manager<br />
|Vera 21.1 (Gramps 5.1.5)<br>Una 20 (Gramps 5.1.2) <br />
|[http://community.linuxmint.com/software/view/gramps versions disponibles]<br />
|-<br />
|[[Image:Fedora_32x32.png]]''' Fedora ''' <br />
|Ajouter/Enlever applications (Gnome) ou <br>Software Management (KDE)<br />
|Rawhide (Gramps 5.1.5)<br>Fedora 38 (Gramps 5.1.5)<br>Fedora 37 (Gramps 5.1.5)<br />
|[https://packages.fedoraproject.org/pkgs/gramps/gramps/ versions disponibles]<br>Note: les projets Fedora et RedHat ont fusionné le 22 Septembre 2003. <br />
|-<br />
|'''[https://www.mageia.org/en/ Mageia]'''<br />
|[https://wiki.mageia.org/en/Installation_et_suppression_de_logiciels-fr drakrpm (or rpmdrake)]<br />
|Mageia Caulron: Gramps 4.2.5<br>Mageia 5.0: Gramps 4.1.3<br>Mageia 8.0: Gramps 5.1.3<br />
|[http://mageia.madb.org/package/show/name/gramps Mageia App Db - gramps]<br />
|-<br />
|[[File:OpenSUSE-distribution-icon.png|32px]] '''[https://www.opensuse.org/ openSUSE]'''<br />
|[https://en.opensuse.org/YaST_Software_Management YaST]<br />
|openSUSE Tumbleweed: Gramps 5.1.5<br>openSUSE Leap 15.5 : Gramps 5.1.5<br />
|[http://software.opensuse.org/package/gramps versions disponibles]<br>Voir note [http://gramps.1791082.n4.nabble.com/ahnenforschung-familie-ihle-de-td4672224.html#a4672266]<br />
|-<br />
|[[File:Slackware-distribution-icon.jpg|32px]] '''[http://www.slackware.com/ Slackware]'''<br />
|<br />
|14.2: Gramps 3.4.3<br>14.1: Gramps 4.0.3<br />
|[https://packages.slackware.com/ versions disponibles]<br />
|-<br />
|[[File:archlinux-icon-crystal-32.svg]] '''[https://www.archlinux.org/ Arch Linux]'''<br />
|<br />
|Gramps 4.2.5<br />
|[https://www.archlinux.org/packages/community/any/gramps/ versions disponibles]<br />
|-<br />
|[[File:Gentoo-distribution-icon.png|32px]]'''[https://gentoo.org Gentoo Linux]'''<br />
|<br />
|Gramps 4.2.4<br />
|[https://packages.gentoo.org/packages/app-misc/gramps versions disponibles]<br />
|-<br />
|'''[https://www.netbsd.org/ NetBSD]'''<br />
|<br />
|NetBSD: Gramps 3.4.4<br />
|[http://pkgsrc.se/databases/gramps3 versions disponibles]<br />
|-<br />
|'''[https://www.freebsd.org/ FreeBSD]'''<br />
|<br />
|FreeBSD: Gramps 4.2.4<br />
|[http://portsmon.freebsd.org/portoverview.py?category=science&portname=gramps versions disponibles]<br />
|-<br />
|'''TrueOS'''<br />
|<br />
|PC-BSD: Gramps 3.4.8<br />
|[http://web.pcbsd.org/pc-bsd-is-now-trueos/?lang=fr 2016/09/01 - PC-BSD devient TrueOS]<br />
|-<br />
|'''[https://www.openbsd.org/ OpenBSD]'''<br />
|<br />
|OpenBSD: Gramps 4.2.5<br />
|[http://openports.se/misc/gramps versions disponibles]<br />
|}<br />
<br />
{{-}}<br />
<br />
== Dernière version (Linux) ==<br />
<br />
Si votre distribution ne fournit pas Gramps ou si vous souhaitez installer une version différente de celles proposées, vous pouvez essayer d'installer la dernière version de Gramps manuellement. Les instructions suivantes sont données pour de nombreuses distributions.<br />
<br />
{{man warn|1=Attention|2=Ceci devrait être tenté par des utilisateur(rice)s expérimenté(e)s, et après avoir sauvegardé vos arbres familiaux.<br />
<br />
La version de Gramps présente pour votre distribution a été testée pour fonctionner avec les composants de votre distribution. Si vous tentez d'installer une version différente de Gramps il y a une possibilité que les composants nécessaires pour cette nouvelle version ne sont pas disponibles pour votre distribution, ou ils sont disponibles, mais ils ne fonctionnent pas correctement.<br />
<br />
Si Gramps est déjà installé, une mise à jour de quelques 'point(s)' (çàd de Gramps x.y.z àx.y.z+1, par exemple de 3.4.3 à 3.4.4), alors il est fort probable que Gramps fonctionnera encore. En revanche, si la différence est plus importante, surtout pour une migration vers une nouvelle version majeure (par exemple de 2.y.z à 3.y.z), alors le risque est plus grand.}}<br />
<br />
[[Image:Debianopenlogo-32.png]]'''Debian''' et [[Image:Ubuntu_32x32.png]]''' Ubuntu ''' [{{github_url}}/releases/v{{version}} : télécharger le fichier .deb]. Double-cliquez sur le fichier .deb téléchargé ou (pour certaines distributions, par exemple Mint Debian) exécutez la commande suivante à partir du répertoire où le fichier a été enregistré (changer le nom du fichier pour correspondre à celui que vous avez téléchargé).<br />
<br />
sudo dpkg -i python-gramps_{{version}}-1_all.deb<br />
or<br />
sudo dpkg -i python3-gramps_{{version}}-1_all.deb<br />
<br />
Pour les autres distributions, téléchargez la source [[Image:Download_link.png|150px|link={{github_url}}/releases/v{{version}}]] et suivez les instructions pour [[Linux:Build from source/fr|construire depuis la source]].<br />
<br />
== Live CD ==<br />
<br />
[[Image:Download_link.png|150px|left|link=http://sourceforge.net/projects/gramps/files/OldFiles/3.2.5/lgenealogy-6.1-desktop-i386.iso]]<br />
'''Linux live CD Demonstration''' [[Linux_Genealogy_CD/fr#Obtenir le_CD|Obtenir le CD]] (727 MB) [[Linux Genealogy CD/fr|Linux Genealogy CD basé sur Ubuntu 10.10 (Maverick Meerkat)]]. Si vous êtes intéressé(e) par GRAMPS, mais hésitez à l'installer ou vous êtes incapable de le faire (pas votre PC, windows, sans internet à la maison, portable pour le travail, ...), alors essayez notre [[Linux Genealogy CD/fr|CD Linux Genealogy]]. Il tourne sans installation sur votre disque dur et contient une collection de programmes de généalogie, open sources, libres. Vous pouvez également installer [http://www.ubuntulinux.org/ Ubuntu 14.04.2] et GRAMPS depuis le CD autant de fois que vous le souhaitez.<br />
<br />
{{-}}<br />
<br />
== Notes ==<br />
<br />
[<span id="1">1</span>]<br />
Sauvegardez au format Gramps XML. Vous trouverez une option sauvegarde dans le menu des dernières versions de Gramps, dans le cas contraire exportez depuis le même menu mais '''décochez les options sur la vie privée''' dans l'assistant d'exportation pour ne pas filtrer vos données.<br />
<br />
[<span id="2">2</span>]<br />
De même, vous pouvez cliquer et rester sur l'icône disque en haut de la fenêtre du disque monté, puis utiliser l'option glisser vers le répertoire des Applications. Ceci va créer un nouveau répertoire avec tous les fichiers, incluant README et NEWS.<br />
<br />
[<span id="3">3</span>]<br />
Une version alternative et indépendante existe : [http://sourceforge.net/projects/portableapps/files/Gramps%20Portable/ GrampsPortable_{{version_windows_portable}}.paf.exe] (20.3 MB) <br />
[http://portableapps.com/apps/education/gramps_portable Portable Gramps from PortableApps.com] inclut toutes les dépendances requises pour Windows. ''Notez que vous pouvez l'installer sous C: puis saisissez C:\PortableApps\GrampsPortable\GrampsPortable.exe (le chemin d'installation) ou générez un raccourci pour votre bureau ou menu Démarrer.'' Par Bart.S - '''[http://portableapps.com/blog/84601 Rapportez les problèmes à son auteur.]''' (2012-09-07)<br />
<br />
[[Category:Fr:Documentation]]</div>
Nick H
https://gramps-project.org/wiki/index.php?title=What_to_do_for_a_release&diff=101505
What to do for a release
2024-02-10T15:54:17Z
<p>Nick H: /* Announce a string freeze */</p>
<hr />
<div>{{man note|Developer notes for '''What to do for a release '''}}<br />
<br />
Note that the main use of this page will be for making a normal "minor" release. If you are making a "major" release (e.g. x.y.0) then you will need to update this page first, to change the numbers. But if you are only making an "alpha" or "beta" release, some steps may be skipped, or altered slightly.<br />
<br />
Note also that there are additional necessary [[What_to_do_for_a_release#Post-release|Post release]] tasks which are related to making a new release. For instance, the wiki will require making a new release-section and updating [[Template:Version_Templates#General|"General" version templates]]. For the making a new release-section on the bug tracker. Or when making new Debian and Mac and Windows [[:Category:Developers/Packaging|packaging]], they will need to be coordinated with the appropriate [[Team#Package_Maintainers|package maintainers]] and updating the corresponding [[:Category:Versions|Versions]] : [[Template:Version_Templates|Templates]]. <br />
<br />
==Pre-release==<br />
===Agree a release timetable===<br />
<br />
Co-ordinate with the [[Team#Package_Maintainers|package maintainers]] to agree a release timetable.<br />
For a major release there may be a schedule on the [[5.2_Roadmap|Roadmap]]<br />
<br />
===Announce a feature freeze===<br />
For a major release, announce a feature freeze on the ''gramps-devel'' mailing list.<br />
This will usually be about 4 weeks before the release date.<br />
<br />
===Translation update===<br />
The translation template should be updated, if necessary, just before the string freeze is announced.<br />
* Check for new files since the last release:<br />
cd po<br />
intltool-update -m <br />
:That will create a file called <code>missing</code>in the <code>po</code> directory if there are new files that need to be scanned for translatable strings. Examine each of the files listed in <code>missing</code>, adding each to <code>POTFILES.in</code> if it contains translatable string constants and to <code>POTFILES.skip</code> if it does not.<br />
* Generate a new template file:<br />
python3 update_po.py -p # makes a new gramps.pot template file<br />
git diff gramps.pot<br />
:Examine the changes. If they're all just comments about where a string is found you need not commit the change (so the next line will restore the official file, instead of the one you just made):<br />
git restore gramps.pot<br />
:If there have been changes on <code>msgid</code> entries, you'll need to commit <code>gramps.pot</code> and ask translators to update their <tt>.po</tt> files before you can make a release:<br />
git add gramps.pot<br />
git commit -m "Update translation template for new release"<br />
<br />
* Check current translation files:<br />
python3 update_po.py -k all<br />
:There should be very few warnings or fatal errors. Warnings related to new languages using default values in their headers are acceptable. There will also be some fatal errors reported due to the non-standard way we handle inflected dates. See the section on [https://gramps-project.org/wiki/index.php/Date_Handler#Localizing_the_date_formats Localizing the date formats] in the [https://gramps-project.org/wiki/index.php/Date_Handler Date Handler] wiki page for further details. For example "{long_month}" may be translated as "{long_month.f[Р]}".<br />
:All other fatal errors should be fixed.<br />
Also see:<br />
* [[Template:Gramps_translations#INCOMPLETE_TRANSLATIONS]] - Update if any translation needs to be added or excluded due to not meeting the minimum 70% completion requirement.<br />
<br />
===Announce a string freeze===<br />
For a major release, announce a string freeze on the ''gramps-devel'' mailing list and on Weblate.<br />
This will usually be about 2 weeks before the release date.<br />
<br />
In the ''Program'' component on Weblate, select "Manage⟶Post announcement" from the menu. Enter an ''Expiry date'' the day before the release date, and select the ''Notify users'' checkbox to send a notification to all subscribed users.<br />
<br />
==Prepare your repository==<br />
* Check out the current stable branch:<br />
git checkout maintenance/gramps{{Stable_branch}}<br />
:That branch name assumes that you're using the same name as the Github repository; if you're not (perhaps you don't use <code>maintenance</code> in the name) use your local name.<br />
* Make sure that your local copy is clean:<br />
git status<br />
: If you have any uncommitted changes, either commit them now or stash them until after you've completed the release.<br />
* Clean up any untracked files and make sure that the local repo is up to date:<br />
git clean -fdx<br />
git pull --rebase<br />
:If you had commits that hadn't been pushed yet they'll show up as "applying" messages in the output of this command. If that's the case re-run the tests and push as usual.<br />
* Build and test to make sure that everything works, then clean the repo of all build products.<br />
<br />
===Check the About box year===<br />
<br />
Check if the year in the {{man label|About}} box needs to be updated<br />
<br />
eg:<br />
''© 2007-2023 The Gramps Developers'' <br />
to<br />
''© 2007-'''2024''' The Gramps Developers''.<br />
<br />
Found in <code>gramps/gen/const.py</code><br />
<br />
===API docs update year===<br />
If needed in the file:<br />
<br />
docs/conf.py<br />
<br />
<br />
Update the year for the copyright.<br />
<br />
copyright = '2001-2024, The Gramps Project'<br />
<br />
===Update Classifier in setup.py===<br />
Change [https://pypi.python.org/pypi?%3Aaction=list_classifiers Classifier] to the appropriate one in [https://github.com/gramps-project/gramps/blob/maintenance/gramps50/setup.py setup.py] (master is always the first one)<br />
<br />
<pre><br />
Development Status :: 1 - Planning<br />
Development Status :: 2 - Pre-Alpha<br />
Development Status :: 3 - Alpha<br />
Development Status :: 4 - Beta<br />
Development Status :: 5 - Production/Stable<br />
</pre><br />
<br />
Check if any additional language classifier needs to be added also.<br />
<br />
==Release name==<br />
Refer to (and update) the [[Previous releases of Gramps|list of previous releases]].<br />
<br />
Previously you needed to select an appropriate name but we have not named releases for several years now. You will still need to add the release though, including things like its relevant color.<br />
<br />
* [[Talk:Previous_releases_of_Gramps|Suggestions]] : For Gramps 5.0 <code>Just remember that you're standing on a planet that's evolving</code><br />
<br />
==Changelog and NEWS file==<br />
<br />
[https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html#section2 Section ''2a''] of the '''G'''eneral '''P'''ublic '''L'''icense says that if you distribute a modified version of a program: ''you must cause the modified files to carry prominent notices stating that you changed the files and the date of any change''. <br />
<br />
Note that the <code>{{version}}</code> below means the ''previous'' version, not the one you're about to release (which is the<br />
<code>..</code>).<br />
git log v{{version}}.. --pretty --numstat --summary --no-merges | git2cl > ChangeLog<br />
git log v{{version}}.. --pretty --numstat --summary --no-merges -- po/*.po | git2cl > po/ChangeLog<br />
git add ChangeLog<br />
git add po/ChangeLog<br />
*Edit and update the <code>NEWS</code> file using the new ChangeLog entries as a guide. If this is the first branch in a new series there will be no NEWS file, so look at a previous release and mimic the format.<br />
Commit the NEWS file:<br />
git add NEWS<br />
git commit -m "Update Changelog and NEWS files"<br />
<br />
==Working on VERSION==<br />
<br />
* Modify <code>[https://github.com/gramps-project/gramps/blob/master/gramps/version.py gramps/version.py]</code> to indicate an official release:<br />
- DEV_VERSION = True<br />
+ DEV_VERSION = False<br />
<br />
* Check that the <code>VERSION_TUPLE</code> reflects the release you're about to make. It should if the version was bumped after the last release. If not, fix it.<br />
<br />
* Save the changes:<br />
git commit -am "Release Gramps {{version}}"<br />
<br />
* Check that the version number is correct:<br />
python3 Gramps.py -v<br />
<br />
* If everything looks good, push the changes:<br />
git push origin maintenance/gramps{{Stable_branch}}<br />
* If that fails then someone pushed a commit while you were working. Return to [[What_to_do_for_a_release#Prepare_your_repository|Prepare your repository]] and start over.<br />
<br />
==Create a tag==<br />
Create the release tag; note the '''v''' leading the actual tag.:<br />
git tag -am "Tag {{version}}" v{{version}}<br />
<br />
==Push to repository==<br />
Push the changes to the repository:<br />
git push origin v{{version}}<br />
<br />
===Move to the new release number on branch ===<br />
<br />
Bump the version number in <code>gramps/version.py</code><br />
<br />
Update the version for the release:<br />
VERSION_TUPLE = (4, 2, ...)<br />
<br />
Revert change on <code>DEV_VERSION</code> so that the git revision is appended to the reported version in non-release builds:<br />
- DEV_VERSION = False<br />
+ DEV_VERSION = True<br />
<br />
Save change:<br />
git commit -am "Bump to <new version number>"<br />
git push<br />
<br />
===Github===<br />
* Github generates a tarball automatically when we push a tag.<br />
* Go to [https://github.com/gramps-project/gramps Github] and log in if necessary.<br />
* Select '''NN Releases''' from the line of items just above the thick line ('''NN''' is the number of releases so far).<br />
* Find the tag you just pushed and click it, or click the "Draft a new release" button.<br />
* Copy the NEWS file contents into the '''Write''' tab. You can use the '''Preview''' tab to check your formatting.<br />
* Click '''Publish Release''' at the bottom of the edit area when you're satisfied with the contents.<br />
<br />
===SourceForge===<br />
* Go to [https://sourceforge.net/projects/gramps/files/ the SourceForge files page] and log in if necessary.<br />
* Click on '''Stable''' or '''Unstable''' depending on the class of the release you're making.<br />
* Click '''Add Folder''' and name the directory for the release version. Click "'Create'". Click your new folder to enter it.<br />
* You can either download the GitHub-generated tarball or create one locally:<br />
python3 setup.py sdist<br />
* Click '''Add File''' and drag the tarball to the drop area on the web page.<br />
* Copy the release notes from GitHub into a file called README.md and upload it.<br />
<br />
==Announcing the new release==<br />
* update mantisdb(Bug/issue database) and enable the new version via Admin:Projects item for reporting issues. (You will need a high-enough status on the bug tracker in order to do this, so you can ask an appropriate person if you aren't.)<br />
* announce on gramps-announce@lists.sourceforge.net, gramps-devel@lists.sourceforge.net and gramps-users@lists.sourceforge.net (You will need to be a member of all three lists first, to send to them.)<br />
* announce on the Discourse forum in the "[https://gramps.discourse.group/c/gramps-announce Announcements]" category.<br />
* announce on Gramps [https://gramps-project.org/blog/blog/ blog] (File under: [https://gramps-project.org/blog/category/releases/ Gramps Releases] and [https://gramps-project.org/blog/category/news/ News]) (not needed for an alpha or beta release)<br />
* update [[News]] section on this wiki (not needed for an alpha or beta release)<br />
* update the list of [[Previous releases of Gramps|previous releases]]<br />
* update reference to the new version on the [[Template:Version|wiki template]] (not needed for an alpha or beta release)<br />
* Verify other [[:Category:Versions|"version" Wiki templates]] values: Last version, Stable version, etc.<br />
* update [[HeadlineNews]] (not needed for an alpha or beta release)<br />
* update release date on the [[Download]] page (not needed for an alpha or beta release)<br />
* change the Matrix room title and IRC channel title (not needed for an alpha or beta release) <br />
* update the version number at [https://en.wikipedia.org/wiki/Gramps_(software) Wikipedia] (not needed for an alpha or beta release)<br />
<br />
==Post-release==<br />
* merge forward the <code>NEWS</code> file<br />
<br />
=See also=<br />
*Category [[:Category:Versions|Versions]] : [[Template:Version_Templates|Template]]<br />
*Building a distribution to share as on the [[Download]] page<br />
:[[File:Windows_32x32.png]] [[Building Gramps AIO cx freeze-based]] - Updating the MS-Windows 32-bit and 64-bit All-In-One packages<br />
<!--<br />
:[[File:Linux 32x32.png]] please add link to instructions on building Gramps installers for Linux. proofed while building v5.1.3 <br />
:[[File:Beastie 32x32.png]] please add link to instructions on building Gramps installer for BSD. proofed while building v5.1.3 <br />
:[[File:Apple logo black 32x32.png]] please add link to instructions on building Gramps installer for Apple. proofed while building v5.1.3 <br />
--><br />
* [[Brief introduction to Git]]<br />
* [[Running a development version of Gramps]]<br />
* [[:Category:Developers/Packaging]]<br />
* [[:Category:AppData]] - Screenshots used by Appdata - Debian<br />
* [[.dtd and .rng]]<br />
* [[Rollover_for_the_manual|Rollover for the Wiki]] - for major and minor releases. No rollover for maintenance releases.<br />
* [[Special:WhatLinksHere/Template:Bug|List of pages linked to Bug Report template]] - verify the reported issues still apply to the new release. Leave links in place for any issue fixed in maintenance releases. Simply add notations for the version where the fix was applied. Remove links for fixed issues in Rollovers.<br />
<br />
=External links=<br />
* https://github.com/gramps-project<br />
* https://gramps-project.org/cpanel<br />
* https://sourceforge.net/projects/gramps/<br />
<br />
[[Category:Developers/General]]<br />
[[Category:Developers/Packaging]]</div>
Nick H