{"id":3146,"date":"2026-07-11T23:25:20","date_gmt":"2026-07-11T15:25:20","guid":{"rendered":"http:\/\/www.concutnam.com\/blog\/?p=3146"},"modified":"2026-07-11T23:25:20","modified_gmt":"2026-07-11T15:25:20","slug":"how-to-connect-to-bluetooth-devices-in-a-capacitor-app-41c6-0942ee","status":"publish","type":"post","link":"http:\/\/www.concutnam.com\/blog\/2026\/07\/11\/how-to-connect-to-bluetooth-devices-in-a-capacitor-app-41c6-0942ee\/","title":{"rendered":"How to connect to Bluetooth devices in a Capacitor app?"},"content":{"rendered":"

As a Capacitor supplier, I’ve had the privilege of working with numerous developers and businesses on integrating various features into their Capacitor apps. One question that comes up quite frequently is how to connect to Bluetooth devices in a Capacitor app. In this blog post, I’ll provide a comprehensive guide on achieving this, from setting up the project to handling connections and data transfer. Capacitor<\/a><\/p>\n

<\/p>\n

Prerequisites<\/h3>\n

Before diving into the implementation, there are a few things you need to have in place. First, you should have a basic understanding of JavaScript, HTML, and CSS, as these are the core technologies used in Capacitor apps. You’ll also need to have Node.js and npm (Node Package Manager) installed on your development machine. Additionally, make sure you have the Capacitor CLI installed globally. You can install it using the following command:<\/p>\n

npm install -g @capacitor\/cli\n<\/code><\/pre>\n
Setting Up a New Capacitor Project<\/h3>\n
If you’re starting from scratch, create a new Capacitor project using the following steps:<\/p>\n
    \n
  1. Create a new directory for your project:<\/li>\n<\/ol>\n
    mkdir bluetooth-capacitor-app\ncd bluetooth-capacitor-app\n<\/code><\/pre>\n
      \n
    1. Initialize a new Node.js project:<\/li>\n<\/ol>\n
      npm init -y\n<\/code><\/pre>\n
        \n
      1. Install Capacitor and its core dependencies:<\/li>\n<\/ol>\n
        npm install @capacitor\/core @capacitor\/cli\n<\/code><\/pre>\n
          \n
        1. Initialize Capacitor in your project:<\/li>\n<\/ol>\n
          npx cap init\n<\/code><\/pre>\n
          Adding Bluetooth Functionality<\/h3>\n
          To enable Bluetooth connectivity in your Capacitor app, you’ll need to use a Capacitor plugin. One popular plugin for this purpose is @capacitor-community\/bluetooth-le<\/code>. Install it using the following command:<\/p>\n
          npm install @capacitor-community\/bluetooth-le\n<\/code><\/pre>\n
          After installing the plugin, sync it with your native platforms:<\/p>\n
          npx cap sync\n<\/code><\/pre>\n
          Requesting Permissions<\/h3>\n
          Before you can start scanning for or connecting to Bluetooth devices, you need to request the necessary permissions from the user. In your JavaScript code, you can use the following snippet to request Bluetooth permissions:<\/p>\n
          import { BluetoothLe } from '@capacitor-community\/bluetooth-le';\n\nasync function requestBluetoothPermissions() {\n  try {\n    const { granted } = await BluetoothLe.requestPermission();\n    if (granted) {\n      console.log('Bluetooth permissions granted');\n    } else {\n      console.log('Bluetooth permissions denied');\n    }\n  } catch (error) {\n    console.error('Error requesting Bluetooth permissions:', error);\n  }\n}\n<\/code><\/pre>\n
          Scanning for Bluetooth Devices<\/h3>\n
          Once you have the necessary permissions, you can start scanning for Bluetooth devices. Here’s an example of how to do this:<\/p>\n
          async function scanForDevices() {\n  try {\n    const { results } = await BluetoothLe.requestLEScan({\n      services: [], \/\/ You can specify specific services to scan for if needed\n      allowDuplicatesKey: false\n    });\n\n    results.forEach(device => {\n      console.log(`Found device: ${device.name || 'Unknown'} (${device.deviceId})`);\n    });\n  } catch (error) {\n    console.error('Error scanning for Bluetooth devices:', error);\n  }\n}\n<\/code><\/pre>\n
          Connecting to a Bluetooth Device<\/h3>\n
          After finding the device you want to connect to, you can establish a connection using its device ID. Here’s how you can do it:<\/p>\n
          async function connectToDevice(deviceId) {\n  try {\n    await BluetoothLe.connect({\n      deviceId: deviceId\n    });\n    console.log('Connected to device');\n  } catch (error) {\n    console.error('Error connecting to device:', error);\n  }\n}\n<\/code><\/pre>\n
          Reading and Writing Data<\/h3>\n
          Once you’re connected to a Bluetooth device, you can read and write data to it. First, you need to discover the services and characteristics of the device:<\/p>\n
          async function discoverServicesAndCharacteristics(deviceId) {\n  try {\n    const { services } = await BluetoothLe.discoverServices({\n      deviceId: deviceId\n    });\n\n    services.forEach(service => {\n      console.log(`Service: ${service.uuid}`);\n      service.characteristics.forEach(characteristic => {\n        console.log(`  Characteristic: ${characteristic.uuid}`);\n      });\n    });\n  } catch (error) {\n    console.error('Error discovering services and characteristics:', error);\n  }\n}\n<\/code><\/pre>\n
          To read data from a characteristic, you can use the following code:<\/p>\n
          async function readCharacteristic(deviceId, serviceUuid, characteristicUuid) {\n  try {\n    const { value } = await BluetoothLe.read({\n      deviceId: deviceId,\n      service: serviceUuid,\n      characteristic: characteristicUuid\n    });\n    console.log('Read value:', value);\n  } catch (error) {\n    console.error('Error reading characteristic:', error);\n  }\n}\n<\/code><\/pre>\n
          And to write data to a characteristic:<\/p>\n
          async function writeCharacteristic(deviceId, serviceUuid, characteristicUuid, data) {\n  try {\n    await BluetoothLe.write({\n      deviceId: deviceId,\n      service: serviceUuid,\n      characteristic: characteristicUuid,\n      value: data\n    });\n    console.log('Data written successfully');\n  } catch (error) {\n    console.error('Error writing characteristic:', error);\n  }\n}\n<\/code><\/pre>\n
          Handling Disconnections<\/h3>\n
          It’s important to handle disconnections gracefully in your app. You can listen for the disconnected<\/code> event using the following code:<\/p>\n
          BluetoothLe.addListener('disconnected', ({ deviceId }) => {\n  console.log(`Device ${deviceId} disconnected`);\n});\n<\/code><\/pre>\n
          Best Practices<\/h3>\n
          When working with Bluetooth in a Capacitor app, there are a few best practices to keep in mind:<\/p>\n