Before contacting support or if you experience any issue whatsoever, usually there is a newer build (version may stay the same, but the build is newer) for the PRO version you bought (v2.x or v3.x) and you can download it from the same location we have listed in the license email you received along with the serial.
To check the build you currently have, hover the mouse over the main title text (i.e. "Mail Attachment Downloader") in the main program window and you should see the version eg. 3.2 and the build 3.2.0.955 (955 is the build).
All settings will be preserved when upgrading, however, we highly recommend you backup the Settings folder before upgrading. You can backup the settings via the Export/Import tab. If you do not have an Export/Import tab, you can open the Settings folder from the Settings button -> Settings folder button if you are using v3.x OR from the Mail Server tab -> Settings folder button if you are using v2.x.
IMPORTANT -- Before installing the latest build UNINSTALL the service from the service tab (from within the program) first.
If you are running SysInternals process explorer it will prevent the service from being fully uninstalled.
Mail Attachment Downloader PRO Server enables you to install Mail Attachment Downloader as a Windows Service. The service is a separate program that runs in the background usually under a System account.
Service Type dropdown
We recommend using the LocalSystem as the service type instead of User to avoid permission issues. The selected service type account is what the service runs as. For the service user ensure the following:
When the service is installed all configurations are copied over to the Windows Service account. Any changes you make locally as a user will not take effect unless the service is uninstalled and re-installed.
When you install a service, it is recommended you do the following:
Once you have completed the above, click the Install Service button to install the service.
The service will then copy all settings over to the service account. When the status says running, the service which is now running in the background will start checking for attachments in the duration specified in the Services tab. This will remain running even if you logoff.
CONFIG CHANGES NOTE
Any time you make changes in the settings, you will need to uninstall and install the service in the Service tab for those new settings to take effect.
Please refer to the Mail Server Settings HOW TO page for up-to-date information on configuring the mail server settings for this product.
Once you have succesfully installed the Windows service, any changes you make to any configuration as a user will NOT take effect on the service. The service has a copy of all the configuration at the time you installed the service.
If you would like to make configuration changes, Uninstall the service first, make the changes, then Install the service again.
By default the service is installed with the 'Local System' account. This is the recommended setting.
Alternatively, you can select 'User' from the Service Type dropdown to restrict access. Please note that when you select 'User', the account should have Local Administrative rights for it to work properly.
If you choose to install the service as a User or non-administrator, it will require more effort to ensure the service has all write permissions in all the right places in order to enable it to start up successfully. Support for this kind of non-administrative type of account is limited at this time.
It is important that the Service Type you install the service as has read AND write access to all download folders you've selected for the account. Otherwise the service will not start.
If you would like to find out why the service did not start or install, please check the Logs folder (by clicking on the Logs button) and look into the Service logs. As always, drop us an email if you are having trouble with this. We should be able to look into your issue within a day.
For progress or if the service status does not say running, you can check the ServiceLog.txt file in the service logs folder (click the Service tab -> Service logs folder) for progress of when and how the program is checking for attachments.
If you start the program as a user, the UI will NOT show progress for the service .
To see the service progress in the program window, start the program as an Administrator. Navigate to 'C:\Program Files (x86)\GearMage\Mail Attachment Downloader Pro v3.2' and right click on MailAttachmentDownloader.exe and Run as admin. Next time the service checks email, you should see the output of the program now in the Status area.
You can also view the Download History (download history tab next to Current Status tab) and then select Service History from the dropdown on the far left. This will show you a file history of all files downloaded by the service. Also, the Download Chart will reflect the service download history. You can search through history through the Download History tab.
When you install the Service, the service will only install and download attachments for the Email account you've selected from the dropdown with the same settings you have for that email account.
If you want the service to run for multiple accounts, choose the multiple accounts from the Email dropdown and then install the service for that account
You MUST have the save passwords checkbox checked for all accounts that you want the Service to download attachments for.
Select multiple@multiple from the Account dropdown in the main window and select the accounts you want to run for. Then just hit Connect And Download.
In the Free version, you had various tabs to specify how to filter the emails down. In the PRO version, we recommend you use the Global filters (tab) instead. We have this blog post explaining how to move from the Free configuration to the Global filters configuration. Please read it in its entirety before contacting support.
Global filters are what allows you to take various actions (like document conversion, copying or deleting emails after download).
Hold the Ctrl button and drag and drop the rule in the Global filters tab.
The program identifies new mail based on when it last successfully downloaded attachments.
So when you run it for the first time, since no attachments have been downloaded yet, it will download all mail attachments in your email inbox after which it will only scan for mail attachments that arrive from thereon (including read and unread mail).
The default setting will only download messages since last download including unread mails that have not been downloaded by the program. IMPORTANT: If you switch this setting to All mail at any time, any state will be lost and the next time you select messages since last download it will download from the start again. To avoid this, select a date filter (see FAQ below titled "How do I download from a given date?").
Subsequent runs by clicking the 'Connect And Download' button will download remaining mail attachments that have not been downloaded yet until it has downloaded all attachments till the present day.
If you don't want to wait to download all email attachments the first time when messages since last download option is selected in the Search tab for the account, do the following.
If you are using Global filters tab:
If you look at the search tab, date filters should be disabled. This is because Global filters has rules defined within. To make an initial download from a date when using Global Filters, in the Global FIlters tab set the Start Date to the day you want to download from. This will ensure that the first download is always from that date. Subsequent Connect And Downloads would only check for new messages if you had selected "Messages since last download" option in the Search tab for that account. You can always select "All mail" to re-download the older mails from that date again.
If you are NOT using Global filters tab:
Set the 'start date' from which you want to download your attachments in the Search tab. Leave the 'end date' unchecked to indicate that there is no end date.
If you you want to re-download the same attachments that the program had already downloaded in the past, choose Search -> Check In -> All mail. You may also want to check the Inline Content checkbox if you want to download attachments that are inlined. For certain types of mail servers this will be checked by default.
The program tries to log you in with your supplied password. Google has enabled higher security by default on most new accounts, so when the program tries to connect Google will deny the login attempt requesting that the program provide more credentials.
When this happens, you will be then taken to google.com to authorize the program to access your email with a code. This will only happen the first time you logon. All subsequent logons will NOT send you this email. More info about security
Please read through the description here first for Global filters. Rules have the following components: Filters, Extractions, Save location/format and Actions. If the filters defined inside the rule matches an attachment or email body, then the file (which could be the body of the email) is saved in the specified save location and format inside the rule. Once the file is saved, the various actions are run. Rules are run from top/down order and ordering is important.
For any testing, always make sure the service is NOT running. That is uninstall the service first from the Service tab. And then run a normal connect and download as described below until you are comfortable with the download process and rules. Then re-install the service when you are ready.
The best way to test Global filters (when you have many of them) is to create a new mailbox folder in your email account called something like "Test Mail Attachment Downloader". Then in the main program window, pick Selected folders and then check ONLY the "Test Mail Attachment Downloader" folder that you created. Then in the Search tab, pick "new messages since last download" and ensure Inline checkbox is checked.
Then move (do not forward) any emails you want to test into this folder using any email client of your choice (like Thunderbird, Outlook etc.). Then run Connect and Download to test whether the specific rule was applied. You can see which rule was applied in the "Download History" tab (next to "Current Status" tab towards the lower half of the main program window). If you see that the wrong rule was run for this test, make sure ordering of the rules is correct.
Make sure when you are done testing that you deselect the test folder that was selected for the test and then the folder you want to normally run on is selected.
You may be behind a corporate firewall or something may be blocking your connection. Check with your IT administrator to ensure that your host, port, TLS and IMAP/POP3 information is correctly entered and that you have a direct connection to the mail server. If the connection still fails, contact us.
Some attachments are inlined, check the 'Inline attachments' checkbox in the Search tab. If the attachment still doesn't download, contact issues@gearmage.com.
Some mail servers only support the POP3 mail server protocol.
The POP3 protocol inherently does not support folders whereas the IMAP protocol does.
To overcome this, first, make sure that your mail server supports IMAP and then change the protocol via the Settings button to IMAP.
If you are using POP3 (in the mail server tab, see if POP3 is selected), the program will still need to scan/download (and throw away) attachments from the start of time even if the date is set.
A format of attached files that is sent by Outlook (TNEF) is not supported if your mail server does not convert them. These will be ignored by the program.
Some email providers like Gmail will end up throttling your connection if we end up processing too many requests for a given email account.
The settings for the Client side of the program are stored in the users %AppData%\MAD folder based on the logged on Windows user. You can confirm this by going to the Logs tab and clicking the Logs folder under the Client section. This is per user and switching users will loose these settings.
The service settings are stored in a different directory. Click on the Logs folder and click the Settings folder button under the Service section to open the service settings folder.