Sisimai | Library to parse bounce mails | Sisimai: Mail Analyzing Interface

What is Sisimai ?

Sisimai is the successor of bounceHammer, is a Mail Analyzing Interface: a Perl module and a Ruby Gem for parsing RFC5322 bounce emails and for generating structured data such as JSON.

Sisimai v4.25.16 was released on Tuesday, 16 May, 2023. This release fixed 2 bugs in each of the Perl and Ruby versions. v4.25.16 may be the final release of the version 4 series. However, if a serious bug is found after today, we will release v4.25.17. Sisimai 5 and the Go language version of Sisimai are under development on the sisimai/go-sisimai repository repository and will be released by next summer. For further information about all the changes on this version available at blog.libsisimai.org.

Parse Bounce Emails

Sisimai is a library to parse bounce emails in a UNIX mbox file or emails in the Maildir/ directory.

Get Started

Detect Bounce Reasons

Sisimai can detect 29 bounce reasons such as "blocked", "mailboxfull", "userunknown", and so on.

Details

Data Structure

Parsed results generated by Sisimai are converted to structured data, and could be converted to JSON.

Details

68 Parser Engines

Sisimai can parse bounce mails from open source MTAs, commercial MTAs, and some major MSPs/ESPs.

Details

vs. bounceHammer

On August 2014, We have started to develop a Perl version of Sisimai to resolve many fundamental problems of bounceHammer which are related to analytical precision (it could not be detected 2 or more bounces in a single email), many dependencies of external modules (some modules have not maintained for a long time), and cannot work on Perl 5.16 or later.

As of the present, the Perl version Sisimai is about 2.2 times faster than bounceHammer, have 2.0 times higher of analytical precision, depends only 2 external modules, and can work on Perl 5.10.1 or later versions of Perl. From August 2015, We have started to develop a Ruby version of Sisimai. The software has been released on Feburary 3, 2016.

Analytical Precision Ratio

100%

59%

The Speed Of Parsing 1000 Emails

1.3s

4.24s

Detectable Bounce Reasons

The Number Of MTA/MSP Modules

Dependent External Modules

Can Detect

29

Bounce Reasons

Have

68

Engine Modules

Including

14

Commercial MTA Modules

Only

2

External Modules Required

Download

The latest version is v4.25.16, released on Tuesday, 16 May, 2023.

Sisimai can run on the system that Perl or Ruby is available like the following lists, such as *BSD, Mac OS X, and Linux. Beginning of v4.22.5, Sisimai may run with ActivePerl on Windows. .

Perl Version

Stable version
Perl 5.10.1 - 5.34.X
CPAN

Download

Ruby Version

Stable version
Ruby 2.1.0 - 2.7.X
JRuby 9.0.4.0 - 9.1.17.0

Download

Fork on GitHub

Development Version
p5-sisimai (Perl)
rb-sisimai (Ruby)

Fork

Support

Anyone can use Sisimai because it is an Open Source Software, however, we, Cubicroot Corporation Limited (a development company of Sisimai) is ready to support your installation of Sisimai, development of relevant scripts, data management of parsed bounces on RDBMS, operations on your system for continuous management of email bounces, and a migration from bounceHammer.