Bluetooth Chat Example#

An example showing communication through Bluetooth.

The Bluetooth Chat example shows how to use the Qt Bluetooth API to communicate with another application on a remote device using Bluetooth.


The Bluetooth Chat example implements a simple chat program between multiple parties. The application always acts as both a server and a client eliminating the need to determine who should connect to whom.

Running the Example#

To run the example from Qt Creator , open the Welcome mode and select the example from Examples. For more information, visit Building and Running an Example.

Chat Server#

The chat server is implemented by the ChatServer class. The ChatServer class is declared as:

class ChatServer(QObject):

# public
    ChatServer = explicit(QObject parent = None)
    def startServer(QBluetoothAddress()):
    def stopServer():
slots: = public()
    def sendMessage(message):
    def messageReceived(sender, message):
    def clientConnected(name):
    def clientDisconnected(name):
slots: = private()
    def clientConnected():
    def clientDisconnected():
    def readSocket():
# private
    rfcommServer = None()
    serviceInfo = QBluetoothServiceInfo()
*> = QList<QBluetoothSocket()
*, = QMap<QBluetoothSocket()

The first thing the chat server needs to do is create an instance of QBluetoothServer to listen for incoming Bluetooth connections. Our clientConnected() slot will be called whenever a new connection is created.

rfcommServer = QBluetoothServer(QBluetoothServiceInfo.RfcommProtocol, self)
connect(rfcommServer, QBluetoothServer.newConnection,
        self, QOverload<>::of(ChatServer::clientConnected))
result = rfcommServer.listen(localAdapter)
if (not result) {
    qWarning() << "Cannot bind chat server to" << localAdapter.toString()

The chat server is only useful if others know that it is there. To enable other devices to discover it, a record describing the service needs to be published in the systems SDP (Service Discovery Protocol) database. The QBluetoothServiceInfo class encapsulates a service record.

We will publish a service record that contains some textural descriptions of the services, a UUID that uniquely identifies the service, the discoverability attribute, and connection parameters.

The textural description of the service is stored in the ServiceName, ServiceDescription, and ServiceProvider attributes.

serviceInfo.setAttribute(QBluetoothServiceInfo.ServiceName, tr("Bt Chat Server"))
                         tr("Example bluetooth chat server"))
serviceInfo.setAttribute(QBluetoothServiceInfo.ServiceProvider, tr(""))

Bluetooth uses UUIDs as unique identifiers. The chat service uses a randomly generated UUID.

serviceUuid = QLatin1String("e8e10f95-1a70-4b27-9ccf-02010264e9c8")        serviceInfo.setServiceUuid(QBluetoothUuid(serviceUuid))

A Bluetooth service is only discoverable if it is in the PublicBrowseGroup.

QBluetoothServiceInfo.Sequence publicBrowse
publicBrowse << QVariant.fromValue(QBluetoothUuid(QBluetoothUuid.ServiceClassUuid.PublicBrowseGroup))

The ProtocolDescriptorList attribute is used to publish the connection parameters that the remote device requires to connect to our service. Here we specify that the Rfcomm protocol is used and set the port number to the port that our rfcommServer instance is listening to.

QBluetoothServiceInfo.Sequence protocolDescriptorList
QBluetoothServiceInfo.Sequence protocol
protocol << QVariant.fromValue(QBluetoothUuid(QBluetoothUuid.ProtocolUuid.L2cap))
protocol << QVariant.fromValue(QBluetoothUuid(QBluetoothUuid.ProtocolUuid.Rfcomm))
         << QVariant.fromValue(quint8(rfcommServer.serverPort()))

Finally, we register the service record with the system.


As mentioned earlier, incoming connections are handled in the clientConnected() slot where pending connections are connected to the readyRead() and disconnected() signals. The signals notify others that a new client has connected.

def clientConnected(self):

    socket = rfcommServer.nextPendingConnection()
    if (not socket)
    connect(socket, QBluetoothSocket.readyRead, self, ChatServer.readSocket)
    connect(socket, QBluetoothSocket.disconnected, self, QOverload<>.of(ChatServer.clientDisconnected))
    clientNames[socket] = socket.peerName()

The readSocket() slot is called whenever data is ready to be read from a client socket. The slot reads individual lines from the socket, converts them from UTF-8, and emits the messageReceived() signal.

def readSocket(self):

    socket = QBluetoothSocket (sender())
    if (not socket)
    while (socket.canReadLine()) {
        line = socket.readLine().trimmed()

                             QString.fromUtf8(line.constData(), line.length()))

The clientDisconnected() slot is called whenever a client disconnects from the service. The slot emits a signal to notify others that a client has disconnected, and deletes the socket.

def clientDisconnected(self):

    socket = QBluetoothSocket (sender())
    if (not socket)

The sendMessage() slot is used to send a message to all connected clients. The message is converted into UTF-8 and appended with a newline before being sent to all clients.

def sendMessage(self, message):

    text = message.toUtf8() + '\n'
    for socket in qAsConst(clientSockets):

When the chat server is stopped the service record is removed from the system SDP database, all connected client sockets are deleted, and the QRfcommServer instance is deleted.

def stopServer(self):

    # Unregister service
    # Close sockets
    # Close server
    del rfcommServer
    rfcommServer = None

Chat Client#

The chat client is implemented by the ChatClient class. The ChatClient class is declared as:

class ChatClient(QObject):

# public
    ChatClient = explicit(QObject parent = None)
    def startClient(remoteService):
    def stopClient():
