Explore features, usage guides and more

Run a custom command or program after download
You can use this to automate processing of attachments by running a script and passing the location of the file that was downloaded and any other meta information as arguments (the arguments are completely configurable). For example, to copy a file automatically after download is complete, specify Run Command as copy and Command line actions as "{SAVE_PATH}\{FILENAMEEXT}" C:\TEMP.

You can now search through downloaded file history by date and by any text. For example, if you wondered if a certain file from someone was downloaded by the program a few months back, you can provide a date and the from detail as search to see when it was processed.

Furthermore, the charting capability provides a birds eye view of the number of files that were processed and the number of errors if there were any over time. When you issue a search as part of the Download History tab, it is also reflected in the chart. So if you were looking for all downloads for a certain email account, you can display a historical chart for that account by entering that account in the download history search box.

By default the history displayed is for the client program only. If you are running a service (PRO Server) you can switch the view for both the download history and download chart's to the service account by changing the pull down in the top left of the Download History tab from 'Client history' to 'Service history'. That would now show all the files that were downloaded by the service.

NOTE: The FREE version has limited history (stops recording after a certain time period) and limited data (from/to/subject/date are not saved). The PRO Client and PRO Server enables full history and charting capabilities.

Before starting the service you can choose to run the service as the Windows System account or under a specific User account. You can also enable the functionality to automatically start the Service when the system starts and check mail in the background without a user being logged in.

1Supported Windows Server operating system versions are Windows Server 2016 or greater.

2Supported Windows Client operating system versions are Windows Client 7+ or greater.

Export and/or import allows all Mail Attachment Downloader settings and/or rules to be migrated from one system to another.

Note that doing so will not copy passwords or the option of saving passwords. Once restored, passwords will need to be typed in manually.

Extract data form excel or csv and add all rows to a database table

You can use this to save contents of an Excel or a CSV attachment to a SQL database like MySQL or SqlServer and more.

You have complete flexibility on which fields you want to store and how you want to store it in the database. You can also use the extraction wizard to transform fields (or prune them as necessary) and convert fields to a specific type that is compatible with the database.

Convert emails, documents, excels, presentations, pdf's and images from one format to another. PRO versions support conversions to PDF and PRO Server supports over 50+ formats (including exporting to various document, excels, presentations and image formats). Offers great conversion quality and parity with source formats.

Just pick the source format (from either a document, spreadsheet, presentation and more) and then pick the destination format. Specify the name and extension you want for the converted file. That's all it takes to now download and convert attachments. You can also add many conversions for the same attachment into many formats if needed.

You can run other actions under this action, for example, you can merge all PDF's downloaded/converted/extracted from the email into one large PDF if need be.

Merge PDF files into one

Merge many PDF files into one file. You can use the document conversion action to convert many different formats first into PDF as part of a rule and then merge these PDF's into one by using this rule.

Split PDF files into many

Split a PDF file into individual pages or filter down to choose specific pages. If the document isn't in PDF format, you can use the document conversion action first to convert many different formats first into PDF as part of a rule and then split the PDFs as needed.

Download all embedded link

As shown, you can download some or all of the http links in the body of the email to files.

You can also filter down on what type of files needs to be downloaded and cutomize the filename they will be saved as.

Optionally you can use a regex based download if needed as shown below

If you have already checked the simpler link download option above and need more flexibility this may be an option for you.

Download embedded links with regexes

You can customize the Pattern to look or extract the HTTP url that you want and if there are many, you can extract many URL's by defining separate fields to extract.

Once the fields are extracted, create a download action in 'Actions after save' to save the downloaded file.

