Tree [91c379] api /

File Date Author Commit
data 2013-10-20 Vassilii Khachaturov Vassilii Khachaturov [ba541e] 7125/7102: port my fix from gramps34
debian 2013-12-15 Jérôme Rapinat Jérôme Rapinat [bbcefa] 7286: gir1.2-webkit-3.0 and others gir1.2-depen...
docs 2013-09-13 Jérôme Rapinat Jérôme Rapinat [05b491] 6028: gen module should be gramps.gen
example 2013-06-03 Paul Franklin Paul Franklin [d6b74d] add some more names to data.gramps (more modern...
gramps 2014-01-03 Nick Hall Nick Hall [91c379] Add database to contructor of gen.lib objects
help 2008-01-15 Benny Malengier Benny Malengier [0eed33] In .:
images 2013-06-23 John Ralls John Ralls [4e4c11] [r22576]Move the HTML resources from gramps/plu...
mac 2013-11-14 John Ralls John Ralls [4f0754] Bug 7191: Cursor keys just beep on PPC with Gra...
po 2013-12-14 Vassilii Khachaturov Vassilii Khachaturov [de4517] 6921: Use "Bat Mitzvah" as the en_US event name
scripts 2013-02-25 Jérôme Rapinat Jérôme Rapinat [158a5f] 6283: Re-enable optimization flag (-O) for python
test 2013-08-29 Vassilii Khachaturov Vassilii Khachaturov [0afdb2] 7016: new cmdline switches -y/--yes and -q/--quiet
windows 2012-06-17 Benny Malengier Benny Malengier [faed8a] Start convertion to introspection. Flat models ...
.gitignore 2013-12-21 Vassilii Khachaturov Vassilii Khachaturov [62207a] ignore test/data
AUTHORS 2012-06-05 John Ralls John Ralls [2fe3ab] Add myself (jralls) to AUTHORS per request from...
COPYING 2013-11-06 Jérôme Rapinat Jérôme Rapinat [959162] 6918:
FAQ 2008-01-14 Jérôme Rapinat Jérôme Rapinat [bbffa9] 2013-03-11 John Ralls John Ralls [3a7383] [r21613]Determine Paths at Runtime
INSTALL 2013-03-09 Paul Franklin Paul Franklin [aa21c6] slight tweaks to text, add text property
LICENSE 2013-11-06 Jérôme Rapinat Jérôme Rapinat [959162] 6918: 2013-04-06 Jérôme Rapinat Jérôme Rapinat [a182a6] need into source tarball
NEWS 2013-11-08 Jérôme Rapinat Jérôme Rapinat [9f0f9b] update NEWS
README 2013-04-06 Paul Franklin Paul Franklin [1e5ae4] clarify and qualify release information
RELEASE_NOTES 2013-05-21 Jérôme Rapinat Jérôme Rapinat [1b58e7] road to 4.0.0
TODO 2012-10-27 Jérôme Rapinat Jérôme Rapinat [d6faa8] replace with a link to GEPS page
TestPlan.txt 2004-10-10 Eero Tamminen Eero Tamminen [e1d90f] add test for reports 2013-10-07 Jérôme Rapinat Jérôme Rapinat [dfde3b] 7110: Add AppData file

Read Me


Please read the COPYING file first.

If building from source, also read the INSTALL file (at least through the
"SUPER-SHORT VERSION") before going further.

The following packages *MUST* be installed in order for Gramps to work:
   Python 2.7 or greater, Python 3.2 or greater (or both python versions)
   GTK 3.0 or greater
   pygobject 3.3.2 or greater
   cairo, pango, pangocairo with introspection bindings (the gi packages)
   librsvg2 (svg icon view)
   bsddb3 is required for Python 3.2 (not python 2.7)

The following package is needed for full translation of the interface
to your language:
                    Translation of GTK elements to your language, with
                    xx your language code; e.g. for Dutch you need
                    language-pack-gnome-nl. The translation of the
                    Gramps strings is included with the gramps source.

The following packages are *STRONGLY RECOMMENDED* to be installed:

   osmgpsmap        Used to show maps in the geography view. 
                    It may be osmgpsmap, osm-gps-map, or python-osmgpsmap,
                    but the Python bindings for this must also be present.
                    Without this the GeoView will not be active, see
                    !! PACKAGERS: unfortunately, at the moment (March 2013),
                    the patches which gramps 4.0 needs osm-gps-map to have
                    are not yet released (as a new osm-gps-map version). The
                    osm-gps-map sources must be dated 6 February 2013 (or
                    later) to have the necessary patches.  You may obtain
                    it from: or else
                    (The necessary version seems to be 0.8 -- or later.)

   GraphViz         Enable creation of graphs using GraphViz engine.
                    Without this, three reports cannot be run.
                    Obtain it from:

   PyICU            Improves localised sorting in Gramps. In particular, this
                    applies to sorting in the various views and in the
                    Narrative Web output. It is particularly helpful for
                    non-Latin characters, for non-English locales and on MS
                    Windows and Mac OS X platforms. If it is not available,
                    sorting is done through built-in libraries. PyICU is
                    fairly widely available through the package managers of
                    distributions. See
                    (These are Python bindings for the ICU package.)

The following packages are optional

   gtkspell         Enable spell checking in the notes. Gtkspell depends on 
                    enchant. A version of gtkspell with gobject introspection
                    is needed, so minimally version 3.0.0

   rcs              The GNU Revision Control System (RCS) can be used to manage
                    multiple revisions of your family trees. See info at
                    Only rcs is needed, NO python bindings are required

   PIL              Python Image Library is needed to crop
                    images and also to convert non-JPG images to
                    JPG so as to include them in LaTeX output.
                    (For Python3 a different source may be needed.)

   GExiv2           Enables Gramps to manage Exif metadata embedded in your
                    media. Gramps needs version 0.5 or greater.

   ttf-freefont     More font support in the reports

   gir-webkit       GObject introspection data of WebKit is required for the
                    hidden view 'Htmlview', which allows websites to be
                    opened in Gramps. Users can unhide the view in the
                    plugin manager.  A html renderer must be installed to
                    use the view.
                    !! PACKAGERS, Test if on your distribution
                    webkit and Gramps is stable. If you obtain crashes, patch 
                    src/plugins/view/ and
                    src/plugins/view/, so as to remove:
                       from gi.repository import WebKit as webkit

                    Required for the (user-downloadable) Graphview plugin

No longer needed in 4.0:
   pygoocanvas, pygtk, pyexiv2
No longer needed in 3.3:
   python-enchant Enchant
No longer needed in 3.2:
   python glade bindings
No longer needed in 3.1:
   yelp             Gnome help browser. At the moment no help is shipped

The User Manual is now maintained on the gramps website,

The Gramps Project