bluetooth library for linux OSes using DBus and bluez (
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

bluez-dbus Maven Central

bluetooth library for linux OSes using DBus and bluez.

This project was inspired by tinyb, but does not require any wrapper library except the unix-domain-socket library of Matthew Johnson.

This wrapper library is included in debian based systems (can be installed with: apt-get install libmatthew-io-java), so no self-compiling of any stuff is required.

This library has been tested with Ubuntu 16.04.4 (AMD64) and bluez library 5.48.

Starting with version 0.1.0 of this library Java 8 is required (previous version used Java 7).

To build a newer bluez-library for Ubuntu (16.04 has an older version than 5.48):

  1. Download new bluez library from
  2. Install Ubuntu build essentials:
        sudo apt-get install build-essential
  3. Install required additional dependencies:
        sudo apt-get install libdbus-1-dev libudev-dev libical-dev libreadline-dev checkinstall libglib2.0-dev
  4. Extract the downloaded bluez-tarball:
        tar xfvJ bluez-5.48.tar.xz
  5. Run ./configure in the extracted bluez tarball:
        ./configure --prefix=/usr --libexecdir=/usr/lib --enable-manpages
  6. run checkinstall in bluez tarball directory: sudo checkinstall
  7. Answer 'y' to question if default docs should be created
  8. Enter a description (e.g. New bluez library), press enter and then CTRL+D
  9. In checkinstall:
      Go to Menu option 13 (Replaces)
      Enter: bluez-obexd, bluez-cups, bluez-hcidump, bluez-btsco, bluez-tools
  10. Press Enter to start the build
  11. Install the generated .deb files:
        sudo dpkg -i bluez_5.48-1_amd64.deb