Adds user picture icons (avatars) to Trac

Notice: there are plans to integrate the functionality of this plugin into AccountManagerPlugin.


This plugin allows a user to add a user picture icons (avatars) to his/her profile on Trac. The user picture then shows up next to the user name in for example tickets, query results and the file browser. Screenshots of the plugin in action can be found at

User manager example

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 avatar nodes with the proper img tags.

Currently supported views are:

  • Timeline
  • Ticket details: reporter, owner, comments, comment diffs
  • Attachment views (on tickets, wiki pages, etc)
  • Source control views, such as directory listings, file contents, changesets
  • Report and custom query views
  • Wiki history, diffs and individual versions
  • Search results

Credit goes to Michael Bayer for the idea and most of the code.

See also: UserManagerPlugin, TracvatarPlugin

Bugs/Feature Requests

Existing bugs and feature requests for UserPicturesPlugin are here.

If you have any issues, create a new ticket.


2 / 2


1 / 1


Download the zipped source from here.


Mirrors are available on Github and PyPi:


  1. General instructions on installing Trac plugins can be found on the TracPlugins page.
  2. Enable the component in your trac.ini file:
    userpictures.* = enabled
  3. Choose your preferred avatar engine. For Gravatar:
    pictures_provider = UserPicturesGravatarProvider

For integration of avatars with the UserManagerPlugin, ensure that the UserManagerPlugin is installed and enabled, and then:

pictures_provider = UserPicturesUserManagerProvider

If you do not explicitly select either engine, a default provider is used which displays a blank silhouette for every user.


Author: ejucovy
Maintainer: ejucovy

Last modified 15 months ago Last modified on Feb 25, 2023, 9:54:20 AM

Attachments (1)

Download all attachments as: .zip