Addon:Isotammi addons

From Gramps
Jump to: navigation, search

The Taapeli Project (which is a national database of Suomen Sukututkimusseura ry : the Finnish Genealogical Society) curates their own set of "Isotammi lisäosia" : “Big Oak (the mythological World Tree) add-ons” for Gramps. The Isotammi Project is a platform that coordinates validated merging of remote researcher's independent work into a collaborative genealogical collection.

This group of addons are designed to help Gramps users make their data compliant to Isotammi project. (Their server also contains tools for cleaning up GEDCOM dialects from other software.)

Isotammi users can import data as .gramps and .gpkg formats and browse it. Isotammi software is built on Neo4j (a high-speed graph database), Python and Flask (a lightweight WSGI web application framework), and increasingly Vue (a progressive JavaScript Framework for building user interfaces).

The main challenge now is auditing and merging user’s candidate material to approved data. Future plans include a live API to Isotammi. The API would allow transferring common identifiers, reference places and sources back to the researchers’ Gramps database.

The reason for competing with world-wide services is to get better harmony with Scandinavian name formats and local archives. And, in compliance with regional privacy regulations, to keep the data safely in Finland.


Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.
An Addons Offline Manual is available for review.

Please note this group of addons require an additional step to install.

Follow the installation instructions on this page.

Fig. Isotammi.1 Isotammi Tools menu

Once installed:

  • Gramplets are available from the:
    • Dashboards add a gramplet right click menu. (Isotammi configuration / Deep Connections Graph / PropertyEditor )
    • Events category add a gramplet drop down on the bottombar ( Dates )
  • Tools are available under the Tools > Isotammi tools -> ... menu.
  • New Rules are available as described below.
  • Exporter for Isotammi XML export

About Isotammi was an online service provided by the Genealogical Society of Finland (Suomen Sukututkimusseura, abbreviated SSS) made by volunteers that took into account the special characteristics of Finnish genealogical research.

The SSS name is composed of three Finnish words:

  • "Suomen" - This is the genitive case of the word "Suomi", meaning "Finland".
  • "Suku" - This word means "family", "kin", or "lineage".
  • "tutkimus" - This word means "research" or "study".
  • "seura" - This word means "society" or "association".

So, the full name "Suomen Sukututkimusseura" literally translates to "Finland's Family Research Society" or "The Genealogical Society of Finland".

The service contains sourced family trees compiled by users, so called HisKi-trees made from materials in HisKi as well as place name databases compiled from communion books. Users are also provided with quality guidelines, recommendations and tools.

The Isotammi team decided to end the service on May 31, 2024

The publicly announced reasoning was that the costs are too high compared to the use and that further development of the application would have required resources that we did not have available. The team states that they have reached their goal of promoting good research practice with the ease of references to original sources and the researcher's own quality controls. Isotammi, instructions and Gramps accessories have been made with Finnish development work in the era of transnational giants.

The service's software is still available as open source code, and other publication channels are being sought for its databases (location information, Hiskipuut, common family trees).

The Isotammi Facebook group and the Gramps Finland focused Google group still serve. The Isotammi team (Jorma, Juha, Kari, Pekka, Timo) thanks the users and their partner SSS for the past 10 years.

The Society will retain and archive the content of the web service, genealogical data and geographical databases.

Isotammi extensions developed for Gramps will not be affected by the end of the online service.

The Service and its Aims

Isotammi is developed domestically in Finland and this is where it begins it difference from commercial services. It relies on open source software and its own programming. The service is wholly non-commercial and all its public information is owned and controlled by the Society. The Society's role and it being domestically developed means that the service supports the special features of Finnish genealogy.

The user can also edit materials to Isotammi and browse materials uploaded to it online and on mobile devices. With the user's permission some materials are also public for all users. Registration is required to use Isotammi.

The aim of Isotammi is to support the principles of good research practices and to raise the quality of researchers' genealogy materials. The information on family trees should be supported by primary sources. References to them should be to as precise information as possible. Changes to personal names are managed with alternative names. The location of events are specified by attaching a hierarchy to them, i.e. giving information as to what larger whole it to which it belongs. For example, farm-house-village-municipality. Dozens of Place Name Databases in Isotammi help with these hierarchies.


