You can export your ChoiceMail whitelist to a CSV (Comma Separated Values) file easily.

For users of ChoiceMail v5.x and above - there is built in export function on your ChoiceMail Admin Control Panel. Open the ChoiceMail Admin Control Panel up, click on "User Management" button and seelct your username. Click on the export whitelist button and save the list to a file.

For users priort to v5.x of ChoiceMAil - please visit our downloads page for a tool that will let you export your whitelist.

You can always import this exported file into any version of ChoiceMail using Actions->Import Address book (CSV file).

A new feature available in ChoiceMail version 5.x adds the ability to forward good mail from your ChoiceMail to other accounts such as Gmail account for example. This account can then be easily accessed by your iPhone, Blackberry or any other smart phone that has email ability.

Here are the three easy steps that will give you access to good mail on your cellphone. (If you already have an online account on your phone you only need to perform step 2)

If you do not already have a Gmail account create one by going to www.gmail.com Here just click on the New Account button and in a few simple steps you will have a new @gmail.com account.
 
Once you have your Gmail account go into Choicemail and go to the options tab. There - choose preferences and go to the advanced tab. At the bottom of the window you will see a Forward mail box, in this box add your new @gmail.com account (or any other webmail account that can be later picked up by your phone.)
 
The final step is to set up that Gmail (or any other webmail account) into your iPhone this will let the phone pick up the good mail that will get forwarded by choicemail.
 

If you wish to get all the replies from these senders back into choicemail after you have replied from your smartphone you should set your "Reply-To" address in your online account to be your standard email address that is configured in your ChoiceMail.

For Gmail - go to your Gmail account - settings tab. Click on accounts then click on edit info which is located to the right of the Send mail as header. In there click on Specify a different “reply-to” address and put in your ChoiceMail filtered email address.

Assuming you are running an email application that can be configured automatically by ChoiceMail (Eudora, Outlook, Outlook Express), you can just configure your email application to retrieve the email from your kids normally. Then run the setup wizard in ChoiceMail to capture and protect those addresses.

You must have version 2.52 of ChoiceMail One to do this. All 2.x users of ChoiceMail One are entitled to a free upgrade to 2.52

It's quite easy to reconfigure ChoiceMail to connect to BellSouth. Please follow the instructions below

1. BellSouth says On the new platform, you will have to add your domain name to your current user name ( username@domain.com) in order to access your e-mail
1. In ChoiceMail, click on Options | Email Accounts Settings...
2. Select your BellSouth email address from the list on the left
3. In the second field on the right, called POP3 source username, change the entry so that it now includes the domain name
4. Click OK
2. BellSouth indicates you need to update your SMTP server settings to include authentication
For this, you need to make a change both to ChoiceMail AND to your email client
1. In ChoiceMail, click on Options | Configuration...
2. In the section called "Outgoing mail server", check the box called "This server requires authentication"
3. Click on the Authentication Settings button - a new dialog will pop up
4. Make sure that the "Use same username and password as incoming server" checkbox is not checked
5. In the Account name and Password fields, provide your complete username (which now includes the domain name) and your BellSouth Password
6. Make sure that the "Log on using Secure Password Authentication" checkbox is not checked
7. Click OK to close the Authentication Settings dialog
8. Click OK to close the ChoiceMail Configuration window

9. Open your email application and go to the email account settings dialog
(Unfortunately the actual process depends on the particular email program you are using - you may need to refer to your email program's documentation for this step
10. Select the account that is configured to connect to ChoiceMail - if you have multiple accounts configured to connect to ChoiceMail you will need to repeat the steps below for each account.
11. (Note - do NOT change the incoming POP3 settings in any of these accounts - those settings are already configured to communicate with ChoiceMail)
12. There should be a section somewhere related to configuring your outgoing server, sometimes called your SMTP server.
13. In that section, you will find a checkbox where you can indicate that your outgoing server requires authentication - make sure it is checked
14. You will have the option to use the same settings as your incoming mail server - do not use this option - you must specify the settings explicitly, as you did in step 5 above for ChoiceMail
15. Set the username and password exactly the same way as you did in step 5 above
16. Click OK to close out of your email account settings.

Everything should now be configured properly

Click on Options | Preferences then uncheck the box called \"Show balloon hints\"

Click OK to save your settings.

Solution Staring with Choicemail 4.x we no longer fully support webmail accounts like: Hotmail, MSN, Yahoo, Gmail, AOL. This, however, does not mean you cannot configure ChoiceMail with a webmail account.

If you had a previous version with webmail account support please try the following:
1) Open up your registry editor (regedit) by clickin on Start->Run and typing in regedit
2) Go to HKEY_LOCAL_MACHINESoftwareIzySpftIzyMail and DELETE the value with the name "Key" by right-clicking on it and selecting "Delete"
3) Open up ChoiceMail admin control Panel and STOP, then START the ChoiceMail service.