The filename will automatically be chosen based on the end of the url (example https://gearmage.com/test-receipts.zip) would yield test-receipts.zip as the filename. You have flexibility to custom name this file as shown.

Once the file has been downloaded, you can run further actions on the downloaded file as shown that includes an unzip action and then send mail action (PRO Server required).

Send email

Send email after an action is complete and choose to include or not include attachments that have been downloaded in previous actions. For example, in the screenshot we have downloaded a file from an embedded link in the body of the message, unzipped it and then sent an email with the contents of the unzipped file.

All fields like From, To, Subject, Body can be customized with fields such as {FROM}, {TO} or also include extracted user-defined fields like {URL_IN_EMAIL}.

Lookup fields from a DB

Have a need to lookup data from a database based on email contents? You can do so by adding the Lookup from database action. You can provide a SQL that takes in any email content or extracted field and perform a SQL query.

The results of the SQL query are then stored within fields with the format: {COLUMN_NAME} where COLUMN_NAME is the column that was used in the SQL query. You can then use these fields in further actions like copying the attachment or saved email to a location with the {COLUMN_NAME} value.

In the example above, the lookup is happening based on the EMAIL_FROM. The field will be named {ACCOUNT_ID} after the ACCOUNT_ID lookup. You can use that in any further actions as mentioned earlier.

Save to DB

You can use this to save contents of the email and optionally the attachment to a database. You can save any fields in the email, any extracted field and optionally the actual contents of the attachment in a blob. Although blob's are supported, this may require enough storage on the database and may also require further tuning. Alternatively, you can store the location of the files saved (for example, if you save it on a share) and store that location in stead of the actual attachment in the database.

You have complete flexibility on which fields you want to store and how you want to store it in the database.

Extract data form excel or csv and add all rows to a database table

You can use this to save contents of an Excel or a CSV attachment to a SQL database like MySQL or SqlServer and more.

You have complete flexibility on which fields you want to store and how you want to store it in the database. You can also use the extraction wizard to transform fields (or prune them as necessary) and convert fields to a specific type that is compatible with the database.

For each rule filter, you can create new fields (enclosed withing { and }) extracted from email headers (like from, to, date etc.) or body or even attachments.

Start by dragging a file into the test data area. In the search tab, enter the starting text to look for and optionally something followed by (you can leave this blank).

In the extract tab, choose where you want to stop extracting data.

As will be later shown, you can then transform data if needed.

For example, you can save this to a database (available in PRO Server only) after extracting these fields.

Copy or Move email

Once the download of the file completes for that rule, you may choose to even copy or move the mail to another mailbox folder.

Delete email

Once the download of the file completes for that rule, you may choose to mark the email as deleted.

Save .csv with header info

After download, you may choose to save a .csv file with the same name as the downloaded filename, except with the .csv extension and include info from the mail headers.

Copy file

Easily copy a file to another folder

This post download action is run after the download completes. You can use this to backup files.

The FREE version only downloads from one account every time the download is initiated. The PRO version lets you select multiple email accounts that you can now use to download from for each session.

You no longer need to manually switch between accounts to download across multiple accounts and instead have the software scan across many email accounts with each download session.

To select from multiple accounts, just pick the multiple@multiple from the Account drop down and pick the accounts as shown in the screenshot to use.

Automate simple tasks like filing away attachments into specific folders in the way you want it or run the many post download actions (like converting documents or images) available with easy setup.

You can choose from various templates as shown to form the filename or even use fields you extracted. For example

{EMAIL_FROM}\Payments_{FILENAME}{EXT}

will create a directory based on the email from and save all attachments from that email in that folder with the specified format like 'Payments_Inv0023.txt'.

You may use any templates within {} as shown on the right as a template in the Filename Format field. They can appear any custom user defined order. You may also use your own filename instead of the attachment filename, if so required.

To insert a template from the list shown, just double click the field and it will be inserted into the textbox at the current cursor position.

A new rule filter is created by clicking the '+ Add new filter' button in the Global Filters tab. For the 'Payments' filter shown in the Rule Filter screen shot, you can then configure various different features for that specific filter.

Each new filter can now be customized with specific rules that determine how to process an attachment and save it to a specific location. You may also run post-download actions as will be later shown.

Since each filter can have a set of triggers defined (for example, matching From or Subject of the email) and a different save location, you can now have many rules to process attachments in many ways (including the ability to save email attachments to different folders in different formats based on any criteria).

For a more detailed description of each feature, see the descriptions for Flexible filters, Flexible filename format and save locations and download actions (PRO Server only).

Each rule has the following capabilities:

FILTERS: Add a filter by clicking the Add button dropdown and then selecting the Filters option within. By adding multiple filters, you can be sure that this rule will only run when all filters match.

EXTRACTION: Extract data from various email fields like the FROM, TO, BODY by using extractions feature. Add an extraction by clicking the same Add button dropdown and then selecting the Extractions option within.

ACTIONS: Perform various actions if the filters match for an attachment or email. Add an action by clicking the Add action button dropdown and then selecting the action you want to run. For a list of actions look at our features list.

Setup multiple global rule filters (Global Filters tab as shown) that can be used across all selected email accounts so you don't have to re-enter rules when you switch accounts.

For example, setup one rule filter to look for emails from 'Payments' and have it saved to one folder then run some download actions. And setup another filter for emails from 'Receipts' and have a different save location, file formats and different download actions (like saving to a database, copying a file and more).

RUN FOR ALL ACCOUNTS or a SPECIFIC ACCOUNT: The global rules, by default, are not account specific and can run for any email account. Note that the rules will only run for the Account selected in the Account drop-down in the main program window when you click Connect and Download. You can run the global rules for multiple accounts by selecting multiple@multiple in the Account drop-down.

If you wanted a given rule to run for a specific account always and not for any other account, you should add an account filter for that rule (click Add -> Filters -> Account filter inside the rule filter window).

ORDERING: Rules are always processed from topmost rule down. Ordering is important in that when processing an attachment or the email body, if a specific rule matches the filters defined within, then subsequent rules below it for that attachment or email body will NOT be run. You can reorder rules by holding down the CTRL key and dragging and dropping the rule in the Global Filters tab. For example, you should place a catch-all rule at the very bottom.

CLONE RULES: If you are defining many similar rules, you can clone a rule by just editing a rule similar to the new one you want to create and giving it a new name. When you click Save, you will be prompted whether you want to delete the old rule, just select No and you will now have a new rule. We recommend giving meaningful names to rules so they are easy to search if you are defining many of them. For example, if a rule applies to a specific account, include that account name in the rule name.

As mentioned earlier, anything enclosed within quotes (') can also include regular expressions and those can be easily verified using the test expression window.
The expressions are also backward compatible and also support all earlier mechanisms of specifying and comparing results (eg. those starting with '!!' etc.).