{"id":36606470,"url":"https://github.com/hypfvieh/bluez-dbus","last_synced_at":"2026-01-12T08:45:51.611Z","repository":{"id":49237454,"uuid":"80996087","full_name":"hypfvieh/bluez-dbus","owner":"hypfvieh","description":"bluetooth library for linux OSes using DBus and bluez (http://www.bluez.org/). ","archived":false,"fork":false,"pushed_at":"2025-08-03T10:59:11.000Z","size":340,"stargazers_count":76,"open_issues_count":5,"forks_count":23,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-08-03T12:26:39.304Z","etag":null,"topics":["bluetooth-library","bluez","bluez-dbus","dbus","java"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hypfvieh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"liberapay":"hypfvieh"}},"created_at":"2017-02-05T13:52:52.000Z","updated_at":"2025-08-03T10:59:14.000Z","dependencies_parsed_at":"2025-01-20T18:20:09.219Z","dependency_job_id":"8569c0a7-b107-473f-95ac-17e9e45921e7","html_url":"https://github.com/hypfvieh/bluez-dbus","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/hypfvieh/bluez-dbus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypfvieh%2Fbluez-dbus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypfvieh%2Fbluez-dbus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypfvieh%2Fbluez-dbus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypfvieh%2Fbluez-dbus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hypfvieh","download_url":"https://codeload.github.com/hypfvieh/bluez-dbus/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypfvieh%2Fbluez-dbus/sbom","scorecard":{"id":475653,"data":{"date":"2025-08-11","repo":{"name":"github.com/hypfvieh/bluez-dbus","commit":"9fb34965a1bd2c6484863204f2878d3056a0f7c9"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.6,"checks":[{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/maven_jdk17_deploy.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":0,"reason":"Found 2/29 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":2,"reason":"2 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/maven_jdk17_deploy.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/hypfvieh/bluez-dbus/maven_jdk17_deploy.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/maven_jdk17_deploy.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/hypfvieh/bluez-dbus/maven_jdk17_deploy.yml/master?enable=pin","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/maven_jdk17_deploy.yml:8"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: all commits (3) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-19T15:13:29.663Z","repository_id":49237454,"created_at":"2025-08-19T15:13:29.663Z","updated_at":"2025-08-19T15:13:29.663Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28337599,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bluetooth-library","bluez","bluez-dbus","dbus","java"],"created_at":"2026-01-12T08:45:51.480Z","updated_at":"2026-01-12T08:45:51.601Z","avatar_url":"https://github.com/hypfvieh.png","language":"Java","funding_links":["https://liberapay.com/hypfvieh"],"categories":[],"sub_categories":[],"readme":"# bluez-dbus [![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.hypfvieh/bluez-dbus/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.hypfvieh/bluez-dbus)\nbluetooth library for linux OSes using [DBus](https://dbus.freedesktop.org/) and [bluez](http://www.bluez.org/).\n\nThis project was inspired by [tinyb](https://github.com/intel-iot-devkit/tinyb),\nbut does not require any wrapper library as it is based on a newer version of dbus-java which uses jnr-unixsocket.\n\nThis library has been tested with Ubuntu 22.04 (AMD64) and bluez library 5.64.\n\n## Compatibility\nThe different versions of bluez-dbus are using different versions of dbus-java which requires modern Java versions.\nHere is a list of which bluez-dbus versions uses which dbus-java and the required Java version to use.\n\n| bluez-java Version | dbus-java Version | minimum Java Version |\n| ------------------ | ----------------- | -------------------- |\n| 0.0.x              | 2.7.x             | Java 1.7             |\n| 0.1.x              | 3.x               | Java 1.8             |\n| 0.2.x              | 4.3.x             | Java 11              |\n| 0.3.x              | 5.x               | Java 17              |\n\n## Usage\nWhen using the library directly, you have to add at least one `dbus-java` transport to your project as well.\nThere are different transports available. For usage with DBus you usually need a UnixSocket providing transport.\n\n| Transport                             | Usage                                                                                      |\n| ------------------------------------- | ------------------------------------------------------------------------------------------ | \n| dbus-java-transport-jnr-unixsocket    | Use this if you need filedescriptor support as well (see below)                            |\n| dbus-java-transport-junixsocket       | Alternative if you don't want to use jnr (beta support in dbus-java 4.x), supports\u003cbr\u003efiledescriptor without additional libraries. |\n| dbus-java-transport-native-unixsocket | Use Java native implementation for UnixSockets. Needs at least Java 16, does not support\u003cbr\u003efiledescriptor at all. |\n| dbus-java-transport-tcp               | TCP implementation, only needed when your DBusDaemon is configured to use TCP as well\u003cbr\u003eas/instead of UnixSockets. |\n\nIf you use the OSGi bundle, you don't have to add anything.\nThe OSGi bundle will use jnr-unixsocket transport as default in bluez-dbus version 0.2.x.\nIt will be changed to junixsocket-transport in bluez-dbus 0.3.x.\n\n### filedescriptor support\n\nIf you want to use filedescriptor passing in any bluez method, you have to add [Robert Middleton's dbus-java-nativefd](https://github.com/rm5248/dbus-java-nativefd) library to your project if you are using jnr-unixsocket-transport.\nThe library can be found here:\n\n```\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.rm5248\u003c/groupId\u003e\n    \u003cartifactId\u003edbus-java-nativefd\u003c/artifactId\u003e\n    \u003cversion\u003e2.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nIf you use the native-transport, you cannot use filedescriptor's because Java native implementation of UnixSockets only has a limited functionality.\nFor most cases this implementation should be fine. In some special cases like filedescriptors it isn't good enough.\n\nStarting from bluez-java 0.3.x, dbus-java 5.x is used which has proper support for junixsocket. JUnixsocket is another implementation for UnixSockets like\njnr-unixsockets but with a richer feature set out of the box. It supports filedescriptors without the need of additional libraries.\n\n##### To build a newer bluez-library for Ubuntu (16.04 has an older version than 5.50):\n-------------\n1. Download new bluez library from http://www.bluez.org/download/\n2. Install Ubuntu build essentials:  \n  \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;sudo apt-get install build-essential\n3. Install required additional dependencies:  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;`sudo apt-get install libdbus-1-dev libudev-dev libical-dev libreadline-dev checkinstall libglib2.0-dev`\n4. Extract the downloaded bluez-tarball:  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;`tar xfvJ bluez-5.50.tar.xz`\n5. Run ./configure in the extracted bluez tarball:  \n   \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;`./configure --prefix=/usr --libexecdir=/usr/lib --enable-manpages`\n6. run checkinstall in bluez tarball directory: `sudo checkinstall`\n7. Answer 'y' to question if default docs should be created\n8. Enter a description (e.g. `New bluez library`), press enter and then CTRL+D\n9. In checkinstall:  \n    \u0026nbsp;\u0026nbsp;Go to Menu option 13 (Replaces)  \n    \u0026nbsp;\u0026nbsp;Enter: `bluez-obexd, bluez-cups, bluez-hcidump, bluez-btsco, bluez-tools`\n10. Press Enter to start the build\n11. Install the generated .deb files:  \n  \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;`sudo dpkg -i bluez_5.50-1_amd64.deb`\n\n# Changelog:\n\n#### Version 0.3.3 (not released yet):\n- nothing so far\n\n#### Version 0.3.2 (2025-04-20):\n- Improved scanning/refreshing behavior of `DeviceManager` [#PR67](https://github.com/hypfvieh/bluez-dbus/pull/67), thanks to [joerg1985](https://github.com/joerg1985)\n- Added new method `setLazyScan` to enable/disable re-querying of GATT services from already known devices when scanning\n\n#### Version 0.3.1 (2025-01-20):\n- Fixed issues with OSGi Bundle, [#64](https://github.com/hypfvieh/bluez-dbus/issues/64), [#PR65](https://github.com/hypfvieh/bluez-dbus/pull/65), thanks to [joerg1985](https://github.com/joerg1985)\n\n#### Version 0.3.0 (2024-08-02):\n- Requires Java 17\n- Uses dbus-java 5.x\n\n#### Version 0.2.0 (2023-07-21):\n- Requires Java 11\n- Uses dbus-java 4.x\n- Updated interfaces to comply with bluez 5.64\n- Issue [#48](https://github.com/hypfvieh/bluez-dbus/issues/48) allow unregistering of signal handlers\n- Issue [#51](https://github.com/hypfvieh/bluez-dbus/issues/51) added mesh interface classes \n\n#### Version 0.1.3:\n- Various bugfixes: [#35](https://github.com/hypfvieh/bluez-dbus/issues/35), [#36](https://github.com/hypfvieh/bluez-dbus/issues/36), [#38](https://github.com/hypfvieh/bluez-dbus/issues/38)\n- Updated dependency versions\n\n#### Version 0.1.2:\n- Multi module maven project\n- Provide a new artifact for usage with OSGi (bluez-java-osgi)\n- Changed visibility of some methods to public\n- Smaller bugfixes\n- Updated interface classes to match with bluez 5.54 - Please note: mesh classes are still missing, PRs welcome\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypfvieh%2Fbluez-dbus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhypfvieh%2Fbluez-dbus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypfvieh%2Fbluez-dbus/lists"}