Discussions started by Introduction to SuperTool scripts

Two tests but difficulties too: https://www.geneanet.org/forum/viewtopic.php?p=2006822#p2006822 [fr]

1 Like

SuperTool and SuperFilter too !

1 Like

Creation and sharing of a new attributes filter for sources or citations, filtering is based on attributes name or value.

Very easy (to create and to share) with ST.

Note/Idea: It would be cool to be able to use a path (defined in preferences?) for includes, something like media path (relative to the preferences path).

1 Like

Note/Idea: It would be cool to be able to use a path (defined in preferences?) for includes, something like media path (relative to the preferences path).

There is now a new version at https://github.com/Taapeli/isotammi-addons/tree/master/source/SuperTool which has this feature.

Thanks for the suggestion.



Hi Kari.

I had misplaced the Deep Connections Graph Gramplet before ever trying it. (I rarely add anything to the Dashboard) It requires looking at the .gpr.py file to discover that it was a “Dashboard only” gramplet. So I’ve finally had a chance to try it.

It was interesting. It did NOT like my big Tree – it kept saying that trying again might help. But, after a few attempts, the Gramplet worked with the PseudonymTree.gramps file. But that is a simple tree for testing Graphs. It is without any pedigree collapse… so it does not exercise the tools very well.


There were 4 items that didn’t have English translations

the “Uudelleenyritys voi auttaa” (“Trying again can help”?) error message and the “child/sibling/parent” labels. Could you make those translatable?

Those “child/sibling/parent” labels overwrite the vertical line connecting the boxes. Perhaps you could move them to the right about 15 pixels? (Or you could just add a non-breaking space to the front of each string.)

And would you consider feeding the current “Home Person” to the Person1 selection and the “Active Person” to Person2 when the browser is started? I would happily close and re-launch the browser each time to avoid the Person selection dialogs on my 40,000 person tree!

I posted a feature request to make the Add-On list server location more friendly to 3rd parties. It looks like the idea will meet a lot of resistance. added in Gramps v5.2


1 Like

Thanks. Again good suggestions - I hope I am able to make the changes. It might be difficult to move the labels since IIRC the complete image is generated by Graphviz. The gramplet needs other improvements also… Maybe I will also move it to the Tools menu


I thought that moving the labels might be a pain. Perhaps padding those strings with a non-breaking space at the left (& on the right, to support Right-to-Left localization) would do the same thing with little effort?

19 Nov 2021 @kku announced an update fixing an issue with incrementing variables in the Isotammi SuperTool version 1.1.5

Since the Isotammi updates are NOT included in the standard Gramps Add-on Manager updates check, people may want to install the Isotammi Configuration add-on. Or, manually switch the Preferences between checking the standard Gramps add-on list:


and the Isotammi add-ons list:


Remember to switch back afterwards!
Note that the experimental FilterParams add-on hasn’t been migrated to the Isotammi add-on list yet. You don’t want to miss out on this one!

1 Like

This looks interesting. I’ll try making precise the things I want to do with my GRAMPS, first with some pseudocode for my own benefit.

Then to get real, where do I find a dictionary of all the objects which will be known to the Supertool? Like db, children, and the methods and attributes of these and anything I might pass to a function I define?

I realise this is part of learning GRAMPS coding basics, but I’m not there yet!

The Help built into SuperTool has that dictionary… well, actually it is more of a vocabulary list than a dictionary.

I like to use the add-on Filter gramplets, Custom Filter Rules and the Built-in rules as sample code for the different object categories. They cover the key areas.

1 Like

I’m not there yet either.

Note: try
in the “Expression to display:”

It was unclear that when you launch SuperTool with a specific Category View active, that has implicit Initialization for the primary object of that category.

1 Like

OK - I got your sample Supertool script to work, and I can see how to write a script to do some of the things I want. As I see things currently, I will set up a series of citations manually, e.g. one for each census, one for parish burials, ++, use the import text tool to bring in people mentioned, who I will want to have that citation, and then ‘correct’ all the spurious new citations created with the import text tool. I’ll want to set up residence events for census imports, as well as the (highly approximate) birth years as birth events.

1 Like

Stuck here, trying I guess the simplest possible use of the Supertool, changing the type of as yet just selected events from Residence to Census. By poking around in the code for ImportText I worked out how to import residence events, but strictly these should be Census events, to which value I changed two manually.

What is it with ‘EventProxy’ and ‘_Event__type’?

That sample code had this line


but I can’t get something like this for events to work.

The simplest syntax would be

type = EventType.CENSUS

which I tried first. It doesn’t generate an error … but doesn’t do anything either.

Try that:


And in initialization statements you could just use:

from gramps.gen.lib import EventType

(and check Commit changes)

1 Like

Thanks. This worked. I’ll work now of setting up more tables of data to bulk import / tidy up with applications of the Supertool. In the meantime, can you send me notes or overview of what code to use with Supertool? I understand you. @PLegoux are French - I should be able to read French text. I’d like to produce a few pages on this in English. Maybe I could try Google translate with something in Finnish from @kku ? I also have a nephew who is married to Finn - she might help me too!

I’ve produced that if they can be utile to you.

Generally I start by publishing what I’ve found/tried there:

Integrate it in my library (Ive began to translate comments in English but not all are done):

And sometimes write a what’s new post:

(I don’t know why Discourse published Notion ads instead of my post header but it is it - I don’t have that issue on other social networks)

And a lot of tweets:

Some of them are resumed or completed in these articles:

(Same issue again)

The README in English, from @kku here

isotammi-addons/README.md at master · Taapeli/isotammi-addons · GitHub

seems pretty good to me - certainly for me to work from for a while. I’ll keep on with the ImportText tool for initial bulk uploads, and using SuperTool for refinements, corrections of what I can’d do with Import Text

I’d offer to write up what I do as example of using these tools, although I’m likely to see better ways as I go, do organising it clearly will not be easy. Maybe when I’ve finished would be better

1 Like

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.