Addon:Handle.bash

From Gramps
Revision as of 04:15, 25 September 2025 by Gioto (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Gramps-notes.png
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager.

Please use carefully on data that is backed up, and help make it better by reporting any 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.

The script handle.bash (downloadable here) can be used to replace all database handles in a .gramps file. This makes it possible to work with multiple databases in Gramps, merging select branches manually at will. Without this tool, manual merging of databases derived from one another, or with a common base-database, would not be possible because of handle collision.

Usage

Linux

In order to use this script, you must:

  • create a directory and copy the handle.bash script file to it.
  • In Gramps export the database you wish to import into a colliding database to a .gramps file
    • Copy that .gramps file inside this directory.
  • Then you run
$ bash handle.bash filename.gramps

where filename.gramps is the name of the file you exported into the new directory.

The script will create the files:

  • file.gramps.zcat
  • handle.old
  • handle.new
  • file.gramps

The file file.gramps is the final output, of the original filename.gramps with all handles replaced.

This script is released under the GNU GPLv2, author: lcc.