PHPackages                             lecodeurdudimanche/php-bluetooth - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. lecodeurdudimanche/php-bluetooth

ActiveLibrary[Utility & Helpers](/categories/utility)

lecodeurdudimanche/php-bluetooth
================================

Simple usage of bluetooth Bluez executables to control bluetooth devices with PHP

v0.5.1(5y ago)51081[1 issues](https://github.com/LeCodeurDuDimanche/php-bluetooth/issues)MITPHPPHP >7.2

Since Jul 3Pushed 5y ago2 watchersCompare

[ Source](https://github.com/LeCodeurDuDimanche/php-bluetooth)[ Packagist](https://packagist.org/packages/lecodeurdudimanche/php-bluetooth)[ RSS](/packages/lecodeurdudimanche-php-bluetooth/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (2)Versions (15)Used By (0)

PHP Bluetooth
=============

[](#php-bluetooth)

A package to manage bluetooth connexions on Linux using PHP
-----------------------------------------------------------

[](#a-package-to-manage-bluetooth-connexions-on-linux-using-php)

This package relies on the Bluez stack, using the `bluetoothctl` tool.

*This package is in early development stage*

Requirements
------------

[](#requirements)

This library relies on the BlueZ stack, so you need to install `bluez` and `bluez-tools` packages.
PHP version >= 7.2

Installation
------------

[](#installation)

```
    composer require lecodeurdudimanche\php-bluetooth

```

Basic usage
-----------

[](#basic-usage)

The `Manager` class is the entry point of this library.
To launch the `Manager` and set the bluetooth adapter in a discoverable state and to accept paring :

```
    use lecodeurdudimanche\PHPBluetooth\Manager;

    $manager = new Manager($discoverable, $pairable);
```

Next you can manage the bluetooth connextion through the `Manager`, keep in mind that all commands (but not all methods) are asynchronous :

```
    use lecodeurdudimanche\PHPBluetooth\Device;

    $manager->scanDevices(); //Initiate device scan
    $manager->setPairable(false);
    $manager->pairDevice(new Device($mac));

    $manager->updateBluetoothInfo();
    $data = $manager->getBluetoothInfo();

    foreach($data->getAvailableDevices() as $device)
    {
        if (! $device->paired)
            $manager->blockDevice($device);
    }

    // Other methods are available, see Manager class
```

TODO
----

[](#todo)

```
 - Add detection of discoverable and pairable status at startup
 - Add support to exclude unscanned paired devices from scanned devices list
 - Add detection of trusted and blocked devices
 - Add I/O exception handling

```

License
-------

[](#license)

MIT License

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~13 days

Recently: every ~26 days

Total

14

Last Release

1967d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/91ab2cb172b0a9fc1312802e15daf21497045ca73d7a19c4304c64c78b6acd65?d=identicon)[LeCodeurDuDimanche](/maintainers/LeCodeurDuDimanche)

---

Top Contributors

[![LeCodeurDuDimanche](https://avatars.githubusercontent.com/u/43851820?v=4)](https://github.com/LeCodeurDuDimanche "LeCodeurDuDimanche (31 commits)")

---

Tags

bluetoothlinuxphp

### Embed Badge

![Health badge](/badges/lecodeurdudimanche-php-bluetooth/health.svg)

```
[![Health](https://phpackages.com/badges/lecodeurdudimanche-php-bluetooth/health.svg)](https://phpackages.com/packages/lecodeurdudimanche-php-bluetooth)
```

###  Alternatives

[immocaster/php-sdk

ImmobilienScout24 PHP-SDK

6437.9k](/packages/immocaster-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)