Add-on for Thunderbird that automatically populates contact photos with their Libravatar or Gravatar photo. https://addons.thunderbird.net/en-US/thunderbird/addon/auto-avatars/
  • JavaScript 88.6%
  • HTML 9.3%
  • CSS 2.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Seth Falco 0c78032374
All checks were successful
ci/woodpecker/pr/ci Pipeline was successful
ci/woodpecker/push/ci Pipeline was successful
chore: migrate from Codeberg to self-hosted Forgejo
2026-11-12 19:33:33 +00:00
.woodpecker chore(ci): run ci pipeline on push to main too 2026-08-31 00:49:34 +01:00
assets chore: update metadata and logo 2025-04-22 10:30:11 +01:00
docs feat: add european dns servers 2026-01-04 23:16:31 +00:00
src chore: migrate from Codeberg to self-hosted Forgejo 2026-11-12 19:33:33 +00:00
test/lib chore: add sethfalco/eslint-config and apply fixes 2026-03-07 16:18:50 +00:00
.editorconfig feat: initial commit 2024-01-31 20:52:04 +00:00
.gitignore chore: migrate build process to gulp 2025-09-28 23:22:25 +01:00
.yarnrc.yml chore: yarn set npm minimum age 2026-03-07 23:32:03 +00:00
CONTRIBUTING.md chore: migrate from Codeberg to self-hosted Forgejo 2026-11-12 19:33:33 +00:00
eslint.config.mjs chore: add sethfalco/eslint-config and apply fixes 2026-03-07 16:18:50 +00:00
gulpfile.js chore: include vendor.md file in build 2026-03-07 17:07:12 +00:00
LICENSE chore: include vendor.md file in build 2026-03-07 17:07:12 +00:00
package.json chore: migrate from Codeberg to self-hosted Forgejo 2026-11-12 19:33:33 +00:00
README.md docs(badges): delete pipeline badge 2026-09-28 23:10:30 +02:00
tsconfig.json chore: migrate build process to gulp 2025-09-28 23:22:25 +01:00
yarn.lock chore: include vendor.md file in build 2026-03-07 17:07:12 +00:00

Auto Avatars

About

Add-on for Thunderbird that automatically populates contact photos with their Libravatar or Gravatar photo.

You can install it from the Thunderbird Add-ons repository. After installation, you must either set a preferred Libravatar instance, or confirm that you're happy with the recommended instance in the add-on preferences before the add-on will fetch avatars.

Usage

  1. Navigate to the Address Book.
  2. Either update or create a new contact.
  3. If the contact does not explicitly have an avatar, the add-on will automatically set one on save.

Auto Avatars will also fetch avatars for Collected Addresses, which are the contacts that are created when you send emails to addresses not already in one of your personal address books.

Demo

Demonstration of the add-on in action. I create a new contact in an empty address book with the email address seth@falco.fun, and then press Save. After saving, Thunderbird updates the contact that was just created to feature the avatar from Libravatar.

Fetching Avatars

As Libravatar is federated, Auto Avatars can check multiple locations for an avatar. Attempts will only be made to fetch avatars from secure sources (HTTPS).

We fetch avatars in the following order:

  1. The contacts preferred Libravatar instance if federation is enabled. (Disabled by default!)
  2. Your preferred Libravatar server, it's recommended to use the hosted Libravatar instance at libravatar.org.
  3. Fallback to Gravatar, the request is proxied through the hosted Libravatar instance.

To learn more about and enable federation support, see the add-on preferences documentation.

Why Libravatar

If you've found this extension while looking for an add-on for Gravatar, this will do what you're looking for. However, you might be wondering what Libravatar is, and why we favor it when it's available.

Libravatar is an avatar service similar to Gravatar, except it is community backed, Open Source, and federated. Libravatar has a similar user interface and API to Gravatar, while avoiding the problems that stem from centralization.