Socket.IO C++

I’m really proud to announce the first release of the Socket.IO C++ Client on GitHub!

Based on Boost and WebSocket++, this full-featured Socket.IO 1.0 client has the fundamental advantage of working on multiple platforms. Check out the directory of examples. It contains examples of iOS, QT, and CLI chat clients!

To learn how to use this client, I put together a QT chat example that communicates using a Socket.IO Node.JS chat server. Keep reading for step-by-step instructions.


If you’d like to follow along, begin by cloning the repository using the following:

git clone --recurse-submodules

The app includes the following features:

  • Send messages to all users joining the room.

  • Receive a notification when users join or leave the room.

  • Receive notifications when a user starts typing a message.

Before you get started, visit the QT community to download and install QT.

Creating a QT GUI Application

Launch the QT Creator.
On the welcome page, select New Project, then create a QT Widget Application. Name it SioChatDemo.
The project structure should look like this:

    |   |__mainwindow.h
    |   |__main.cpp
    |   |__mainwindow.cpp

Importing an SioClient

Let’s copy the SioClient into the QT project under the subfolder sioclient.

Edit to configure paths and compile options by simply adding:

SOURCES += ./sioclient/src/sio_client.cpp

HEADERS  += ./sioclient/src/sio_client.h

INCLUDEPATH += $$PWD/sioclient/lib/rapidjson/include
INCLUDEPATH += $$PWD/sioclient/lib/websocketpp

Add two additional compile options:


The no_keywords flag prevents qmake from treating some function names as emit as the keyword for the signal-slot mechanism.

Use c++11 to ask for C++11 support.

Importing Boost

We now have our boost headers and a fat boost static lib named libboost.a(non-win32) or boost.lib(win32).

To import them, we need to edit again by adding a header including the following:

INCLUDEPATH += `our boost headers folder`

Linker options:

win32:CONFIG(release, debug|release): LIBS += -L`our Win32 boost static lib folder` -lboost
else:win32:CONFIG(debug, debug|release): LIBS += -L`our Win32 boost static lib folder` -lboost
else:unix: LIBS += -L`our osx boost static lib folder` -lboost

Create the Main Window UI

Create a simple UI by dragging and dropping a widget from the widget box on the left-hand side.

It contains the following:

  • A QLineEdit at the top to input a nickname: nickNameEdit

  • A QPushButton at the top right for login: loginBtn

  • A QListWidget in the center for showing messages: listView

  • A QLineEdit at the bottom for typing messages: messageEdit

  • A QPushButton at the bottom right for sending messages: sendBtn

Add Slots in the Main Window

The following slots need to be added in the mainwindow class to handle UI events:

  • Click ‘Login’ button

  • Click ‘Send Message’ button

  • Text change in message editing (to show typing status)

  • Return message editing (for sending responses)

Insert the following code into the MainWindow class in mainwindow.h:

public Q_SLOTS:
    void SendBtnClicked();
    void TypingChanged();
    void LoginClicked();
    void OnMessageReturn();

Connect the UI Event Signal and Slots

Open mainwindow.ui in the design mode. Switch to the signals/slots mode using Menu->Edit->Edit Signals/Slots.

Click and hold the widget and drag it to the window (the cursor will become an electrical ground symbol) to open the connection editor.

In the connection editor, edit the main window slots on the right side. Add the slot function names added in mainwindow.h before.

Then we can connect the event signal to the widget with our own slots. The result should look like this:

Adding UI Refresh Signals/Slots

The sio::client callbacks are not in the UI thread. However, the UI must be updated with those callbacks, so we need a signal for the non-UI thread to request the slots functions in the UI thread. To signal that QListWidgetItem has been added, insert the following:

// in mainwindow.h
    void RequestAddListItem(QListWidgetItem *item);
private Q_SLOTS:
    void AddListItem(QListWidgetItem *item);
//In mainwindow.cpp
void MainWindow::AddListItem(QListWidgetItem* item)

Then connect them in the MainWindow constructor.


Setting up the Socket

