cutelyst / simple-mail

An SMTP library written in C++ for Qt. Allows applications to send emails (MIME with text, html, attachments, inline files, etc.) via SMTP. Supports SSL and SMTP authentication.

SimpleMail

The SimpleMail is small library writen for Qt 5 or 6 (C++14) that allows applications to send complex emails (plain text, html, attachments, inline files, etc.) using the Simple Mail Transfer Protocol (SMTP).

Features:

• Asyncronous operation
• SMTP pipelining
• TCP and SSL connections to SMTP servers (STARTTLS included)
• SMTP authentication (PLAIN, LOGIN, CRAM-MD5 methods)
• sending MIME emails (to multiple recipients)
• plain text and HTML (with inline files) content in emails
• nested mime emails (mixed/alternative, mixed/related)
• multiple attachments and inline files (used in HTML)
• different character sets (ascii, utf-8, etc) and encoding methods (7bit, 8bit, base64)
• multiple types of recipients (to, cc, bcc)
• error handling (including RESET command)
• output compilant with RFC2045

Examples

#include <QCoreApplication>
#include <SimpleMail/SimpleMail>

int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);

    // First we need to create an Server object
    auto server = new SimpleMail::Server;

    // We will use the Gmail's smtp server (smtp.gmail.com, port 465, ssl)
    server->setHost("smtp.gmail.com");
    server->setPort(465);
    server->setConnectionType(SimpleMail::Server::SslConnection);

    // We need to set the username (your email address) and the password for smtp authentification.
    server->setUsername("[e-mail]");
    server->setPassword("your_password");

    // Now we create a MimeMessage object. This will be the email.
    SimpleMail::MimeMessage message;
    message.setSender(SimpleMail::EmailAddress("[e-mail]", "Your Name"));
    message.addTo(SimpleMail::EmailAddress("Recipient's Name <[e-mail]>"));
    message.setSubject("Testing Subject");

    // First we create a MimeText object.
    auto text = std::make_shared<MimeText>();

    // Now add some text to the email.
    text->setText("Hi,\nThis is a simple email message.\n");

    // Now add it to the mail
    message.addPart(text);

    // Now we can send the mail
    SimpleMail::ServerReply *reply = server->sendMail(message);
    QObject::connect(reply, &SimpleMail::ServerReply::finished, [reply] {
        qDebug() << "ServerReply finished" << reply->error() << reply->responseText();
        reply->deleteLater();// Don't forget to delete it

        qApp->quit();
    });

    app.exec();
}

License

This project (all files including the demos/examples) is licensed under the GNU LGPL, version 2.1+.