Beware the false "The addon repository appears to be unavailable. Please try again later." message

Please note the Isotammi server has Finnish, Swedish & English lists. Old versions of the Plugin Manager Enhanced gave a false failure message if Gramps is running in any other language.

Update the Plugin Manager Enhanced if checking the Isotammi server for updates returns the message: "The addon repository appears to be unavailable. Please try again later."

Fig. Isotammi.2 General Preferences (Linux)

Isotammi addons installation to get started for Gramps 5.1.x go to Gramps preferences (Edit > Preferences) and replace the value of Where to check: with:

Click Check for updated addons now and install all shown addons or at least the Isotammi configuration Gramplet.

After downloading the Isotammi addons restore the original value of Where to check: with:

After installation go to Gramps Dashboard and add the Isotammi configuration Gramplet which will allow you to select which source to use for installing addons in the future: Gramps default or Isotammi addons

Isotammi addons

Fig. Isotammi.3 Available Isotammi addons (Gramps 5.1.3)

From the website

Follow the instructions to install the Gramps Isotammi addons associated with the Isotammi project.

So far, the following three gramplets, two rules, and one tool are available:



  • Events with an invalid date
  • Events with a valid date


  • Generate source references based on more information

Here are brief descriptions of the above extensions:


Isotammi configuration

Deprecated for Gramps 5.2

The Isotammi Configuration dashboard gramplet is no longer needed. The Isotammi URL functionality was replaced with the Projects portion of the Addon Manager in the Gramps 5.2 version. The API key feature was never leveraged.

A false "The addon repository appears to be unavailable. Please try again later." message may appear when using obsolete versions of the Plugin Manager Enhanced addon in an unsupported locale. Please note the Isotammi server supports Finnish, Swedish and English lists. A false failure message can appear if Gramps is running in any other language.

Update the Plugin Manager Enhanced if checking the Isotammi server for updates returns the message: "The addon repository appears to be unavailable. Please try again later."}} Isotammi configuration Gramplet can be added to the Dashboard to allow you to select from which source the addons are installed e.g. from the default location of Gramps or from the Isotammi addons.

Fig. Isotammi.4 Isotammi Configuration

The Addon source radio buttons switches the Where to check URL of the Third party addons management.

The 2 supported Repositories are: the Default location (the Gramps-Project repository on GitHub):

and the Isotammi (the Taapeli repository also on GitHub):

Fig. Isotammi.5 General Preferences (Linux)

The Gramps preferences button opens the preferences, allowing the selected Addons repository to be manually checked.


Fig. Isotammi.6 Dates Gramplet - detached

The Dates Gramplet is installed in the Events list. It can be used to manipulate event date information, especially to correct dates in the wrong format. First select one or more events to which you want to assign the function and the desired correction function and press Execute. This can be used, etc., with the rule "Events with an invalid date" so that it first generates a filter that looks for invalid dates.

Place tool

Fig. Isotammi.7 PlaceTool Gramplet - detached

The PlaceTool Gramplet can be used to manipulate multiple location data at once. It can form a hierarchy of places from comma-separated place names, the type of places can be changed, it can be used to move places (e.g., villages) inside the right keeper and to correct systematic typos. PlaceTool can be added to the bottombar in the Places category list view.

Deep Connections Graph

Fig. Isotammi.8 Deep Connections Graph Dashboard category gramplet - detached

The Deep Relationship Chart graph produces a graphical diagram of the relationships between two people - The chart shows not only the relationships, but also, for example, sponsorships and other events connections through Associations and through links in Notes.

The Deep Connections Graph gramplet for the Dashboard category is the control for controlling a locally hosted, browser interface to charts of the Deep Connections data. It allows a LocalHost server to be created, the current Tree data to be posted. The server has a Form interface to select two Persons and options for diagramming their direct or indirect connection.

