Skip to content

Repository files navigation

ThunderStats icon ThunderStats 3

This addon adds awesome statistics to your beloved Thunderbird!

Do you remember the good old Eudora statistics? Do you miss them? With ThunderStats you can finally keep an eye on how you use your email.


What's new in 3.0

  • Much faster statistics, thanks to caching and optimized folder scanning.
  • Brand new look, with a light/dark theme you can switch on the fly.
  • New Today/Yesterday dashboard: compare with your usual weekday and get inbox insights.
  • New Many Days dashboard: day-by-day chart, averages, Inbox Zero calendar, activity heatmap, weekday chart and comparison with the previous period.
  • New "How old is your inbox" card and folder details in "Where mails ended up".
  • Redesigned Custom View, with quick date ranges and filter chips.
  • Redesigned Options page, with automatic saving.

ThunderStats 3.0 requires Thunderbird 140 or later.
If you are using Thunderbird 115 or 128, you can still use ThunderStats 2.4.

See the full list of changes in the changelog.


Features

  • Today and Yesterday
    • Sent and received mails, with a time of the day chart
    • Comparison with the usual weekday or with any other day
    • Top senders and recipients
    • Inbox Zero status and inbox insights
  • Many Days and Custom date ranges
    • Daily, weekly, monthly and yearly sent and received mails charts
    • Time of the day and weekdays aggregation
    • Activity heatmap and Inbox Zero calendar
    • Total, max, min and average sent and received mails over the period
    • Comparison between two periods
    • Advanced filtering (folders, read/unread, starred, subject keyword)
  • Folders, tags and domains statistics
  • Business days: get statistics (total, max, min, average) ignoring non-business days
  • Internal domains: see the percentage of internal and external mails
  • Custom identities, with wildcard support
  • Export data in CSV format

Privacy

All data processing is performed locally on your device. No data is transmitted, shared, or stored on any external servers or third-party services. This ensures that your information remains private and secure at all times.


Issues & Questions

Post any issues or questions for ThunderStats under Issues.


Changelog

ThunderStats's changes are logged here.


Build Instructions

Ensure you have installed Node.js and npm.

Then, in the root folder of the project run:

npm install

Production build (with minification)

npm run build

You'll find the compiled addon in the dist folder and the final .xpi package in the parent folder of the project root.

Development build (without minification, auto-rebuild on changes)

npm run dev

The process watches for file changes and automatically recompiles the addon into the dist folder.


Tests

npm test

Runs the unit, integration and component tests (Vitest), on a mocked Thunderbird API.

npm run test:real

Runs the statistics engine on real mailbox dumps placed in tests/real/data/. See tools/mailbox-dump/README.md to create a dump.

Store screenshots

The screenshots for the addons.thunderbird.net page are captured automatically: the real add-on pages run in a normal browser on top of the mocked Thunderbird API, filled with a fictional mailbox (two accounts, about 14 months of mail, only reserved domains that cannot exist).

  1. Start the preview server and leave it running:

    npm run screenshots:serve

  2. In another terminal, capture the screenshots with headless Microsoft Edge:

    npm run screenshots

The 1280×800 PNG files are written to tools/screenshots/out/: Today in light and dark theme, Last 7 days and Custom View in light theme (each one at the top of the page and then scrolled down: one more screen for Today, two more for Last 7 days and Custom View), and every Options section. To use another Chromium browser, pass its path: npm run screenshots -- "C:/path/to/chrome.exe". More details in tools/screenshots/README.md.


Credits

Original Author: Mic

Contributing Author for version 1.*: Christopher Leidigh


Support this addon!

Are you using this addon in your Thunderbird?
Consider supporting the development with a small donation. Click here!


Attributions

Translations

  • Dutch (nl): Fjoerfoks
  • Italian (it): Mic
  • French (fr): Generated automatically, Goofy and Vittorio
  • German (de): Generated automatically, Axel Grude

Would you like to help translate ThunderStats? Find out how!

Thanks to Hosted Weblate for managing the localization.


Javascript Libraries

See the package.json file.


Graphics

Addon icon thanks to http://hopstarter.deviantart.com/

Custom Query Bookmark icon thanks to http://www.iconarchive.com/artist/graphicrating.html

Loading SVGs thanks to https://loading.io

Releases

Used by

Contributors

Languages