ImapX – free for use .NET library

ImapX is an modern .NET 2.0 library for management of IMAP folders, supports SSL Connection and different IMAP formats, such as Gmail IMAP, AOL IMAP

Here is simple example of usage:

      ImapX.ImapClient client = new ImapX.ImapClient("imap.gmail.com", 993, true);
      bool result = false;

      result = client.Connection();
      if (result)
        Console.WriteLine("@Connected");

      result = client.LogIn(userName, userPassword);
      if (result)
      {
        Console.WriteLine("@Logged in");
      }
      //Folder Collection
      ImapX.FolderCollection folders = client.Folders;
      //Create folder
      client.CreateFolder("NEW FOLDER", false);
      //Message collection 1st option
      ImapX.MessageCollection messages = client.Folders["INBOX"].Search("ALL", true); //true - means all message parts will be received from server

      //2nd option
      foreach (ImapX.Message m in client.Folders["INBOX"].Messages)
      {
        m.Process();
        List attachments = m.Attachments;
        string textBody = m.TextBody.TextData;
        string htmlBody = m.HtmlBody.TextData;
      }

      ImapX.Message msg = new ImapX.Message();
      msg.Subject = "hello yahoo";
      msg.From.Add(new ImapX.MailAddress(fromUserName, fromUserEmail));
      msg.To.Add(new ImapX.MailAddress(toUserName, toUserEmail));
      msg.HtmlBody.ContentType = "text/html";
      msg.HtmlBody.TextData = "it is test message";

      ImapX.Attachment atach = new ImapX.Attachment();
      atach.FileName = attachmentPath;
      msg.Attachments.Add(atach);
      if (client.Folders["INBOX"].AppendMessage(msg))
      {
        Console.WriteLine("message has been appended to INBOX");
      }

Feature list supported by library:

• Folder management
• Message management
• Message saving in IMAP folder (like Drafts on Gmail)
• SSL
• Custom IMAP server implementations (like Google and AOL)
• Full IMAP Search compatible

Features to be implemented during near future:

• Offline message storage/synchronization

In ZIP archive you will find actual dll to use and IMAP Search reference document, sorry no documentation at this moment.

Hopefully it will be usefull.

Feb 24, 2010 update:

We have fixed following issues:

1. now we correctly support message flags (“DELETED”, “SEEN”, “ANSWERED”, “DRAFT”, “RECENT”) and custom flags
2. correctly handling spaces in passwords (need to be tested more, please contact us if you’ll find an issues there)

There are code sample which allows to set message flags:

ImapX.MessageCollection messages = client.Folders["INBOX"].SubFolder["NEWFOLDER"].Search("ALL");
//get list of current message flags
List allFlags = messages[1].Flags;
//set fllag array of flags are in ImapFlags constants
messages[1].SetFlag(ImapX.ImapFlags.SEEN);

Feb 25, 2010 update:
Today we have released version 1.0.5 of the library

Fixed issues:

1. now correctly handling different types of subjects from IMAP

March 4, 2010 update:
Today we have released version 1.0.6 of the library with a great performance improvements (up to 4 time faster)

Fixed issues:

1. Now it’s possible to search for messages without auto-filling the body, header and other message properties. Added new bool parameter for Search method which indicates to fill properties or no

Here is code example

//result messages  + process()
ImapX.MessageCollection messages = client.Folders["G01"].Search("ALL", true);
//result empty messages
ImapX.MessageCollection messages = client.Folders["G01"].Search("ALL", false);
//fill message header info
messages[1].ProcessHeader();
//fill message flags info
messages[1].ProcessFlags();
//fill message body info
messages[1].ProcessBody();
//fill all message info
messages[1].Process();

March 4, 2010 update:
We have updated library to 1.0.6.1 version. Fixed some minor bugs. Thanx to Dalibor.
March 25, 2010 update:
We have updated library to 1.0.6.3 version. Fixed some more minor bugs.
March 26, 2010 update:
We have updated library to 1.0.6.4 version. Added IsDebug property to ImapX.ImapClient

client.isDebug  = true; // with this option , all requests and responses are print to Console window

April 14, 2010 update:
We have updated library to 1.1 version. Fixed bugs with message processing, users faced in previous releases.
Please note: if your are facing any problems with message body or if message has no content-type, you may find all body parts in BodyParts collection:

   List<MessageContent> bodyParts = msg.BodyParts;
   //get body :
   string body = bodyParts[index].ContentStream;

Some users facing problems with different Subject/Body encodings. Please note – ImapX itself doesn’t decode subject/body automatically. For instance if you have subject encoded to BASE64 using UTF8 charset you have to do following techniques:

   //preparing subject to be sent
   string codedSubject = "=?UTF-8?B?" + Convert.ToBase64String(Encoding.UTF8.GetBytes(subject)) + "?=";
   //decoding subject from received message
   string decodedSubject = Encoding.UTF8.GetString(Convert.FromBase64String(CodedSubject.Split('?')[4]));
   //decoding body from Base64/UTF8 :
   string decodedBody = Encoding.UTF8.GetString(Convert.FromBase64String(msg.HtmlBody.TextData));

Thanks to all of users of ImapX. And thank you for you comments, your responses help us to develop better IMAP library.

April 27, 2010 update:
We have updated body processing, ImapX refused to consume some bodies produced by Outlook 2007. It’s fixed in 1.1.0.1 version

May 12, 2010 update:
Updated:

• Message parsers updated
• Fixed problems with special characters in folder names
• Added body part properties: BoundaryNames and PartHeaders
  Example:

  MessageContent body = message.HtmlBody;
  body.BoundaryNames // name of boundary of this part
  body.PartHeaders // Collection headers of this part

July 7, 2010 update:
Updated:

• Message parsers updated
• Fixed problems with marking message as seen during processing
• Fixed attachments processing

If you’ll face problems with a message parsing then please use method GetAsString() of class Message. It will allow you to use custom parsers to parse a message

Download