Note that many of the error messages (when the server is unable to generate a graph/chart) are in Finnish.

Fig. Isotammi.9 Deep Connections Graph browser interface


Fig. Isotammi.10 sample Edit Source dialog
Fig. Isotammi.11 Property Editor source gramplet- detached

The Property Editor is a Source category gramplet allowing "Search and Replace" mass updates to selected subsets of Source records.

This tool was designed for use within the Isotammi collaborative Finnish genealogy project. It simplifies harmonization and merging of Source records.

See also
  • Event Description Editor addon tool - Find and Replace text within the Description of Event records.
  • Set Attribute addon tool - Overwrite text within the Attribute records in any Category.
  • SuperTool addon tool - create custom mass updates when at specialized tool does not exist.

Add Sources Gramplet

This gramplet works together with the "Generate citations based on additional information" tool (generatecitations).

This gramplet generates the necessary additional information without having to open the event. All you have to do is select the desired events and copy the additional information in the input field of the gramplet and press the button 'Add to selected events'. Co. additional information can be obtained from the digital directory or sshy's page (in the case of sshy, a browser extension is required or sshy browser extension/caomdaijfcdopklkecajpkoaiamaegkb).

So this does not make source references until the end, but "Create source references based on additional information" must be run at the end anyway.

Direct translation from AddSourcesGramplet/

Multimerge Gramplet

Excerpted from the for the MultiMerge addon in the Isotammi GitHub Repository.

The Multimerge Gramplet allows the merging of multiple objects in a single step. This applies to the following object views:

  • People
  • Families
  • Events
  • Places
  • Citations
  • Sources
  • Repositories
  • Notes
  • Media

Add the MultiMergeGramplet in the sidebar or bottombar of the corresponding view.

Fig. Isotammi.12 Isotammi MultiMerge Gramplet for 3 selected People

Select the objects to be merged and click the button "Merge selected objects".

The gramplet will ask which of the selected objects should be the primary object.The gramplet executes the standard merge function pairwise for the selected objects. The user can select the primary object but otherwise the merges are performed using the defaults for each case.

All changes are done under a single transaction and they can be undone from the Gramps menu Edit -> Undo.

Special handling for families

Two families cannot be merged if the primary family is missing a parent but the other family has the corresponding parent. The gramplet checks for this situation and does not allow selecting such family as the primary family. If there is no suitable primary family among the selected families then the gramplet issues the error "Impossible to merge" and stops.

Special handling for notes:

By default, when merging notes only the text of the primary note is preserved. This gramplet allows saving text from all merged notes by appending the text after the text of the primary note:

Fig. Isotammi.13 After using automerge for all Places with the same Title

There is also an "Automerge" feature. Automerge is accessible from its own tab when the Multimerge Gramplet is added to the splitbars of the Places, Sources and Repositories category views.

This will automatically merge all objects with the same name (or title for Source and Places). As instructed by the Radio Button choice, this affects either: only the selected objects; or, all objects. After the operation, a list of merged objects will be displayed.


Fig. Isotammi.14 Families category's Filter gramplet compared to the Filter+ addon

It is often desirable to use the Filter gramplet interactively find a subset of records. But since Tools, Reports and Exports do not have the option to restrict themselves to that filtered data, this subset either had to be manually re-built as a Custom Filter (which meant discovering which rules corresponded to filter fields) or to Tag the view contents then create a Custom Filter for that Tag.

Filter+ has the option to create a Custom Filter directly from the Filter parameters.

Filter+ gramplets are designed to look very similar to the built-in Filter Gramplets. But Filter+ add-on gramplets are slightly enhanced versions. These addons do NOT upgrade the built-ins. Just add the Filter+ gramplets to the sidebar of each Category. (It is advisable to remove the built-in from the sidebar as the addons include all the original features.)