The accounts should work now.
NOTE: Please note that the above procedure is not supported and you should always be careful while using registry editor.

The way we suggest that you set up your webmail account to work with ChoiceMail is by first setting up your webmail account with your email application (i.e. Outlook). You can do this by forwarding webmail to a pop account or directly accessing by a pop3 account.

Alternatively you can follow the instructions below.
We suggest using IzyMail which can be configured on the following website http://www.izymail.com/

There are many alternatives to this as well. One of the more popular ones is FreePOPs (http://www.freepops.org/en/)
In ChoiceMail you can get the mail down from GreePops by simply specifying

freepops

as your POP3 host name.

The easiest way to set this up is to set up your FreePOPs to work without using ChoiceMail at all. Once you are done with that and everything works do the following.

1) In your email application change the incoming host name to freepops and then exit.
2) Run the ChoiceMail setup wizard and it should recognize the new account and let you set it up with ChoiceMail.

Other possible webmail gatewats can be set u in similar fashion. First step is to get it working with your email application without ChoiceMail, then you can change the hostname to

local-pop3-bridge

and run the Setup Wizard.

IMPORTANT: Once you change the hostname in your email application to local-pop3-bridge for example - that account will not work until you run the setup wizard in ChoiceMail and set the account up.

This setting can be changed in the Options | Configuration menu | Client Options

The directions below are for XP and 2000 users only. They have not been tested on earlier operating systems.

1) Open your task manager (CTRL-SHIFT-ESC is quick short cut to this)
2) Click on the Processes tab so you can see processes
3) Click View | Select columns to configure what columns are visible
4) Make sure that you include PID (Process Identifier), then click OK
5) Now click once or twice on the PID column in the process list so that processes are listed in numerical order

6) Open a DOS command prompt (you can do this quickly by clicking on Start | Run.... and then type the word CMD then press return

7) In the new window that pops up, type the following EXACTLY as written
netstat -a -o
and then press ENTER

8) You will see a list of all processes that are listening on ports. The column \"Local Address\" will show the listening ports - look for one called \"smtp\"
9) The PID on the right hand side indicates the process that has bound (taken) the SMTP port, which is port 25

10) Go back to the task manager window and look for that PID number

11) The process name on the left will tell you what program has taken the SMTP port

While we do not officially support the downgrading procedure the steps below will downgrade safely provided no files were deleted and uninstaller was not called at any time. Downgrading any software, keeping your settings, if always considered unsafe as the version you are downgrading to could not have anticipated the changes that the newest version would perform on its data.

Again - the procedure below should work ok provided all files are in tact.

1) EXIT ChoiceMail and STOP the ChoiceMail service using the admin control panel.
2) Double click on a file called uninstallcmsbsvc.cmd (located in the main ChoiceMail folder)
3) Rename the file called choicemail.ini.OLD to just choicemail.ini
4) Reinstall v3 into the same folder.

PS. If you are downgrading because your newest version would not run - please consider contacting us for support. In almost ALL cases the problem is simply not connected to ChoiceMail, but rather to your firewall or anti-virus product.

If you have upgraded to ChoiceMail 3.x and you are using large fonts in a high-resolution screen, you may find that the fonts used to display the unknown senders are now too small for your taste. This change was a consequence of an improvement to how dialogs were handled so that buttons and other controls didn't partially disappear from the screen if the dialog was stretched or shrunk.

You can fix this problem by performing two steps:

1) Download the latest version of ChoiceMail One 3.x from our website

2) Download and install this program.

This program places some new configuration files (INI files) in the folder where ChoiceMail One is installed. These files will be detected by ChoiceMail One 3.x and will cause the default font size to be increased. Please note that although it is possible for you to edit these files to change the font size yourself, DigiPortal Software cannot provide any specific technical support or guidance on format of this file or how to make changes to it. There is no guarantee that this mechanism will work in all future versions of ChoiceMail so please don�t complain if it goes away!

If file extensions are hidden in your explorer window, you can perform the following steps to make them visible.

1) Click on the Tools menu in your Explorer window and select Folder Options

2) Click on the View tab

3) In the "Advanced settings" area, look for an entry called
"Hide extensions for known file types"

