tracvatar / README.rst

Full commit


Adds Gravatar icons to Trac.

Credit goes to the HackergotchiPlugin for some general ideas.

Currently, only Gravatar is supported, but the more open-ended plugin system of Hackergotchi can be re-implemented here if other avatar engines are desired.

Ideally, Trac itself would just include support for author avatars as a built in, since this is an extremely common and desirable feature.

For now, the approach of the plugin is to filter specific Trac views, gather all the authors found in the "data" hash being passed to Genshi, then using Genshi filters to insert additional Gravatar nodes.

Currently supported views are:

  • Timeline
  • Issue display
  • Issue change display (i.e. comments, attachments)
  • Source browser listing (tested for svn and hg so far)
  • Individual changeset page (tested for svn and hg so far)
  • User prefs page (includes link to "change your avatar" at


To install, just use python bdist_egg to create an egg file which then goes into the Trac plugins/ folder, or just python install to plug it in entirely.


To enable the plugin in trac.ini:

tracvatar.* = enabled

There are then available optional "size" settings for each view, shown below are defaults:

ticket_reporter_size = 60
ticket_comment_size = = 40
timeline_size = 30
browser_lineitem_size = 20
browser_changeset_size = 40
prefs_form_size = 40
gravatar_default = default