The enhancements are:

  • There is a new Define filter button that automatically creates a custom filter based on the given criteria. This makes it easy to create simple custom filters.
  • Selecting the Find button also displays the elapsed time to run the filter.
  • The “Father”, “Mother” and “Child” allow searching for multiple partial names in the Families Filter+ fields. This behaves the same way as searching Names in the “People” filter. The un-enhanced filter tried to match the entire string exactly. (For example, “en w” matches for the Father in example.gramps will find 34 families including: “Lawrence Gill” and “Edward Green”. Adding a Child “b te” reduces the list to 4 families.) This 5.1 enhancement is already present in the 5.2 Family category Filter Gramplet.
  • The Citation Filter+ uses “Very low” as the default confidence level. The regular filter defaults to “Normal” (which might miss some citations).
Fig. Isotammi.15 A Families category custom filter defined by Filter+ gramplet

Clicking the Define filter button will scrape the Gramplet parameters into rules for a Custom Filter. After you add a name for the new Custom Filter, the  OK  button becomes active.

The Rules used to simulate the Filter Gramplet in each category (except the Dashboard) are illustrated and listed in the Gramplets section of the wiki:
  People People, Relationships Relationships, Family Families, Charts Charts, Events Events, Places Places,
  Places Geography, Sources (v3.4.x) Sources, Citations Citations, Repositories Repositories, Media Media, Notes Notes

Fig. Isotammi.16 People category Filter+ gramplet with Death Event parameters

The People category Filter+ Gramplet is expanded to include parameters for searching Death Events.

Added Rules:

The Filter+ needed some addon rules to support the same parameter filtering as the Filter gramplet.

  • HasEventBase+ : HasEventBase+ - used by Filter+
  • HasSourceBase+ : HasSourceBase+ - used by Filter+


Fig. Isotammi.17 Isotammi Tools menu

Tools are available under the Tools > Isotammi tools -> ... menu.

Generate source citations from notes

The Generate source citations from notes tool is a specialized tool that can interpret a source reference obtained from a digital directory or SSHY page, which is stored in Gramps, eg for additional information about an event. The tool then forms the based on the text reference to the source, source, and archive Gramps and deletes the original additional information. The additional information must not contain other text and the source reference must be copied there as it is. The tool processes all additional information in this format at the same time. The SSHY source reference must be retrieved using a special SSHY browser extension ( or )

Name Editor Tool

Fig. Isotammi.18 Name editor - tool

The Name Editor Tool standardizes family names in the family tree to eliminate random scribe practices and, to make it easier to find duplicates in the family tree and to merge. For example, Gramps' "MultiMerge" and "Family Auto Merge Tool" work more efficiently the more consistent the nomenclature. In addition, the tool maintains the primary and alternative name types of individuals.


After installing the add-on in Gramps, the tool can be found in the Tools -> Isotammi Tools group

The name editing tool lists the people in the family by line, alphabetically by surname and first name, after a short time. At the top left of the list window is a line of text for filtering. Its value targeting can be refined by name parts and gender as well as name type. Regular expressions (regex) can also be used. At the top right of the list window are the editing preferences, which are described in more detail below.