4) Uncheck that entry

5) (Optional) - click on "Apply to All Folders" so that you will be able to see file extensions in all folders in the future

6) Click OK

At the bottom of the main ChoiceMail window, there are seven little rectangles containing various status information. The very last one, which is usually blank but sometimes contains two arrows in it indicates that ChoiceMail is performing an internal synchronisation (which is what needs to happen for you to see new messages). This sync should occur about once every 30 seconds or so. However, you can double-click on that rectangle to cause it to perform an immediate sync. This synchronization simply updates the user interface to reflect the current information.

Note however that it is not necessary to do this to retrieve approved messages. Once ChoiceMail approves incoming messages, they are immediately available to your email program even if ChoiceMail is not yet showing new email.

 
 
If your email system has stopped working for some reason and you need to completely reset everything from scratch, you can perform the following steps to get ChoiceMail One running again. It is important that you do not uninstall ChoiceMail as doing so will cause your whitelist and unknown sender list to be lost.

If ChoiceMail One is running, shut it down completely (Actions | Exit)

Reset your email application so that all your accounts connect directly to your ISP's or servers to retrieve and send email. If you do not know how to do this, or if you don't know the appropriate names for your servers, please contact your ISP or Hosting Company for help. DigiPortal Software is unable to help with this step.

Once you have confirmed that your email application is running normally (retrieving and sending email directly through your ISP), close it down and then download and run the following utility.

ResetConfig

This utility causes ChoiceMail to forget that it has been previously configured but it will not lose your sender lists.

Run ChoiceMail One. It will immediately tell you that it is running for the first time and will offer to run the configuration wizard just as it did the first time you installed ChoiceMail One. Just follow the instructions in the wizard.

If you think that your ChoiceMail slowed down over the years - maybe your blacklist got large and is slowing your ChoiceMail down a bit. Note that for this to happen - your blacklist must have thousands of entries. If your blacklist has about thousand entries or so - removing it will most likely not result in any performance improvement.

To delete your blacklist - please download the Blacklist Zapper tool from our downloads page and save it to your main ChoiceMail directory.
Then use it to delete all or some of your blacklisted entries.

If you have a retail version of ChoiceMail One version 2.x or greater, you can retrieve your user code and registration key by following the instructions below:

1) Click on Help | About

2) On the top left of the splash screen, you should see your usercode

3) Click on that usercode

4) A new dialog will appear containing both your user code and your registration key

This information is for users who have been running a previous version of ChoiceMail with their email application

If you are upgrading from a previous version of ChoiceMail or going from the Trial to the Retail version (we thank you), there are some important steps you should take for a successful upgrade.

1) Make sure you have completely shutdown your current version first and not just closed it to the system tray

2) Make sure you install the new version to exactly the same place where your current version lives otherwise you will not be able to get at any emails that were downloaded by ChoiceMail but not yet read by your email program. You will also lose other important settings such as your white list, black list, new senders and so on.

3) When you first run the new version, it will not download any email from your servers until it has verified that your email application can communicate with it. Therefore, once ChoiceMail is up and running, please run your email application so that it connects to ChoiceMail. You may that have you have done this once, it may still not work. Just shutdown ChoiceMail and restart it again.

There may be an occasion where you wish to NOT use ChoiceMail temporarily. Following are steps you can take to maintain an email account in your email application. We will use Outlook Express as the example email application but the instructions apply to any email client.

1) Temporarily DISABLE the account in OE that connects to ChoiceMail. When you are reviewing account information in OE, there is a checkbox called "Include this account when receiving mail". Just uncheck that box.

2) Close down ChoiceMail

3) Create a new account in Outlook Express where the incoming POP3 server is configured to retrieve mail from your original ISP. Check the box called "Include this account when receiving mail"

4) Use that account in OE to retrieve all your mail (just as you did before you ever installed ChoiceMail).

5) Disable (don't delete) that new account so that it no longer checks for email anymore. Do this by unchecking the "Include this account when receiving mail" option for that account.

6) Restart ChoiceMail

7) Reenable your OE account that connects to ChoiceMail. Do this by checking the "Include this account when receiving mail" option.

Messenger spam has nothing to do with email. Instead it replies on something called Windows Messenger Service which is typically enabled on all Windows machines.

The solution is simple - just install a firewall on your system (something you should have on your system regardless of this problem). For example, the free software firewall ZoneAlarm will do the job for you.

There are lots of information sources on the web that describe this issue in more detail if you are curious. For example, see
How to Stop WEBPOPUP Spam Advertisments
or just do a search for "stop messenger spam" using your favorite search engine.

