Qt Bluetooth

The Bluetooth API provides connectivity between Bluetooth enabled devices.

Currently, the API is supported on the following platforms: Android, iOS, Linux (BlueZ 4.x/5.x) and OS X.


Bluetooth is a short-range (less than 100 meters) wireless technology. It has a reasonably high data transfer rate of 2.1 Mbit/s, which makes it ideal for transferring data between devices. Bluetooth connectivity is based on basic device management, such as scanning for devices, gathering information about them, and exchanging data between them.

Qt Bluetooth supports Bluetooth Low Energy development for client/central role use cases. Further details can be found in the Bluetooth Low Energy Overview section.

A new addition in this Qt Bluetooth 5.7 release covers support for Bluetooth Low Energy applications performing the peripheral/server role. This new API is a Technology Preview.

Getting Started

To use the C++ library in your application, add the following configuration option to your .pro file:

QT += bluetooth

To use the classes of the module in your application you need the following import statement in your .qml file:

import QtBluetooth 5.2



Logging Categories

The QtBluetooth module exports the following logging categories:

Logging CategoryDescription
qt.bluetoothEnables logging of cross platform code path in QtBluetooth
qt.bluetooth.androidEnables logging of the Android implementation
qt.bluetooth.bluezEnables logging of the BLuez/Linux implementation
qt.bluetooth.iosEnables logging of the iOS implementation
qt.bluetooth.osxEnables logging of the OS X implementation


© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.