slots: = public()
    def sendMessage(message):
    def messageReceived(sender, message):
    def connected(name):
    def disconnected():
    def socketErrorOccurred(errorString):
slots: = private()
    def readSocket():
    def connected():
    def onSocketErrorOccurred(QBluetoothSocket.SocketError):
# private
    socket = None()

The client creates a new QBluetoothSocket and connects to the remote service described by the remoteService parameter. Slots are connected to the sockets readyRead(), connected() and disconnected() signals.

def startClient(self, remoteService):

    if (socket)
    # Connect to service
    socket = QBluetoothSocket(QBluetoothServiceInfo.RfcommProtocol)
    print("Create socket")
    print("ConnectToService done")
    connect(socket, QBluetoothSocket.readyRead, self, ChatClient.readSocket)
    connect(socket, QBluetoothSocket.connected, self, QOverload<>.of(ChatClient.connected))
    connect(socket, QBluetoothSocket.disconnected, self, ChatClient.disconnected)
    connect(socket, QBluetoothSocket.errorOccurred, self, ChatClient.onSocketErrorOccurred)

On successful socket connection we emit a signal to notify others.

def connected(self):


Similarly to the chat server, the readSocket() slot is called when data is available from the socket. Lines are read individually and converted from UTF-8. The messageReceived() signal is emitted.

def readSocket(self):

    if (not socket)
    while (socket.canReadLine()) {
        line = socket.readLine().trimmed()
                             QString.fromUtf8(line.constData(), line.length()))

The sendMessage() slot is used to send a message to the remote device. The message is converted to UTF-8 and a newline is appended.

def sendMessage(self, message):

    text = message.toUtf8() + '\n'

To disconnect from the remote chat service, the QBluetoothSocket instance is deleted.

def stopClient(self):

    del socket
    socket = None

Chat Dialog#

The main window of this example is the chat dialog, implemented in the Chat class. This class displays a chat session between a single ChatServer and zero or more ChatClients. The Chat class is declared as:

class Chat(QDialog):

# public
    Chat = explicit(QWidget parent = None)
    def sendMessage(message):
slots: = private()
    def connectClicked():
    def sendClicked():
    def showMessage(sender, message):
    def clientConnected(name):
    def clientDisconnected(name):
    def clientDisconnected():
    def connected(name):
    def reactOnSocketError(error):
    def newAdapterSelected():
# private
    adapterFromUserSelection = int()
    currentAdapterIndex = 0
    Ui_Chat ui
    server = ChatServer()
*> = QList<ChatClient()
localAdapters = QList()
    localName = QString()

First we construct the user interface

connect(ui.quitButton, QPushButton.clicked, self, Chat.accept)
connect(ui.connectButton, QPushButton.clicked, self, Chat.connectClicked)
connect(ui.sendButton, QPushButton.clicked, self, Chat.sendClicked)

We create an instance of the ChatServer and respond to its clientConnected(), clientDiconnected(), and messageReceived() signals.

server = ChatServer(self)
connect(server, QOverload<QString >::of(ChatServer::clientConnected),
        self, Chat::clientConnected)
connect(server, QOverload<QString >::of(ChatServer::clientDisconnected),
        self, QOverload<QString >::of(Chat::clientDisconnected))
connect(server, ChatServer::messageReceived,
        self, Chat::showMessage)
connect(self, Chat::sendMessage, server, ChatServer::sendMessage)

In response to the clientConnected() and clientDisconnected() signals of the ChatServer, we display the typical “X has joined chat.” and “Y has left.” messages in the chat session.

def clientConnected(self, name):"%1 has joined chat.\n").arg(name))

def clientDisconnected(self, name):"%1 has left.\n").arg(name))

Incoming messages from clients connected to the ChatServer are handled in the showMessage() slot. The message text tagged with the remote device name is displayed in the chat session.

def showMessage(self, sender, message):"%1: %2\n").arg(sender, message))

In response to the connect button being clicked, the application starts service discovery and presents a list of discovered chat services on remote devices. A ChatClient for the service is selected by the user.

def connectClicked(self):

    # scan for services
    adapter = localAdapters.isEmpty() ?
                                           QBluetoothAddress() :
    remoteSelector = RemoteSelector(adapter)
    if (QNativeInterface.QAndroidApplication.sdkVersion() >= 23)
    if (remoteSelector.exec() == QDialog.Accepted) {
        service = remoteSelector.service()
        print("Connecting to service 2", service.serviceName())
                 << "on" << service.device().name()
        # Create client
        print("Going to create client")
        client = ChatClient(self)
        connect(client, ChatClient::messageReceived,
                self, Chat::showMessage)
        connect(client, ChatClient::disconnected,
                self, QOverload<>::of(Chat::clientDisconnected))
        connect(client, QOverload<QString >::of(ChatClient::connected),
                self, Chat::connected)
        connect(client, ChatClient::socketErrorOccurred,
                self, Chat::reactOnSocketError)
        connect(self, Chat::sendMessage, client, ChatClient::sendMessage)
print("Start client")


In reponse to the connected() signals from ChatClient, we display the a “Joined chat with X.” message in the chat session.

def connected(self, name):"Joined chat with %1.\n").arg(name))

Messages are sent to all remote devices via the ChatServer and ChatClient instances by emitting the sendMessage() signal.

def sendClicked(self):

    showMessage(localName, ui.sendText.text())

We need to clean up ChatClient instances when the remote device forces a disconnect.

def clientDisconnected(self):

    client = ChatClient (sender())
    if (client) {

Example project @