In the list, the person lines are alphabetically by last name and first name. The information in the line is the person's ID in Gramps (Id), gender (M = male, F = female,? = Unknown), surname Prefix, actual Surname, First names, Suffix (contains patro / matrimonial information according to Isotammi's practice), Title (person's Title) and Type (birth, marriage, known, etc.).

The following figure, which filters people with the letter "r" in the list, provides examples of the need to edit. The situation is very typical when the family tree is combined with material from several sources, in which case there is no uniform practice.

  • the matronymic should be moved to the Suffix
  • suffixes (patronyms and matronyms are mixed in Finnish and Swedish
  • patronym is abbreviated (Joh.sson)
  • the surname deviates from the recommendation of how to mark the unknown part of the name
  • first name and patronymic are the same

If the filter text targets a name part, uncheck the "All" box and check the desired part (s). If gender does not matter, leave the "All" option on it, otherwise the sexual. The Regex box is checked when the corresponding rule is in the "Filter" text. Filtering is started with the "Search" button and the list then contains only the person lines that match the criteria. The "List All" button returns to the unfiltered list.

Practically worth it

  • look at rows filtered, e.g., by women’s first names, because then changes to the rows may not be appropriate for men (e.g., “Christ:” can be safely interpreted as a woman’s name, “Christina,” but for men, it would be “Christer” or Christian).
  • first take care of the abbreviations of the name parts. For their initial filtering, write "Filter" in the text "Filter", for example ";", ".", ";", ".sson" or other string used by scribes to abbreviate parts of names in the congregation.
  • targets conversions to people selected from the list bar. The selection can be made on all rows at once or by picking individual rows. The latter method can be tedious if the original filter selected a large number of rows. This will refine the filtering text (e.g. ":" i.e. select all people's abbreviated first names and patronymics, but "men, first name," Henr: "would only list lines where the first name" Henr: "can be safely decompressed to" Henric ".
Name type

Gramps has a number of standardized name types (Birth Name, Avion Name, Known Name, Unknown), in addition to which the genealogist can define his own types (common ones include Military Name, Taken Name, Noble Name, Artist Name). A person can have several names, one of which is selected as the primary and appears in the person list, and the others are set as alternate names. However, each must have a first name and a patronymic and / or surname. See See also Quality Guidelines for Genealogists on naming conventions.

The tool loads all name types in the genealogy from the selection list and rows can be filtered and edited by name type. In the person line of the list, the primary name type is in bold.

Editing rules

At the top right of the list window are fields and buttons for editing. In basic operation, first select the line of the name part to be edited, write the current value ("Old value") and the desired value ("New value"). For example, in men "Joh." in the first name filtered, the current value is written Joh. and the new value Johan.

The edit only affects the rows that are selected in the list. Filtering alone does not select rows!

All rows are selected at once with the key combination CTRL + A.

The replacement affects part of the text. For example, if the first name is "Lars Sim:" and "Sim:" is to be converted to "Simon", write the old value Sim: and the new value Simon. The first name after this is "Lars Simon".

The Regex rule is available by ticking.

Editing can be activated with "Special Functions", the ticking of which opens up possibilities for moving parts of names between them. (examples of use!)

The editing is performed with the "Replace" button. The "Undo previous change" button cancels the last corrections. An incorrect conversion can also be undone by holding the selected rows and performing a counter conversion, e.g. Old = "Henricz"> New = "Henric".

Due to the possibility of cancellation, it is worth learning how to use the tool by boldly trying different variants, eg for one or a few names at a time.

Please note

Clicking on the list bar opens the respective personal editor. Point-specific changes can be made to it, i.e. only the modification necessary for the person concerned, such as transfers between the primary and alternative names, the correction of a very rare surname clerical error, or the transfer of a surname that has crept into the patronymic to the surname.

Gender is an integral part of editing. The name editing tool cannot be used to edit genders, but the "NameMerge" and "SetGender" tools are available. When used in advance or interrupted by the Name Editor, interrupting the gender encoding improves the impact of the Name Editor.

Name Merge Tool

Fig. Isotammi.19 Name Merge tool

The Name Merge Tool standardizes family names by combining the same but slightly differently spelled first or last name names so that the names of the people are in the genealogy for the Genealogist's own use or for the recipients of the genealogy, either as printouts or gedcom transfer files. The merger significantly reduces the name editing work with the Name Update Tool. The Gramps MultiMerge and Family Auto Merge Tool also work more efficiently the more consistent the nomenclature.

Some common first names have been written by parish scribes in dozens of different forms, based on Swedish and German naming practices (e.g. the name family Heikki <Henric, Henrik, Heinrich, Hinnrich, Hindrick, Hen:, ...). The same variegation exists in other parts of the names (e.g., v/w/fv and f/ph spellings have been used). There is a similarity in surnames, especially in the registration of long foreign surnames.


After starting Gramps, the tool can be found in the Isotammi Tools group - NameMerge opens after a short time after thinking about the list of names of all people's first names, with their personal numbers - at the top of the list window there are gender selections,

The list shows the relevant part of the name and gender in alphabetical order. If the same part of the name has known and unknown genders, the same form of name is in the list of two, followed by the number of persons in the cases in question.

At the top is the "Set gender" checkbox, which automatically updates the gender in the merger for each person involved in the merger, if there is a single case of gender that is known to be merged.


To merge names from a list, follow these steps:

To be merged, left-click and CTRL + left-click the last name in successive names. Discontinuous names can be selected and canceled with the left mouse click of SHIFT + - you can remove the name from the selected ones with the left mouse click of SHIFT + (a good way if there are non-merged names among the ones selected in succession)

The merge is performed with the MERGE button at the top. The merge is canceled by selecting Gramps Edit> Cancel. In the picture, three "Adolf" name spellings are selected and the Merge button is pressed. The tool suggests the form with the most people as the primary one.

The Merge button opens a new window Select primary name ". Where the desired name format is selected as the primary (eg" Adolf "e instead of Adolph" in the figure). When you double-click the merged person after merging, the "Show person" window opens, listing all the people involved in the merger. When you select a person from the list, their Personal Edit window can be opened with the Open button.

In the main Gramps window, the cursor moves in the People list. to the selected person, in which case you can open the person's Relationships window (if necessary, remove the filter from the list and the transfer will take place). This is useful if, for example, the person's first name contains information about his or her parents. In this case, it is not possible to form family relationships automatically when forming huskies. Parents can be corrected in the Relationships window. Note that the most direct way to add parents is to select "add a child to an existing family" using the father's or mother's last name as the search key.

After merging, only the selected primary name format, the number of people and the set gender remain in the tool list.


There are cases at the end of surnames that require other means than merging surnames. The following image shows a few examples of these:

  • The last name starts with a lowercase letter (e.g. "barck"). If the number is small, the fastest way is to select the last name from the list, open the person for editing with a right-click and correct the last name directly in the person's name.
  • The part of the prefix left in the surname (e.g. "d." in the name "d. Pahlen") is corrected as above.
  • The surname contains information about its type (e.g. "eine geborene", "f.", "Född"). The first, rare situation is corrected as above. There are usually dozens of the latter cases. The correction is made with the "Name Editor" tool at once, replacing the text "F." Or "Född" with the last names. Note that the text to be replaced includes a space and that the text is replaced by leaving the new value blank.

Family Auto Merge Tool

The Family Auto Merge Tool is intended for cleaning the parish's Hiskipuut stock. The tool merges the children of the parents into one family and adds a Marriage event to the family. Only parents whose names are in exactly the same form in the marriage and baptismal events of Hezekiah are directly interpreted as the same family. The tool records how many connected families it formed. The efficiency of the tool can be improved by using the Name Merge Tool and Name Editing tools mentioned above.

The next step is the researcher's own judgment. Family reunion continues in Gramps Families view. It is first sorted by the name of the husband, after which it is easy to identify the families left behind by the tool due to small differences in the name of the wife joining. Merging families in a view is done two at a time with Gramps' "Merge" tool or "Multimerge" tool for merging multiple families at once.

Once the men have been dealt with, the Families list is further sorted by wife's name, allowing families with small differences in husband's names to be combined accordingly.

In the Gramps interface, you should add the "Kids" tab to the Bottom bar and the "Events" tab to the Sidebar. They can be used to check that there are no visible flaws in the reunited family, e.g., the children have too long a time interval or the marriage event does not fit the children’s time. These are signs that unrelated families or children have been merged into the same family.


Fig. Isotammi.20 SuperTool

From SuperTool/ on GitHub

This is a general purpose scripting tool that can be used to do "ad-hoc" queries against a Gramps family tree/database. The queries are expressed in the Python programming language so the tool is most useful for programmers. But the intent is also that the tool is easy enough to allow regular Gramps users to make use of it.

The queries can be saved as script files that any user may then load into the tool — without necessarily understanding the details. The queries can also be saved as Generic rule-based Custom Filters that may be used throughout Gramps.

Table of contents

From the SuperTool user docs on GitHub

Direct Access to Gramps Functions

Initially, the higher order functions of certain Python Standard Library modules (os, sys, re, functools, collections) are available in SuperTool by default. And the Gramps Primary Object matching the currently active view (Person, Family etc) are implicitly defined when the tool is started. Secondary objects (like EventType, PlaceName) are not defined and the script has to explicitly import them (in the "Initialization Statements" section) if they are needed.

This tool works in the Gramps versions 5.x and later. It will be installed in the "Isotammi tools" submenu under the Tools menu.

The tool allows arbitrary Python code so it can also be used to modify the database.

For instructions on how to use this tool please visit the SuperTool - Instructions on Github.

Generic Rules for Supertool
Fig. Isotammi.21 Isotammi Generic Rule

SuperTool simplifies designing a new database query and provides an option to immediately apply that query design to the Tree. However, to use that query design as a limit elsewhere (in a View, with a Tool, on a Report, or when Exporting a portion of your Tree) in Gramps, the query 'initialization' and 'statements' specifications must be inserted into a Generic Rule. And then that Titled (named) Rule can be used in Custom Filters.

  • Generic person filter
  • Generic family filter
  • Generic event filter
  • Generic place filter
  • Generic source filter
  • Generic citation filter
  • Generic repository filter
  • Generic media filter
  • Generic note filter
SuperTool Scripts

If you create library folder with a series of Scripts, it is helpful to add a Bookmark for that folder to the GTK File Chooser. This simplifies navigating to your script library folder.

Discourse support forum threads (supertool-script and isotammi category searches)

The SuperTool scripts of Patrice Legoux (source and note in French. Coming soon!) Recommended reference documents for SuperTool

See also:

FilterParams tool

Fig. Isotammi.22 Isotammi FilterParams dialog

The FilterParams dialog flattens the number of steps needed to adjust parameters in a custom filter.

Currently in beta.

Example illustrates the following 3 stage custom filter:

<?xml version="1.0" encoding="utf-8"?>
  <object type="Person">
    <filter name="Some Event in place x" function="and" comment="People filter : who has the events">
      <rule class="MatchesEventFilter" use_regex="False">
        <arg value="Event in place x"/>
  <object type="Event">
    <filter name="Event in place x" function="and" comment="Event filter : occurred in a place">
      <rule class="MatchesPlaceFilter" use_regex="False">
        <arg value="In place X"/>
  <object type="Place">
    <filter name="In place X" function="and" comment="Place filter : enclosed by a place">
      <rule class="IsEnclosedBy" use_regex="False">
        <arg value="P0003"/>
        <arg value="1"/>


This article's content is incomplete or a placeholder stub.
Please update or expand this section.


Fig. Isotammi.23 Isotammi ZIPInstall

Tool to install an addon from a ZIP or a .tgz compressed download file.

This is very efficient when downloading GitHub code ZIP files. The ZIPInstall GtkFileChooser dialog has a button to change to the "Downloads" folder. Sort on date and your recent download is on the first line. The install option automatically checks the Gramps Registry and puts the updated code in the correct plugin subfolder.

The ZIPinstall will confirm that you want to overwrite and offer the option to backup the existing addon.

Isotammi ZipInstall GitHub folder.

Import CSV sources

The "Import CSV sources" Tool is a specialized tool that can load Gramps sources from a csv (comma separated values) file. For each line of the file, the tool generates an Archive (optional, source, Additional source-related Information (optional) and Property (optional) for Gramps.

The tool is installed in the Gramps Tools> Isotammi tools folder.

The tool is fed with a .csv file that reads the information under the following column headings: - title (pakollinen) - author - abbrev - pubinfo - repository - ....

Heading titles should be written exactly like that, in lower case. The order of the columns does not matter and not every one needs to be included. Other columns are ignored.

Each line creates a new source and is given a sequential ID numbering: S0001, S0002, etc. Therefore, any gramps-id information in the file is not used. If there are already sources and archives in the database, duplicate ID values ​​may become available (but they can be renumbered later with Tools -> Family Tree Processing -> "Rearrange Gramps IDs" to Select Source and Archive Items)

The contents of the columns title, author, abbrev, and pubinfo are stored as is in the source.

The Repository column has special handling:

- The repository can be empty, so the source is not attached to any archive.

- If the column contains an id in square brackets (format [Rxxxx]), then the source is appended to the corresponding archive if it is already in the database. If. archive does not exist, a new archive named "[Rxxxx]" is created and the source is attached to it.

- If there is another value in the column, it is interpreted as an archive name, creating a new archive with that name and appending the source to it. However, if the same name is used multiple times, the tool only creates one archive. If the name is already in a position in an existing archive, the tool cannot associate the new name with it (this can be corrected later by merging the archives in question).

Convert NARC URLs

Convert the obsolete URLs of the Finnish National Archive's digital resources found in the Gramps database into Astia addresses.

Example: Typically converts

Uses the conversion service of the National Archives, which unfortunately does not work for all addresses.

Affects the addresses in Notes and on the people's Internet tab.

Make a backup first. Start from the Tools -> Isotammi submenu. The conversion starts immediately, it can be interrupted with the Cancel button. The changes made can be canceled with the Edit -> Undo function or the Family Trees -> Abandon Changes and Quit.



This article's content is incomplete or a placeholder stub.
Please update or expand this section.

Events with an invalid/valid date

Fig. Isotammi.24 Events with Invalid Date Rule

Events with an invalid date/Events with a valid date are rules that can be used to search for events with incorrect dates. These are not exactly opposites of each other, as the event may also lack date information, in which case it does not match either rule.

Generic <Object> filter

Fig. Isotammi.25 Isotammi Generic Rule

Generic Rules allow a Query to be directly saved as a reusable custom Rule. These Generic Rules were created as an accessory to the SuperTool query builder, editor, and executing shell. Queries in the SuperTool have a compatible syntax and segmentation with fields of the Generic Rule.

If you prefer to design queries manually, a simple free-form text editor and query execution shell in the Query Gramplet add-on. However, for use in a Generic Rule the query must be composed in the exact syntax expected. There is no validation nor safety nets in the Generic Filter Rules. For this reason, it is recommended that syntax be tested in SuperTool. Then the Custom Filter be 'Test run' with the FilterParams add-on tool... which is the only custom filter tool with a capability to abort a query in progress.

  • Generic person filter
  • Generic family filter
  • Generic event filter
  • Generic place filter
  • Generic source filter
  • Generic citation filter
  • Generic repository filter
  • Generic media filter
  • Generic note filter



This article's content is incomplete or a placeholder stub.
Please update or expand this section.

Isotammi XML export

Fig. Isotammi.26 Isotammi XML export - Export options dialog.(Options Highlighted)

Exporter for Isotammi XML export expands the options available compared to the builtin Gramps XML (family tree) export(er).

Choose Menu Family Trees ->Export... then select Next and select Isotammi XML export then select Next and choose the file format specific export options you want to use and then select Next to choose your filename and location and output the file.

File format specific export options

Listed underneath the "Filters and privacy" section you have the following file format specific export options:

  • Use Compression
  • Include media
  • Description: adds a user description to the output file.
  • Material type - describes the internal annotation in the header of the export file. Used by the Isotammi project's automated processing tools to correctly route the data into their master database.
    • Family tree
    • Place Data
    • Hiski Tree - HisKi project includes lists of christenings, marriages, burials and moves for most Finland parishes - HisKi is a portmanteau of the finnish term "historiakirjat" (in english, "historical parish books"). HisKi Trees are isolated branches related to a single citation processed by members of the Genealogical Society of Finland. (In their project, if a parish book has separate citation worthy entries for a christening, marriage and funeral; then there might be 3 duplicate Persons and duplicates for each unique associated person in the citation. Merging is processed as a separate operation from data entry.)

This article's content is incomplete or a placeholder stub.
Please update or expand this section.

Using any of these options adds the following unsupported section entries to Gramps XML output:

      <material_type>Family Tree</material_type>
This is my family tree test with Isotammi addons

See also

Webpage originally duplicated from Isotammi and translated to English and expanded.

Collected 11 May 2021