Although rare, it is possible that an email on your server could be corrupted in such a way that ChoiceMail One cannot download it. When this happens, you may see one or more of the following symptoms :

ChoiceMail appears to stop downloading any email
Your computer slows down or stops responding
Your CPU utilization meter indicates that ChoiceMail One is using close to 100% of available CPU cycles

Perform the following steps to remove the errant message from your server.

Go to Options | Preferences
Uncheck the option "Check for new mail every x minutes"
Click OK

Quit ChoiceMail One through the Actions | Exit menu.
Make sure that it is really closed and that the ChoiceMail One icon in the system tray goes away. If it does not, then use CTRL-ALT-DELETE to get the End Tasks dialog and kill ChoiceMail.
Restart ChoiceMail - it should NOT being downloading email messages.
Click on Options | Email account settings
Select the email account on the left hand side that contains the errant message.
Click the Advanced button - a new dialog will open and ChoiceMail One will display the list of messages on your server.
Select the message that is not being downloaded properly.
Press the Delete button - the message will be deleted from your server. If there are multiple problematical messages, you can delete the all here.
Click OK to finish this dialog
Click OK to close the email account settings dialog

Click on Actions | Check for new mail now to download your mail again - all should be fine.
Go back to Options | Preferences and reenable checking
for new mail
This problem should now be resolved.

 
The most likely possibility is that you have Outlook running as a background task. Open your task manager and look at the list of processes running on your machine (you might want to sort the list by name).

Look for a process called Outlook.exe and kill it. The ChoiceMail One installer should then run with no problems.

To configure your gmail account to work with choice mail you have to follow the following steps.

Open the link http://mail.google.com/support/bin/answer.py?answer=13276

select either the automatic (recomended) or the manual configuration

follow the steps and once you are done close your email application open Choice Mail, => options => run set up wizard

Run the set up wizard just like you would for any other email and once you are done you should have gmail configured with choice mail.

First - do not change your ChoiceMail username. Even if your ChoiceMail username includes your old email address, it doesn't matter. It can and should stay the same.

There are two ways you can change the necessary information - which one you use depends on the email program you are using. If you are using Outlook Express, Outlook 98 or later, or Eudora, you can use the ChoiceMail Setup Wizard to help reconfigure everything. To do this, perform the following steps.

1. Open your email account settings in ChoiceMail (Options | Email account settings)
2. Delete all the POP3 accounts (Do this by selecting each account and clicking the Delete button) then click OK
3. Open the SMTP configuration in ChoiceMail (Options | Configuration)
4. In the Outgoing mail server section, click Delete for each SMTP host that you no longer need, then click OK
5. Quit ChoiceMail completely (Actions | exit)

6. Open your email program
7. Go to the email account settings section (refer to your email program documentation) and delete all the accounts
8. Add the new email accounts following the instructions from your ISP/provider for the settings
9. Make sure you can send and receive email normally (i.e. without ChoiceMail)

10. Open ChoiceMail again
11. Run the setup wizard (it's in the Options menu) and follow the instructions to add your email accounts and test them

If the process above does not work, or if you need to configure your settings manually, follow the instructions below

To configure your email manually when you get a new provider and/or your email addresses change, you will need to change the following items:

1. Your POP3 account settings in ChoiceMail (Go to Options | Email account settings)
2. Your outgoing SMTP settings in ChoiceMail (Go to Options | Configuration)
3. Your POP3 account settings in your email program
4. Your SMTP authentication settings in your email program (only if your new provider requires SMTP authentiation)

1. Your POP3 account settings in ChoiceMail (Go to Options | Email account settings)
1. Open your email account settings in ChoiceMail
2. Delete accounts that will no longer be used (Do this by selecting each account and clicking the Delete button)
3. For each new email account that you want ChoiceMail to protect, click New and then fill in all the fields. Your new ISP/provider will have provided you with your email address, username and password and the POP3 server (source host) for the account.
4. Click Test to test the new account to make sure it is connecting properly.

2. Your outgoing SMTP settings in ChoiceMail (Go to Options | Configuration)
1. In the Outgoing mail server section, click Delete for each SMTP host that you no longer need
2. Click Add to add the new SMTP host - the information you need, including any authentication settings, will have been provided to you by your ISP/provider. Contact them (not us) if you do not have all the information.
3. If you need authentication, check the "This server requires authentication" box, then click on the Authentication button and enter the settings from your ISP
4. Click Test to test your settings
5. Click OK to close the dialog

3. Your POP3 account settings in your email program
1. Open your email program
2. Go to your email account setup
3. Take a look at one of the accounts so that you understand how it connects to ChoiceMail . In particular, notice that the username consists of your ChoiceMail username followed by a "/" character, followed by the email address in ChoiceMail that is being protected.
4. Rather than deleting your old accounts, you can simply modify them to reflect the new email addresses. When you modify your existing accounts to reflect the change in email addresses, it is critical that you do not change or remove the ChoiceMail username prefix, change only the portion after the "/" character. If the ChoiceMail username portion contains a complete email address (probably your old email address), leave it there .
5. There should be a field that contains your old email address by itself - that's the address that appears in the FROM field in messages you send out. Change that field to your new email address
6. Find the field for the username - the portion after the "/" should contain your old email address - change that to the new email address.

1) Copy all the email account settings from the email program on your old machine to the email program on your new machine. Make sure you copy all fields exactly, paying particular attention to the username on each account (which will normally be a combination of your ChoiceMail username followed by a slash followed by an email address), POP3 and SMTP settings and the ports.

