Skip to content
Branch: master
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time


Roundup (in allusion to a broadband herbicide) is an IMAP-based mail filter, washer and (re)organizer that works in the background, e.g. as a cron job. This tool uses IMAP to move rule based mails in a mailbox. The rules for this are a combination of regular and logical expressions.


  • Multiple account support
  • IMAP support (incl. SSL)
  • simple URL based IMAP and mailbox definition
  • Internal dynamic whitelist
    Exclusion of mails from subsequent filters and rules.
  • Filter based on patterns with regular expression
    The patterns can then be combined in logical expressions.
    Supported: AND, OR, NOT, round brackets
  • Processes the header and body of the messages
    Message content, including multi-part, is decoded and simplified for the filters. The decoding only happens in memory.
  • Message attributes such as 'seen / unseen' are retained
  • Continuation of filtering from the last analyzed mail (for each mailbox separately); complete reanalysis when changing application, configuration or filter
  • Logging with detailed error messages
  • Physical separation of application, configuration (with accounts) and filter

Licence Agreement

Seanox Software Solutions ist ein Open-Source-Projekt, im Folgenden Seanox Software Solutions oder kurz Seanox genannt.

Diese Software unterliegt der Version 2 der GNU General Public License.

Copyright (C) 2019 Seanox Software Solutions

This program is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

System Requirement

  • PHP 7.x or higher + imap extension


Seanox Roundup 1.1.0
Seanox Roundup 1.1.0 Sources


The script must be stored on a server and is called by a cron job.

/bin/php -f roundup.php

Alternatively, the script can also be used via CGI.
In this case, please prohibit access to the configuration (ini) and filter file.


The application consists of three files (roundup.php, roundup.ini, roundup.filter). At runtime, the session file is created later. The files can be renamed. Basis is the file name of the application (roundup.php). All other file names must be based on it.
The program fileroundup.php itself does not need to be configured.

Configuration (roundup.ini)

There are two sections: COMMON and ACCOUNT.
Please open roundup.ini and read the notices and see the examples.

Filter (roundup.filter)

The filters are defined here.
Please open roundup.filter and read the instructions and see the examples.

Changes (Change Log)

1.1.0 20190731 (summary of the current version)

BF: Session: Correction in resuming a session
BF: Correction in the use of preg_quote
CR: Output: KEEP for mails found by NOTHING has been removed
CR: Filter: Enhancement of the syntax to continue lines with '...'
CR: Configuration: Update to use anonymous examples
CR: Decoder Multipart: Change alias for non-text content
CR: Project: Uniform use of ./LICENSE and ./CHANGES
CR: Project: Automatic update of the version in
CR: Build: Harmonization when updating the version
CR: Filter: Headers can now be filtered in raw format and decoded

Read more




Sven Lorenz
Andreas Mitterhofer
novaObjects GmbH
Leo Pelillo
Gunter Pfannmüller
Annette und Steffen Pokel
Edgar Röstle
Michael Sämann
Markus Schlosneck
T-Systems International GmbH


IMAP Background Filter, Washer and Reorganizer (based on regular and and logical expressions)





You can’t perform that action at this time.