Java Bluetooth

Java BLE libraries, compared

Five ways to reach Bluetooth Low Energy from Java and the JVM. SimpleBLE runs on Windows, macOS, and Linux from one JAR, as a central and a peripheral, and the team that builds it supports your product.

Kober Engineering
InsuLearn
Meta
Fender
Honeywell
Bionic Labs
Sona
SWT
Moon Smart Focus
Lewitt
Medra
Desko
g.tec
IXI
Innovision
Moonlighting Industries
Kober Engineering
InsuLearn
Meta
Fender
Honeywell
Bionic Labs
Sona
SWT
Moon Smart Focus
Lewitt
Medra
Desko
g.tec
IXI
Innovision
Moonlighting Industries
Kober Engineering
InsuLearn
Meta
Fender
Honeywell
Bionic Labs
Sona
SWT
Moon Smart Focus
Lewitt
Medra
Desko
g.tec
IXI
Innovision
Moonlighting Industries
Comparison

How the Java BLE libraries compare

Platforms, roles, and licensing decide which library fits a commercial Java application. This is where each one stands.

How the Java BLE libraries compare
SimpleBLEsimplejavableWindows, macOS, LinuxCentral and peripheral on every platformC++, Python, C#, Kotlin, and moreSource-available (BUSL 1.1); one commercial license per company
Blessed for BlueZblessed-bluezLinuxCentralJava onlyMIT
bluez-dbusbluez-dbusLinuxCentral, plus BlueZ's D-Bus interfaces for the restJava onlyMIT
TinyBIntel IoT DevKitLinuxCentralC++MIT
Native OS APIsJNI to WinRT, CoreBluetooth, BlueZWindows, macOS, Linux, each with its own APIYes, through each platform's own APIEach platform's own languageIncluded with each operating system
The options

The Java BLE libraries, one by one

SimpleBLE

SimpleBLE is a Bluetooth Low Energy library for Windows, macOS, Linux, iOS, and Android. Its Java package, SimpleJavaBLE, scans and connects as a central and hosts GATT services as a peripheral on every desktop platform, with blocking calls and CompletableFuture counterparts. The JAR carries the native library for every platform, so one Gradle or Maven dependency is all it takes, from Java or any JVM language. The same library runs in C++, Python, C#, Kotlin, and other languages, and commercial customers work directly with the engineers who build it.

Blessed for BlueZ

Blessed for BlueZ wraps BlueZ's D-Bus API in a CoreBluetooth-style object model for Linux, under the MIT license. Its documented API covers the central role on Linux. A Java application that also runs on Windows or macOS, or hosts GATT services, needs another library for that.

bluez-dbus

bluez-dbus exposes BlueZ's D-Bus interfaces to Java on Linux, with a device manager for the central role, under the MIT license. Advertising and GATT services go through BlueZ's interfaces directly. SimpleBLE gives you both roles through one API on Linux, Windows, and macOS.

TinyB

TinyB, from Intel's IoT DevKit, exposes BlueZ's GATT API to C++ and Java on Linux. Its repository is archived and read-only, so projects built on it need a maintained replacement.

Native OS APIs

The JVM has no Bluetooth API of its own, so a Java application can reach each platform's Bluetooth stack through JNI: WinRT on Windows, CoreBluetooth on macOS, and BlueZ on Linux. It costs nothing in licenses and takes a native layer per platform, each with its own threading, errors, and lifecycle. SimpleBLE is that work, done once and maintained for you.

Get started

Scan, connect, and host in a few lines

Add org.simpleble:simplejavable to Gradle or Maven. This is the code for each step, and connect and the GATT calls each have a CompletableFuture counterpart.

import org.simplejavable.Adapter;
import org.simplejavable.Peripheral;

Adapter adapter = Adapter.getAdapters().get(0);

adapter.scanFor(5000);
for (Peripheral peripheral : adapter.scanGetResults()) {
    System.out.println(peripheral.getIdentifier() + " [" + peripheral.getAddress() + "]");
}
Why SimpleBLE

What SimpleBLE gives your Java application

Platforms

Windows, macOS, and Linux

One JAR, one API, on every desktop.

Roles

Central and peripheral

Scan and connect, or advertise and serve GATT, on every platform.

Builds

One dependency

The native library ships inside the JAR. Nothing to compile, no JNI to write.

JVM

Blocking or async

Plain calls or CompletableFuture, from Java, Kotlin, or any JVM language.

Hardware

Dongl on desktop

Plug in a Dongl for a dedicated radio on Windows, macOS, or Linux. Same code.

Support

A direct line to the engineers

Commercial customers work directly with the team that builds SimpleBLE.

Try SimpleBLE in your Java application

Evaluation needs no license. For commercial use, one agreement covers your whole company, with no per-seat, per-device, or royalty fees.

Frequently
asked questions

Yes. SimpleBLE runs on Windows, macOS, and Linux from one JAR. Blessed for BlueZ, bluez-dbus, and TinyB are built on BlueZ and run on Linux.

Yes. SimpleBLE hosts GATT services and advertises on Windows, macOS, and Linux. On Linux, bluez-dbus also exposes BlueZ's advertising and GATT server interfaces.

TinyB's repository is archived. SimpleBLE replaces it on Linux with a maintained library, and adds Windows, macOS, and the peripheral role.

Yes. SimpleJavaBLE runs on the JVM, so Kotlin, Scala, and other JVM languages call it directly. Kotlin Multiplatform projects can use SimpleBLE's Kotlin package instead.

Yes. On Windows, macOS, and Linux, SimpleJavaBLE drives a Dongl USB adapter with the same code it uses for the computer's built-in Bluetooth.

SimpleBLE is source-available under the Business Source License 1.1 and free for non-commercial use. Evaluation needs no license. Commercial use needs a license, and one agreement covers your whole company, with no per-seat, per-device, or royalty fees.