For single-window applications, simply let MainWindow class hold the sio::client object by declaring a unique_ptr member of the sio::client and several event handling functions in mainwindow.h.

    void OnNewMessage(std::string const& name,message::ptr const& data,bool hasAck,message::ptr &ack_resp);
    void OnUserJoined(std::string const& name,message::ptr const& data,bool hasAck,message::ptr &ack_resp);
    void OnUserLeft(std::string const& name,message::ptr const& data,bool hasAck,message::ptr &ack_resp);
    void OnTyping(std::string const& name,message::ptr const& data,bool hasAck,message::ptr &ack_resp);
    void OnStopTyping(std::string const& name,message::ptr const& data,bool hasAck,message::ptr &ack_resp);
    void OnLogin(std::string const& name,message::ptr const& data,bool hasAck,message::ptr &ack_resp);
    void OnConnected();
    void OnClosed(client::close_reason const& reason);
    void OnFailed();

    std::unique_ptr<client> _io;

Initialize sio::client and setup event bindings for the default socket in the MainWindow constructor.

We also need to handle connectivity and disconnect events.

Add the following to the MainWindow constructor:

MainWindow::MainWindow(QWidget *parent) :
    ui(new Ui::MainWindow),
    _io(new client())
    using std::placeholders::_1;
    using std::placeholders::_2;
    using std::placeholders::_3;
    using std::placeholders::_4;
    socket::ptr sock = _io->socket();
    sock->on("new message",std::bind(&MainWindow::OnNewMessage,this,_1,_2,_3,_4));
    sock->on("user joined",std::bind(&MainWindow::OnUserJoined,this,_1,_2,_3,_4));
    sock->on("user left",std::bind(&MainWindow::OnUserLeft,this,_1,_2,_3,_4));
    sock->on("stop typing",std::bind(&MainWindow::OnStopTyping,this,_1,_2,_3,_4));
    //default socket opened, also we have "set_open_listener" for monitoring physical connection opened.
    //physical connection closed or drop.
    //physical connection fail to establish.

Managing Connection State

We have several connection listeners for connection events.

First, we want to send a login message when we’re connected; we get the default socket from the client to do that.

void MainWindow::OnConnected()
    QByteArray bytes = m_name.toUtf8();
    std::string nickName(,bytes.length());
    _io->socket()->emit("add user", nickName);

If the connection closes or fails, we need to restore the UI before we connect.

void MainWindow::OnClosed(client::close_reason const& reason)
    //restore UI to pre-login state

void MainWindow::OnFailed()
    //restore UI to pre-login state

If we exit the MainWindow, we need to clear the event bindings and listeners.

The sio::client object will be destroyed using unique_ptr.

    delete ui;

Handling Socket.IO Events

We’ll need to handle events in our functions they are bound to.
For example, we need to show received messages in the list view.

void MainWindow::OnNewMessage(std::string const& name,message::ptr const& data,bool hasAck,message::ptr &ack_resp)
    if(data->get_flag() == message::flag_object)
        std::string msg = data->get_map()["message"]->get_string();
        std::string name = data->get_map()["username"]->get_string();
        QString label = QString::fromUtf8(,name.length());
        QListWidgetItem *item= new QListWidgetItem(label);
        //emit RequestAddListItem signal
        //so that 'AddListItem' will be executed in UI thread.
        Q_EMIT RequestAddListItem(item);

Wrapping Up: Sending the Message

When sendBtn is clicked, we need to send the text in messageEdit to the chatroom.
Add the following code to SendBtnClicked():

void MainWindow::SendBtnClicked()
    QLineEdit* messageEdit = this->findChild<QLineEdit*>("messageEdit");
    QString text = messageEdit->text();
        QByteArray bytes = text.toUtf8();
        std::string msg(,bytes.length());
        _io->socket()->emit("new message",msg);//emit new message
        QListWidgetItem *item = new QListWidgetItem(text);
        Q_EMIT RequestAddListItem(item);

Further Reading

You can run the demo project to get a closer look. Before you run it, please follow the instructions to make the client library.

Don’t forget to star the project on GitHub to get updates!