Installation

Build and install the C++ library from source:

git clone https://github.com/simpleble/simpleble.git
cd simpleble

cmake -S simpleble -B build_simpleble
cmake --build build_simpleble -j
cmake --install build_simpleble --prefix "$PWD/install_simpleble"

Consume the installed package from your own CMake project:

find_package(simpleble REQUIRED CONFIG)
target_link_libraries(your_app PRIVATE simpleble::simpleble)

For a local vendored build, add the library directly:

add_subdirectory(path/to/simpleble/simpleble ${CMAKE_BINARY_DIR}/simpleble)
target_link_libraries(your_app PRIVATE simpleble::simpleble)

Build and install the C wrapper from source:

git clone https://github.com/simpleble/simpleble.git
cd simpleble

cmake -S simplecble -B build_simplecble
cmake --build build_simplecble -j
cmake --install build_simplecble --prefix "$PWD/install_simplecble"

Consume the installed package from CMake:

find_package(simplecble REQUIRED CONFIG)
target_link_libraries(your_app PRIVATE simplecble::simplecble)

If you are compiling manually, include simplecble headers and link both simplecble and the platform Bluetooth dependencies.

Install SimpleSharpBLE from NuGet:

dotnet add package SimpleSharpBLE

Requires .NET 10. See SimpleSharpBLE Usage for platform requirements and a first scan example.

Install the Python binding from PyPI:

pip install simplepyble

Linux users also need DBus headers:

sudo apt-get install libdbus-1-dev

Install from a local checkout when developing SimplePyBLE itself:

git clone https://github.com/simpleble/simpleble.git
cd simpleble
pip install .

Add SimpleJavaBLE to your Gradle dependencies:

dependencies {
    implementation("org.simpleble:simplejavable:<version>")
}

The Maven artifact bundles the supported Windows, macOS, and Linux native libraries. See SimpleJavaBLE Usage for source builds and native library loading options.

Install the Go binding with Go 1.25 or newer:

go get github.com/simpleble/simplegoble
go build ./...

See SimpleGoBLE Usage for platform requirements and client examples.

Add the Rust crate:

cargo add simplersble

Linux users need DBus headers before building:

sudo apt-get install libdbus-1-dev

If you want to use a local checkout while developing:

[dependencies]
simplersble = { path = "path/to/simpleble" }

Install the Node.js package with Node.js 22 or newer:

npm install simplejsble

The package includes the native addon for Windows, macOS, and Linux on x64 and arm64, so nothing is compiled during installation. See SimpleJSBLE Usage for Electron and platform notes.

Install the React Native package and Nitro Modules, which it is built on:

npm install simplernble react-native-nitro-modules
cd ios && pod install

The package includes SimpleBLE prebuilt for iOS, and compiles it with the NDK in your app's Android build. Apps target iOS 15.8 and Android API 31 or newer, declare Bluetooth usage in Info.plist, and request the Android permissions at runtime; see SimpleRnBLE Usage for permissions and Expo.

Add SimpleKtBLE to the shared module of your project, with Kotlin 2.3 or newer:

kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("org.simpleble:simplektble:<version>")
        }
    }
}

Each target's artifact includes the native SimpleBLE library it needs, for Android, iOS, macOS, Windows, and Linux, so nothing is compiled during your build. See SimpleKtBLE Usage for permissions and supported targets.

Add SimpleDroidBLE to your app module:

dependencies {
    implementation("org.simpleble:simpledroidble:<version>")
}

For a local checkout, include the library before include(":app"):

includeBuild("path/to/simpleble/simpledroidble") {
    dependencySubstitution {
        substitute(module("org.simpleble:simpledroidble")).using(project(":simpledroidble"))
    }
}

include(":app")

The app must also declare and request Bluetooth permissions at runtime.

In Unity's Package Manager, select My Assets, find SimpleBLE for Unity, then download and import it. For a supplied .unitypackage, use Assets > Import Package > Custom Package. Use Unity 6.3 LTS or 6.6.

See SimpleBLE for Unity Installation for assembly references and Platform notes for Android settings.

Install with uv:

uv tool install simpleaible

Or with pip:

pip install simpleaible

Then run the MCP server:

simpleaible

See MCP Server and HTTP Server for agent and HTTP workflows.