{"id":18622410,"url":"https://github.com/hadess/bluez","last_synced_at":"2025-04-11T03:31:21.149Z","repository":{"id":146219239,"uuid":"38117181","full_name":"hadess/bluez","owner":"hadess","description":"BlueZ fork with topic branches","archived":false,"fork":false,"pushed_at":"2024-08-05T14:22:03.000Z","size":27299,"stargazers_count":14,"open_issues_count":0,"forks_count":14,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-25T08:42:34.249Z","etag":null,"topics":["bluetooth","bluez","linux"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hadess.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-06-26T15:01:24.000Z","updated_at":"2024-11-03T18:32:53.000Z","dependencies_parsed_at":"2024-08-05T16:29:17.991Z","dependency_job_id":"eafefe15-af33-4b77-916b-c31987861aef","html_url":"https://github.com/hadess/bluez","commit_stats":null,"previous_names":[],"tags_count":272,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadess%2Fbluez","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadess%2Fbluez/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadess%2Fbluez/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hadess%2Fbluez/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hadess","download_url":"https://codeload.github.com/hadess/bluez/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248335431,"owners_count":21086589,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","bluez","linux"],"created_at":"2024-11-07T04:16:44.896Z","updated_at":"2025-04-11T03:31:16.137Z","avatar_url":"https://github.com/hadess.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"BlueZ - Bluetooth protocol stack for Linux\n******************************************\n\nCopyright (C) 2000-2001  Qualcomm Incorporated\nCopyright (C) 2002-2003  Maxim Krasnyansky \u003cmaxk@qualcomm.com\u003e\nCopyright (C) 2002-2010  Marcel Holtmann \u003cmarcel@holtmann.org\u003e\n\n\nCompilation and installation\n============================\n\nIn order to compile Bluetooth utilities you need following software packages:\n\t- GCC compiler\n\t- GLib library\n\t- D-Bus library\n\t- udev library (optional)\n\t- readline (command line clients)\n\n\tOn a debian based system, this can be done by running the following command:\n\t\tsudo apt-get build-dep bluez\n\t\t./bootstrap\n\nTo configure run:\n\t./configure --prefix=/usr --mandir=/usr/share/man \\\n\t\t\t\t--sysconfdir=/etc --localstatedir=/var\n\nConfigure automatically searches for all required components and packages.\n\nTo compile and install run:\n\tmake \u0026\u0026 make install\n\n\nEmbedded Linux library\n======================\n\nIn order to compile mesh support and test client utility the development\nversion of Embedded Linux library is required to be present. The development\nrepositories can be found here:\n\n\tgit://git.kernel.org/pub/scm/libs/ell/ell.git\n\thttps://kernel.googlesource.com/pub/scm/libs/ell/ell.git\n\nThe build systems requires that the Embedded Linux library source code\nis available on the same top level directory as the source code:\n\n\t.\n\t|--- ell\n\t|    |--- ell\n\t|    `--- unit\n\t`--- bluez\n\t     |--- src\n\t     `--- tools\n\nIt is not required to build or install Embedded Linux library. The build\nwill happen when building the binaries and it will then be linked internally.\n\nWhen using --enable-external-ell build option, it is not required that the\nEmbedded Linux library source code is available in the top level directory.\n\nWhen neither --enable-mesh nor --enable-btpclient is specified, then this\npart is irrelevant and Embedded Linux library is not required.\n\n\nKernel Build Options (for Mesh)\n===============================\n\nThe Mesh daemon uses kernel provided crypto utilities to perform security\nfunctions required of Bluetooth Mesh. Many standard distributions currently\nenable all required crypto features, but a few notable distributions do\nnot.\n\nIf Mesh Cryptography is not working, the following configuration options\nmay need to be enabled, and the kernel rebuilt.\n\n1. A minimum of kernel version 4.9 or later is required\n\n2. The kernel must at a minimum have the following .config options turned on:\n\tCONFIG_CRYPTO_USER\n\tCONFIG_CRYPTO_USER_API\n\tCONFIG_CRYPTO_USER_API_AEAD\n\tCONFIG_CRYPTO_USER_API_HASH\n\tCONFIG_CRYPTO_USER_API_SKCIPHER\n\n\tCONFIG_CRYPTO_AES\n\tCONFIG_CRYPTO_CCM\n\tCONFIG_CRYPTO_AEAD\n\tCONFIG_CRYPTO_CMAC\n\n\nConfiguration and options\n=========================\n\nFor a working system, certain configuration options need to be enabled:\n\n\t--enable-library\n\n\t\tEnable installation of Bluetooth library\n\n\t\tBy default the Bluetooth library is no longer installed.\n\n\t\tThe user interfaces or command line utilities do not\n\t\trequire an installed Bluetooth library anymore. This\n\t\toption is provided for legacy third party applications\n\t\tthat still depend on the library.\n\n\t\tWhen the library installation is enabled, it is a good\n\t\tidea to use a separate bluez-library or libbluetooth\n\t\tpackage for it.\n\n\t--disable-tools\n\n\t\tDisable support for Bluetooth utilities\n\n\t\tBy default the Bluetooth utilities are built and also\n\t\tinstalled. For production systems the tools are not\n\t\tneeded and this option allows to disable them to save\n\t\tbuild time and disk space.\n\n\t\tWhen the tools are selected, it is a good idea to\n\t\tuse a separate bluez-tools package for them.\n\n\t--disable-cups\n\n\t\tDisable support for CUPS printer backend\n\n\t\tBy default the printer backend for CUPS is build and\n\t\talso installed. For systems that do not require printing\n\t\tover Bluetooth, this options allows to disable it.\n\n\t\tWhen the CUPS backend is selected, it is a good idea to\n\t\tuse a separate bluez-cups package for it.\n\n\t--disable-monitor\n\n\t\tDisable support for the Bluetooth monitor utility\n\n\t\tBy default the monitor utility is enabled. It provides\n\t\tsupport for HCI level tracing and debugging. For systems\n\t\tthat don't require any kind of tracing or debugging\n\t\tcapabilities, this options allows to disable it.\n\n\t\tThe monitor utility should be placed in the main package\n\t\talong with the daemons. It is universally useful.\n\n\t--disable-client\n\n\t\tDisable support for the command line client\n\n\t\tBy default the command line client is enabled and uses the\n\t\treadline library. For specific systems where BlueZ is\n\t\tconfigured by other means, the command line client can be\n\t\tdisabled and the dependency on readline is removed.\n\n\t\tThe client should be placed in the main package along\n\t\twith the daemons. It is universally useful.\n\n\t--disable-systemd\n\n\t\tDisable integration with systemd\n\n\t\tBy default the integration with systemd is enabled and\n\t\tinstalled. This gives the best integration into all\n\t\tdistributions based on systemd.\n\n\t\tThis option is provided for distributions that do not\n\t\tsupport systemd. In that case all integration with the\n\t\tinit system is up to the package.\n\n\t--disable-a2dp\n\n\t\tDisable A2DP profile\n\n\t\tBy default bluetoothd supports A2DP profile using a built-in\n\t\tplugin, this option disables it.\n\n\t\tThis option is provided for distributions that do not have any\n\t\taudio capabilities.\n\n\t--disable-avrcp\n\n\t\tDisable AVRCP profile\n\n\t\tBy default bluetoothd supports AVRCP profile using a built-in\n\t\tplugin, this option disables it.\n\n\t\tThis option is provided for distributions that do not have any\n\t\taudio capabilities.\n\n\t--disable-network\n\n\t\tDisable PANU, NAP, GN profiles\n\n\t\tBy default bluetoothd supports PANU, NAP and GN profile using a\n\t\tbuilt-in plugin, this option disables it.\n\n\t\tThis option is provided for distributions that do not have any\n\t\tnetwork capabilities.\n\n\t--disable-hid\n\n\t\tDisable HID profile\n\n\t\tBy default bluetoothd supports HID profile using a built-in\n\t\tplugin, this option disables it.\n\n\t\tThis option is provided for distributions that do not have any\n\t\tinput capabilities.\n\n\t--disable-hog\n\n\t\tDisable HoG profile\n\n\t\tBy default bluetoothd supports HoG profile using a built-in\n\t\tplugin, this option disables it.\n\n\t\tThis option is provided for distributions that do not have any\n\t\tinput capabilities.\n\n\t--enable-testing\n\n\t\tEnable testing tools\n\n\t\tBy default tools used only for testing emulation are disabled.\n\t\tThis option can be used to enable them.\n\n\t\tIt is not recommended to enable this option for production\n\t\tsystems. These tools may contain tests that depend on specific\n\t\tenvironment or kernel features in development.\n\n\t--enable-experimental\n\n\t\tEnable experimental tools\n\n\t\tBy default all tools that are still in development\n\t\tare disabled. This option can be used to enable them.\n\n\t\tIt is not recommended to enable this option for production\n\t\tsystems. The behavior of the experimental tools is unstable\n\t\tand might still change.\n\n\t--enable-deprecated\n\n\t\tEnable deprecated tools\n\n\t\tBy defauld all tools that are no longer maintained are\n\t\tdisabled. This option can be used to enable them.\n\n\t\tIt is not recommended to enable this option for production\n\t\tsystems. The behavior of the deprecated tools may be unstable\n\t\tor simply don't work anymore.\n\n\t--enable-external-plugins\n\n\t\tEnable support for external plugins\n\n\t\tBy default external plugins for bluetoothd and obexd are not\n\t\tsupported and thus disabled.\n\n\t\tExternal plugins require access to internal, undocumented and\n\t\tunversioned API in said daemons. As such they can break at any\n\t\ttime. If you have such plugins, enable this option and work\n\t\tactively with the community to make said plugin part of the\n\t\tupstream bluez project.\n\n\t--enable-nfc\n\n\t\tThis option enable NFC pairing support.\n\n\t\tBy default the integration with neard is disabled, this gives\n\t\tthe option to enable it in system where neard is supported.\n\n\t\tThe plugin is built into bluetoothd therefore it does not need\n\t\tto be package separately.\n\n\t--enable-sap\n\n\t\tThis option enable SAP profile using sap plugin.\n\n\t\tBy default sap plugin is disabled since it requires tight\n\t\tintegration with systems and is very rarely required.\n\n\t\tThe plugin is built into bluetoothd therefore it does not need\n\t\tto be package separately.\n\n\t--enable-health\n\n\t\tThis option enable health profiles.\n\n\t\tBy default health plugin is disabled since its profiles are\n\t\ttarget for the health industry.\n\n\t\tThe plugin is built into bluetoothd therefore it does not need\n\t\tto be package separately.\n\n\t--enable-midi\n\n\t\tThis option enable MIDI support via ALSA Sequencer.\n\n\t\tBy default midi plugin is disabled since it still considered\n\t\texperimental. When bluetoothd will create a new ALSA Sequencer\n\t\tclient and port for each device connected that supports the\n\t\tMIDI GATT primary service.\n\n\t\tThe plugin is built into bluetoothd therefore it does not need\n\t\tto be package separately.\n\nInformation\n===========\n\nMailing lists:\n\tlinux-bluetooth@vger.kernel.org\n\nFor additional information about the project visit BlueZ web site:\n\thttp://www.bluez.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadess%2Fbluez","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhadess%2Fbluez","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhadess%2Fbluez/lists"}