2) Then, by whatever mechanism you are using to copy data from your old machine to the new machine, copy the ENTIRE ChoiceMail folder and sub-folders from your old machine to your new machine

You should then just be able to run CM on the new machine with all data intact.

If you are using 2.52 or better, you should perform the following steps

1) Run the setup wizard in ChoiceMail
2) Get to the point where it displays what email addresses are being protected
3) Move those addresses to the left window so as to unprotect them
4) Close ChoiceMail
5) Your email application should now be connected directly to your original ISP
6) Make whatever network changes you need to make
7) Configure your email program to work with your new email account
8) Run ChoiceMail, run the setup wizard again and reprotect the new account.

There are two methods, but in both cases you should pick up all the messages remaining on the old computer, delete all unknown senders and purge your junkbox on the old computer. Then make sure you STOP the ChoiceMail service on the OLD computer to prevent it from downloading any new messages.

First method
----------------
On our downloads page: http://www.digiportal.com/support/choicemail/downloads.htm

You can find the whitelist/blacklist exporting tool that you can use to export your whitelist. Download this tool, save it to your OLD ChoiceMail folder (same folder where your ChoiceMail.exe is) and run it. You will be asked to enter your username (most likely your email address). The software will allow you to export your whitelist to a file. Please name the file with the .CSV extension. For example: cmwhitelist.csv

Then perform the following steps:

1) Make sure you set up your email application, on the new computer, exactly as your ISP wants you to and you can send and receive mail BEFORE you install ChoiceMail onto the new computer.
2) Download and install ChoiceMail and configure it so that it works on your new computer.
3) Click on Actions->Import address book and then import from the file. Select the file you exported to at the begining of these instructions.

Second method
-----------------
This method should only be used in case you plan to move ChoiceMail to the exact same drive location on both computers. For example C:\Program Files\DigiPortal Software\ChoiceMail. If you are moving to different drive and location or have different set of addresses to protect - we recommend the first method.

1) Make sure you set up your email application, on the new computer, exactly as your ISP wants you to and you can send and receive mail BEFORE you install ChoiceMail onto the new computer.
2) Download and install ChoiceMail.
IMPORTANT: Do not configure any settings and do not run the setup wizard.
3) Make sure you STOP the ChoiceMail service on the new computer. To do this use the ChoiceMail Admin control Panel and click STOP to stop the service. Then EXIT the ChoiceMail Admin Control Panel. It is important that NO ChoiceMail programs are running while the files are being transfered.
3) Copy ALL files and folders from the old computer's ChoiceMail folder to the new one overwriting the files on the new computer.
4) Copy the file called choicemail.ini from the old computer to the new one. The file is located at the following location - on Windows XP "C:\Documents and Settings\USERNAME\Local Settings\Application Data\DigiPortal\" On Windows VISTA :C:\Users\USERNAME\AppData\Local\DigiPortal\ (you may have to show hidden files and folders in your file explorer to navigate to these folders)
5) Start the ChoiceMail service and ChoiceMail id desired.

Finally uninstall ChoiceMail from it once you have it running on the new computer and your settings are transfered.

ChoiceMail supports the standard CSV format for email addresses. Most email applications have the ability to export email addresses in this format (it may just be called 'text' format.

So you can export your email addresses from your email program to a file on your harddrive and then you can import the file into ChoiceMail.

(Refer to the email program documentation if you don't know how to export addresses, but chances are that there is an EXPORT menu item under the FILE main menu in your program)